调用GetAgenticBucket接口查询Agentic Bucket信息-对象存储(OSS)-阿里云帮助中心

调用GetAgenticBucket接口获取指定Agentic Bucket的完整信息，包括基础属性以及作为该Agentic Bucket下新建Bucket Space默认配置的模板属性。

注意事项

本接口使用Bucket级别Host，Host必须填写Agentic Bucket完整名称，即{prefix}-{uid}-{region}-ab-apsr.oss-{region}.aliyuncs.com。
响应中的模板配置（ACL、加密、版本控制、阻止公共访问、Bucket Policy等）为该Agentic Bucket下新建Bucket Space时继承的默认配置。

请求语法

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

请求头

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

响应元素

名称	类型	示例值	描述
AgenticBucketInfo	容器	不涉及	保存Agentic Bucket信息的容器。父节点：无子节点：Name、Owner、Region、StorageClass、DataRedundancyType、Status、CreateTime、ACL、PublicAccessBlock、ServerSideEncryptionRule、Versioning、BucketPolicy
Name	字符串	my-agentic-1234567890123456-cn-hangzhou-ab-apsr	Agentic Bucket完整名称。父节点：AgenticBucketInfo 子节点：无
Owner	字符串	1234567890123456	Agentic Bucket所属阿里云账号UID。父节点：AgenticBucketInfo 子节点：无
Region	字符串	cn-hangzhou	Agentic Bucket所在地域。父节点：AgenticBucketInfo 子节点：无
StorageClass	字符串	Standard	存储类型（Standard/IA/Archive）。父节点：AgenticBucketInfo 子节点：无
DataRedundancyType	字符串	LRS	数据容灾类型（LRS/ZRS）。父节点：AgenticBucketInfo 子节点：无
Status	字符串	Enabled	Agentic Bucket状态（Enabled/Disabled）。父节点：AgenticBucketInfo 子节点：无
CreateTime	字符串	2026-06-13T08:00:00.000Z	Agentic Bucket的创建时间（ISO8601格式）。父节点：AgenticBucketInfo 子节点：无
ACL	字符串	private	访问控制（private/public-read/public-read-write）。父节点：AgenticBucketInfo 子节点：无
PublicAccessBlock	字符串	true	是否开启阻止公共访问（true/false）。父节点：AgenticBucketInfo 子节点：无
ServerSideEncryptionRule	容器	不涉及	服务端加密配置的容器，未配置加密时为空节点。父节点：AgenticBucketInfo 子节点：ApplyServerSideEncryptionByDefault
ApplyServerSideEncryptionByDefault	容器	不涉及	默认加密配置的容器。父节点：ServerSideEncryptionRule 子节点：SSEAlgorithm
SSEAlgorithm	字符串	AES256	默认加密配置中指定的服务端加密算法。父节点：ApplyServerSideEncryptionByDefault 子节点：无
Versioning	字符串	Disabled	版本控制状态（Enabled/Disabled）。父节点：AgenticBucketInfo 子节点：无
BucketPolicy	字符串	不涉及	默认的Bucket Policy，未配置时为空。父节点：AgenticBucketInfo 子节点：无

示例

请求示例

GET /?agenticBucket 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

返回示例

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2D
Date: Mon, 26 Jul 2021 13:08:38 GMT
Content-Type: application/xml
Content-Length: 528
Connection: keep-alive
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<AgenticBucketInfo>
    <Name>my-agentic-1234567890123456-cn-hangzhou-ab-apsr</Name>
    <Owner>1234567890123456</Owner>
    <Region>cn-hangzhou</Region>
    <StorageClass>Standard</StorageClass>
    <DataRedundancyType>LRS</DataRedundancyType>
    <Status>Enabled</Status>
    <CreateTime>2026-06-13T08:00:00.000Z</CreateTime>
    <ACL>private</ACL>
    <PublicAccessBlock>true</PublicAccessBlock>
    <ServerSideEncryptionRule>
        <ApplyServerSideEncryptionByDefault>
            <SSEAlgorithm>AES256</SSEAlgorithm>
        </ApplyServerSideEncryptionByDefault>
    </ServerSideEncryptionRule>
    <Versioning>Disabled</Versioning>
    <BucketPolicy></BucketPolicy>
</AgenticBucketInfo>

错误码

错误码	HTTP状态码	描述
AgenticBucketNotFound	404	Agentic Bucket不存在。
AccessDenied	403	没有权限查看该Agentic Bucket的信息。