PutAgenticBucketStatus

Updated at:

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: SignatureValue

Request 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:

  • Enabled: enables the Agentic Bucket.

  • Disabled: disables the Agentic Bucket. After an Agentic Bucket is disabled, no new Bucket Spaces can be created. Disabling is also a prerequisite for deleting an Agentic Bucket.

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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    • Enable 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.