DocsICP FilingConsole
Documentation
Home Page Object Storage Service Developer Reference API reference Operations on OSS Agentic Buckets GetAgenticBucket

GetAgenticBucket

Updated at:
Copy as MD
Product
My Favorites

You can call the GetAgenticBucket operation to query the complete information about a specified Agentic Bucket, including its basic attributes and the template attributes that serve as the default configurations for Bucket Spaces created under this Agentic Bucket.

Usage notes

  • This operation uses a bucket-level host. The Host must be the full name of the Agentic Bucket, in the format of {prefix}-{uid}-{region}-ab-apsr.oss-{region}.aliyuncs.com.

  • The template configurations in the response, such as ACL, server-side encryption, versioning, Block Public Access, and bucket policy, are the default configurations inherited by Bucket Spaces created under this Agentic Bucket.

Request syntax

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

Response elements

Name

Type

Example

Description

AgenticBucketInfo

Container

N/A

The container that stores the information about the Agentic Bucket.

Parent node: none

Child nodes: Name, Owner, Region, StorageClass, DataRedundancyType, Status, CreateTime, ACL, PublicAccessBlock, ServerSideEncryptionRule, Versioning, BucketPolicy

Name

String

my-agentic-1234567890123456-cn-hangzhou-ab-apsr

The full name of the Agentic Bucket.

Parent node: AgenticBucketInfo

Child nodes: none

Owner

String

1234567890123456

The UID of the Alibaba Cloud account to which the Agentic Bucket belongs.

Parent node: AgenticBucketInfo

Child nodes: none

Region

String

cn-hangzhou

The region in which the Agentic Bucket resides.

Parent node: AgenticBucketInfo

Child nodes: none

StorageClass

String

Standard

The storage class. Valid values: Standard, IA, and Archive.

Parent node: AgenticBucketInfo

Child nodes: none

DataRedundancyType

String

LRS

The data redundancy type. Valid values: LRS and ZRS.

Parent node: AgenticBucketInfo

Child nodes: none

Status

String

Enabled

The status of the Agentic Bucket. Valid values: Enabled and Disabled.

Parent node: AgenticBucketInfo

Child nodes: none

CreateTime

String

2026-06-13T08:00:00.000Z

The time when the Agentic Bucket was created. The time is in ISO 8601 format.

Parent node: AgenticBucketInfo

Child nodes: none

ACL

String

private

The access control list (ACL) of the Agentic Bucket. Valid values: private, public-read, and public-read-write.

Parent node: AgenticBucketInfo

Child nodes: none

PublicAccessBlock

String

true

Indicates whether Block Public Access is enabled. Valid values: true and false.

Parent node: AgenticBucketInfo

Child nodes: none

ServerSideEncryptionRule

Container

N/A

The container that stores the server-side encryption configurations. This element is empty if server-side encryption is not configured.

Parent node: AgenticBucketInfo

Child nodes: ApplyServerSideEncryptionByDefault

ApplyServerSideEncryptionByDefault

Container

N/A

The container that stores the default server-side encryption configurations.

Parent node: ServerSideEncryptionRule

Child nodes: SSEAlgorithm

SSEAlgorithm

String

AES256

The server-side encryption algorithm specified in the default encryption configuration.

Parent node: ApplyServerSideEncryptionByDefault

Child nodes: none

Versioning

String

Disabled

The versioning state. Valid values: Enabled and Disabled.

Parent node: AgenticBucketInfo

Child nodes: none

BucketPolicy

String

N/A

The default bucket policy. This element is empty if no bucket policy is configured.

Parent node: AgenticBucketInfo

Child nodes: none

Examples

  • Sample request

    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

  • Sample response

    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>

Error codes

Error code

HTTP status code

Description

AgenticBucketNotFound

404

The Agentic Bucket does not exist.

AccessDenied

403

You do not have the permissions to query the information about the Agentic Bucket.

Previous：CreateAgenticBucketNext：ListAgenticBuckets