调用CreateAgenticBucket接口创建Agentic Bucket-对象存储(OSS)-阿里云帮助中心

调用CreateAgenticBucket接口创建Agentic Bucket。Agentic Bucket是OSS提供的逻辑管理层，作为Bucket Space的模板和容器；创建时指定的属性配置将作为该Agentic Bucket下后续新建Bucket Space的默认配置。

注意事项

Agentic Bucket完整名称格式为{prefix}-{uid}-{region}-ab-apsr。其中prefix为用户自定义前缀，最少3个字符，仅支持小写字母、数字和短横线（-），且不能以短横线开头或结尾；uid与region由系统自动填充。完整名称总长度为3~63个字符，在Account-Regional命名空间内唯一。
单个阿里云账号在单个地域内最多可创建10个Agentic Bucket。
请求Body可为空。Body为空时，所有属性使用默认配置。
Agentic Bucket的属性修改仅对后续新建的Bucket Space生效，不影响存量Bucket Space。

请求语法

PUT /?agenticBucket HTTP/1.1
Host: {prefix}-{uid}-{region}-ab-apsr.oss-{region}.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

<?xml version="1.0" encoding="UTF-8"?>
<CreateAgenticBucketConfiguration>
    <StorageClass>Standard</StorageClass>
    <DataRedundancyType>LRS</DataRedundancyType>
</CreateAgenticBucketConfiguration>

请求头

此接口仅包含公共请求头。更多信息，请参见公共HTTP头定义。

请求元素

名称	类型	是否必选	示例值	描述
CreateAgenticBucketConfiguration	容器	否	不涉及	保存Agentic Bucket创建配置的容器。父节点：无子节点：StorageClass、DataRedundancyType
StorageClass	字符串	否	Standard	存储类型。取值如下： Standard：标准存储。默认取值。 IA：低频访问存储。 Archive：归档存储。父节点：CreateAgenticBucketConfiguration 子节点：无
DataRedundancyType	字符串	否	LRS	数据容灾类型。取值如下： LRS：本地冗余存储。默认取值。 ZRS：同城冗余存储。父节点：CreateAgenticBucketConfiguration 子节点：无

请求Body为空或未指定某属性时，该Agentic Bucket的默认配置如下：

属性	默认值	说明
Status	Enabled	Agentic Bucket创建后即处于启用状态。
ACL	private	私有读写权限。
PublicAccessBlock	true	默认开启阻止公共访问。
ServerSideEncryption	None	默认不配置服务端加密。
Versioning	Disabled	默认关闭版本控制。
BucketPolicy	空	默认不配置Bucket Policy。

示例

请求示例

PUT /?agenticBucket HTTP/1.1
Host: my-uid-region-ab-apsr.oss-cn-hangzhou.aliyuncs.com
Content-Type: application/xml
Content-Length: 200
Date: Thu, 17 Apr 2025 15:39:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

<?xml version="1.0" encoding="UTF-8"?>
<CreateAgenticBucketConfiguration>
    <StorageClass>Standard</StorageClass>
    <DataRedundancyType>LRS</DataRedundancyType>
</CreateAgenticBucketConfiguration>

返回示例

Agentic Bucket创建成功

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

错误码

错误码	HTTP状态码	描述
InvalidAgenticBucketName	400	Agentic Bucket名称不合法，例如前缀少于3个字符、包含非法字符、以短横线开头或结尾，或完整名称总长度不在3~63字符范围内。
AgenticBucketAlreadyExists	409	同名Agentic Bucket已存在。
AgenticBucketLimitExceeded	400	Agentic Bucket数量超过限制。单个阿里云账号在单个地域内最多可创建10个Agentic Bucket。
InvalidStorageClass	400	StorageClass取值不合法。
InvalidRedundancyType	400	DataRedundancyType取值不合法。