全部产品
Search

搜索本产品

    Object Storage Service：GetBucketInfo

    文档中心

    Object Storage Service：GetBucketInfo

    更新时间：Dec 07, 2025

    Panggil operasi GetBucketInfo untuk melihat informasi mengenai sebuah bucket.

    Catatan penggunaan

    • Anda dapat mengirim permintaan ini dari titik akhir Object Storage Service (OSS) mana pun.

    • Secara default, Akun Alibaba Cloud memiliki izin untuk melihat informasi bucket. Jika Anda ingin menggunakan Pengguna Resource Access Management (RAM) atau Security Token Service (STS) untuk melihat informasi bucket, Anda harus memiliki izin oss:GetBucketInfo. Untuk informasi selengkapnya, lihat Lampirkan kebijakan kustom ke RAM user.

    Sintaksis permintaan

    GET /?bucketInfo HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

    Header permintaan

    Semua header dalam permintaan DescribeRegions merupakan header permintaan umum. Untuk informasi selengkapnya, lihat Header permintaan umum.

    Header respons

    Semua header dalam respons terhadap permintaan DescribeRegions merupakan header respons umum. Untuk informasi selengkapnya, lihat Header respons umum.

    Elemen respons

    Name

    Type

    Example

    Description

    BucketInfo

    Container

    N/A

    Kontainer untuk informasi bucket.

    Node anak: Bucket

    Node induk: None

    Bucket

    Container

    N/A

    Kontainer untuk informasi bucket.

    Node induk: BucketInfo

    CreationDate

    Time

    2013-07-31T10:56:21.000Z

    Waktu saat bucket dibuat. Waktu dalam format UTC.

    Node induk: BucketInfo.Bucket

    ExtranetEndpoint

    String

    oss-cn-hangzhou.aliyuncs.com

    Titik akhir publik.

    Node induk: BucketInfo.Bucket

    IntranetEndpoint

    String

    oss-cn-hangzhou-internal.aliyuncs.com

    Titik akhir internal.

    Node induk: BucketInfo.Bucket

    Location

    String

    oss-cn-hangzhou

    Wilayah tempat bucket berada. Nilainya adalah ID wilayah untuk OSS.

    Node induk: BucketInfo.Bucket

    StorageClass

    String

    Standard

    Kelas penyimpanan bucket.

    Nilai yang valid: Standard, IA, Archive, dan ColdArchive.

    Untuk informasi selengkapnya mengenai kelas penyimpanan, lihat Kelas penyimpanan.

    Name

    String

    oss-example

    Nama bucket.

    Node induk: BucketInfo.Bucket

    ResourceGroupId

    String

    rg-aek27tc********

    ID kelompok sumber daya tempat bucket tersebut berada.

    Jika bucket berada dalam kelompok sumber daya default, nilai parameter ini adalah rg-default-id.

    Node induk: BucketInfo.Bucket

    Owner

    Container

    N/A

    Kontainer untuk informasi mengenai pemilik bucket.

    Node induk: BucketInfo.Bucket

    ID

    String

    27183473914****

    ID pengguna pemilik bucket.

    Node induk: BucketInfo.Bucket.Owner

    DisplayName

    String

    username

    Nama pemilik bucket. Parameter ini memiliki nilai yang sama dengan ID.

    Node induk: BucketInfo.Bucket.Owner

    AccessControlList

    Container

    N/A

    Kontainer untuk daftar kontrol akses (ACL) bucket.

    Untuk informasi selengkapnya mengenai ACL bucket, lihat Bucket ACL.

    Node induk: BucketInfo.Bucket

    Grant

    Enumeration

    private

    ACL bucket.

    Nilai yang valid: private, public-read, dan public-read-write.

    Node induk: BucketInfo.Bucket.AccessControlList

    DataRedundancyType

    Enumeration

    LRS

    Tipe redundansi data bucket.

    Nilai yang valid: LRS dan ZRS.

    Node induk: BucketInfo.Bucket

    Versioning

    String

    Enabled

    Status pengendalian versi bucket.

    Nilai yang valid: Enabled dan Suspended.

    Untuk informasi selengkapnya mengenai status pengendalian versi, lihat PutBucketVersioning.

    Node induk: BucketInfo.Bucket

    ServerSideEncryptionRule

    Container

    N/A

    Kontainer untuk aturan enkripsi sisi server.

    Untuk informasi selengkapnya mengenai enkripsi sisi server, lihat Enkripsi sisi server.

    Node induk: BucketInfo.Bucket

    SSEAlgorithm

    String

    KMS

    Metode enkripsi sisi server default.

    Nilai yang valid: KMS dan AES256.

    Node induk: BucketInfo.Bucket.ServerSideEncryptionRule

    KMSMasterKeyID

    String

    ******

    ID kunci KMS yang sedang digunakan. Parameter ini hanya dikembalikan jika `SSEAlgorithm` diatur ke `KMS` dan ID kunci ditentukan. Jika tidak, parameter ini kosong.

    Node induk: BucketInfo.Bucket.ServerSideEncryptionRule

    KMSDataEncryption

    String

    SM4

    Algoritma enkripsi untuk objek. Jika parameter ini tidak ditentukan, AES-256 akan digunakan. Parameter ini hanya berlaku ketika `SSEAlgorithm` diatur ke `KMS`.

    Node induk: BucketInfo.Bucket.ServerSideEncryptionRule

    CrossRegionReplication

    String

    Disabled

    Status replikasi lintas wilayah (CRR) bucket.

    Nilai yang valid: Enabled dan Disabled.

    Node induk: BucketInfo.Bucket

    TransferAcceleration

    String

    Disabled

    Status akselerasi transfer bucket.

    Nilai yang valid: Enabled dan Disabled.

    Node induk: BucketInfo.Bucket

    HierarchicalNamespace

    String

    Enabled

    Status namespace hierarkis bucket.

    Nilai yang valid: Enabled.

    Node induk: BucketInfo.Bucket

    AccessMonitor

    String

    Enabled

    Status pelacakan akses bucket.

    Nilai yang valid: Enabled dan Disabled.

    Node induk: BucketInfo.Bucket

    BucketPolicy

    Container

    N/A

    Kontainer untuk informasi log.

    Node induk: BucketInfo.Bucket

    LogBucket

    String

    examplebucket

    Nama bucket yang menyimpan catatan log.

    Node induk: BucketInfo.Bucket.BucketPolicy

    LogPrefix

    String

    log/

    Direktori tempat file log disimpan.

    Node induk: BucketInfo.Bucket.BucketPolicy

    BlockPublicAccess

    Boolean

    true

    Konfigurasi Blokir Akses Publik untuk bucket.

    • true: Blokir Akses Publik diaktifkan.

    • false: Blokir Akses Publik dinonaktifkan.

    Contoh

    Permintaan contoh

    Get /?bucketInfo HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com  
