PutAgenticBucketStatus
You can call the PutAgenticBucketStatus operation to set the status of an Agentic Bucket to Enabled or Disabled.
Usage notes
The Agentic Bucket status is specified through the query parameter
status. This operation does not have a request body.After an Agentic Bucket is set to
Disabled, no new Bucket Spaces can be created under the Agentic Bucket.After the Agentic Bucket status is set back to
Enabled, normal operations resume.
Request syntax
PUT /?agenticBucket&status=Disabled HTTP/1.1
Host: {prefix}-{uid}-{region}-ab-apsr.oss-{region}.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueRequest headers
This operation uses only common request headers. For more information, see Common HTTP headers.
Request parameters
Name | Type | Required | Example | Description |
status | String | Yes | Disabled | The status to set for the Agentic Bucket. Valid values:
|
Examples
Sample request
Disable an Agentic Bucket
PUT /?agenticBucket&status=Disabled HTTP/1.1 Host: my-uid-region-ab-apsr.oss-cn-hangzhou.aliyuncs.com Date: Thu, 17 Apr 2025 15:39:12 GMT Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eEnable an Agentic Bucket
PUT /?agenticBucket&status=Enabled HTTP/1.1 Host: my-uid-region-ab-apsr.oss-cn-hangzhou.aliyuncs.com Date: Thu, 17 Apr 2025 15:39:12 GMT Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
Sample response
HTTP/1.1 200 OK x-oss-request-id: 5C1B138A109F4E405B2D Date: Mon, 26 Jul 2021 13:08:38 GMT Content-Length: 0 Connection: keep-alive Server: AliyunOSS
Error codes
Error code | HTTP status code | Description |
AgenticBucketNotFound | 404 | The Agentic Bucket does not exist. |
InvalidArgument | 400 | The status parameter is missing or has an invalid value. Only Enabled and Disabled are supported. |