Agentic Bucket属性配置接口

注意事项

• 所有属性配置接口均使用Bucket级别Host，Host必须填写Agentic Bucket完整名称，即{prefix}-{uid}-{region}-ab-apsr.oss-{region}.aliyuncs.com（内网为{prefix}-{uid}-{region}-ab-apsr.oss-{region}-internal.aliyuncs.com）。

• 属性配置作为模板仅对该Agentic Bucket下后续新建的Bucket Space生效，不影响存量Bucket Space。

• 各接口的请求Body与响应格式与对应的Bucket接口（如PutBucketAcl、PutBucketEncryption等）完全一致，本文不再逐一重复字段说明。

接口列表

调用说明

各属性配置接口的请求Body、响应格式及字段含义与对应的Bucket接口完全一致，具体字段说明请参见对应的Bucket接口文档（如PutBucketAcl、PutBucketEncryption、PutBucketVersioning、PutBucketPolicy、PutBucketPublicAccessBlock等）。

与对应Bucket接口的差异仅在于：

• Host：填写Agentic Bucket完整名称，而非普通Bucket名称。

• URL子资源：在agenticBucket子资源基础上叠加对应属性子资源，例如ACL接口为/?agenticBucket&acl。

• 生效范围：配置作为模板，仅对该Agentic Bucket下后续新建的Bucket Space生效。

请求头

各接口均支持公共请求头。更多信息，请参见公共HTTP头定义。其中，PutAgenticBucketAcl还支持通过x-oss-acl请求头设置ACL，取值与PutBucketAcl一致。

示例

• 通过请求头设置Agentic Bucket的ACL

  PUT /?agenticBucket&acl HTTP/1.1
  Host: my-uid-region-ab-apsr.oss-cn-hangzhou.aliyuncs.com
  x-oss-acl: private
  Date: Thu, 17 Apr 2025 15:39:12 GMT
  Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

• 设置Agentic Bucket的阻止公共访问

  PUT /?agenticBucket&publicAccessBlock HTTP/1.1
  Host: my-uid-region-ab-apsr.oss-cn-hangzhou.aliyuncs.com
  Content-Type: application/xml
  Content-Length: 151
  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"?>
  <PublicAccessBlockConfiguration>
    <BlockPublicAccess>true</BlockPublicAccess>
  </PublicAccessBlockConfiguration>

• 返回示例

  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

错误码