Date: Thu, 17 Apr 2025 07:51:28 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    Respons contoh

    • Respons contoh untuk permintaan yang berhasil

      HTTP/1.1 200
x-oss-request-id: 534B371674E88A4D8906****
Date: Sat, 12 Sep 2015 07:51:28 GMT
Connection: keep-alive
Content-Length: 531  
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<BucketInfo>
  <Bucket>
    <CreationDate>2013-07-31T10:56:21.000Z</CreationDate>
    <ExtranetEndpoint>oss-cn-hangzhou.aliyuncs.com</ExtranetEndpoint>
    <IntranetEndpoint>oss-cn-hangzhou-internal.aliyuncs.com</IntranetEndpoint>
    <Location>oss-cn-hangzhou</Location>
    <StorageClass>Standard</StorageClass>
    <TransferAcceleration>Disabled</TransferAcceleration>
    <CrossRegionReplication>Disabled</CrossRegionReplication>
    <HierarchicalNamespace>Enabled</HierarchicalNamespace>
    <Name>oss-example</Name>
    <ResourceGroupId>rg-aek27tc********</ResourceGroupId>
    <Owner>
      <DisplayName>username</DisplayName>
      <ID>27183473914****</ID>
    </Owner>
    <AccessControlList>
      <Grant>private</Grant>
    </AccessControlList>  
    <Comment>test</Comment>
    <BucketPolicy>
      <LogBucket>examplebucket</LogBucket>
      <LogPrefix>log/</LogPrefix>
    </BucketPolicy>
  </Bucket>
</BucketInfo>

    • Respons contoh untuk bucket yang tidak ada

      HTTP/1.1 404 
x-oss-request-id: 534B371674E88A4D8906****
Date: Sat, 12 Sep 2015 07:51:28 GMT
Connection: keep-alive
Content-Length: 308  
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>NoSuchBucket</Code>
  <Message>The specified bucket does not exist.</Message>
  <RequestId>568D547F31243C673BA1****</RequestId>
  <HostId>nosuchbucket.oss.aliyuncs.com</HostId>
  <BucketName>nosuchbucket</BucketName>
  <EC>0015-00000101</EC>
</Error>

    • Respons contoh untuk error akses ditolak

      HTTP/1.1 403
x-oss-request-id: 534B371674E88A4D8906****
Date: Sat, 12 Sep 2015 07:51:28 GMT
Connection: keep-alive
Content-Length: 209  
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>AccessDenied</Code>
  <Message>AccessDenied</Message>
  <RequestId>568D5566F2D0F89F5C0E****</RequestId>
  <HostId>test.oss.aliyuncs.com</HostId>
</Error>

    SDK

    Anda dapat menggunakan SDK berikut untuk memanggil operasi ini:

    Alat baris perintah ossutil

    Untuk informasi selengkapnya mengenai perintah ossutil yang sesuai dengan operasi ini, lihat get-bucket-info.

    Kode error

    Kode error

    Kode status HTTP

    Deskripsi

    NoSuchBucket

    404

    Bucket yang ditentukan tidak ada.

    AccessDenied

    403

    Anda tidak memiliki izin untuk melihat informasi bucket. Hanya pemilik bucket yang dapat melihat informasi bucket tersebut.