Tüm Ürünler
Search

Bu Ürün

    Object Storage Service:GetBucketInfo

    Belge Merkezi

    Object Storage Service:GetBucketInfo

    Son Güncelleme:Oct 01, 2026

    Bir paket hakkında bilgi görüntülemek için GetBucketInfo işlemini çağırın.

    Kullanım notları

    • Bu isteği herhangi bir Object Storage Service (OSS) uç noktasından gönderebilirsiniz.

    • Varsayılan olarak, bir Alibaba Cloud hesabı paket bilgilerini görüntüleme iznine sahiptir. Bir Resource Access Management (RAM) kullanıcısı veya Security Token Service (STS) kullanarak paket bilgilerini görüntülemek istiyorsanız, oss:GetBucketInfo iznine sahip olmanız gerekir. Daha fazla bilgi için bkz. RAM kullanıcısına özel bir ilke ekleme.

    İstek sözdizimi

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

    İstek üstbilgileri

    DescribeRegions yalnızca ortak istek üstbilgilerini kullanır. Daha fazla bilgi için bkz. Ortak istek üstbilgileri.

    Yanıt üstbilgileri

    Yanıt yalnızca ortak yanıt üstbilgilerini içerir. Daha fazla bilgi için bkz. Ortak yanıt üstbilgileri.

    Yanıt öğeleri

    Ad

    Tür

    Örnek

    Açıklama

    BucketInfo

    Konteyner

    Yok

    Paket bilgileri için konteyner.

    Alt düğüm: Bucket

    Üst düğüm: Yok

    Bucket

    Konteyner

    Yok

    Paket bilgileri için konteyner.

    Üst düğüm: BucketInfo

    CreationDate

    Zaman

    2013-07-31T10:56:21.000Z

    Paketin oluşturulduğu zaman. Zaman UTC cinsindendir.

    Üst düğüm: BucketInfo.Bucket

    ExtranetEndpoint

    Dize

    oss-cn-hangzhou.aliyuncs.com

    Genel uç nokta.

    Üst düğüm: BucketInfo.Bucket

    IntranetEndpoint

    Dize

    oss-cn-hangzhou-internal.aliyuncs.com

    Dahili uç nokta.

    Üst düğüm: BucketInfo.Bucket

    Location

    Dize

    oss-cn-hangzhou

    Paketin bulunduğu bölge. Değer, OSS için bölge kimliğidir.

    Üst düğüm: BucketInfo.Bucket

    StorageClass

    Dize

    Standard

    Paketin depolama sınıfı.

    Geçerli değerler: Standard, IA, Archive ve ColdArchive.

    Depolama sınıfları hakkında daha fazla bilgi için bkz. Depolama sınıfları.

    Name

    Dize

    oss-example

    Paketin adı.

    Üst düğüm: BucketInfo.Bucket

    ResourceGroupId

    Dize

    rg-aek27tc****

    Paketin ait olduğu kaynak grubunun kimliği.

    Paket varsayılan kaynak grubuna aitse bu parametrenin değeri rg-default-id olur.

    Üst düğüm: BucketInfo.Bucket

    Owner

    Konteyner

    Yok

    Paket sahibine ilişkin bilgiler için konteyner.

    Üst düğüm: BucketInfo.Bucket

    ID

    Dize

    27183473914****

    Paket sahibinin kullanıcı kimliği.

    Üst düğüm: BucketInfo.Bucket.Owner

    DisplayName

    Dize

    username

    Paket sahibinin adı. Bu parametre ID ile aynı değere sahiptir.

    Üst düğüm: BucketInfo.Bucket.Owner

    AccessControlList

    Konteyner

    Yok

    Paketin erişim kontrol listesini (ACL) içeren konteyner.

    Paket ACL'leri hakkında daha fazla bilgi için bkz. Paket ACL'si.

    Üst düğüm: BucketInfo.Bucket

    Grant

    Numaralandırma

    private

    Paketin ACL'si.

    Geçerli değerler: private, public-read ve public-read-write.

    Üst düğüm: BucketInfo.Bucket.AccessControlList

    DataRedundancyType

    Numaralandırma

    LRS

    Paketin veri yedeklilik türü.

    Geçerli değerler: LRS ve ZRS.

    Üst düğüm: BucketInfo.Bucket

    Versioning

    Dize

    Enabled

    Paketin sürüm oluşturma durumu.

    Geçerli değerler: Enabled ve Suspended.

    Sürüm oluşturma durumları hakkında daha fazla bilgi için bkz. PutBucketVersioning.

    Üst düğüm: BucketInfo.Bucket

    ServerSideEncryptionRule

    Konteyner

    Yok

    Sunucu tarafı şifreleme kuralları için konteyner.

    Sunucu tarafı şifreleme hakkında daha fazla bilgi için bkz. Sunucu tarafı şifreleme.

    Üst düğüm: BucketInfo.Bucket

    SSEAlgorithm

    Dize

    KMS

    Varsayılan sunucu tarafı şifreleme yöntemi.

    Geçerli değerler: KMS ve AES256.

    Üst düğüm: BucketInfo.Bucket.ServerSideEncryptionRule

    KMSMasterKeyID

    Dize

    Kullanımdaki KMS anahtarının kimliği. Bu parametre yalnızca SSEAlgorithm KMS olarak ayarlandığında ve bir anahtar kimliği belirtildiğinde döndürülür. Aksi takdirde bu parametre boştur.

    Üst düğüm: BucketInfo.Bucket.ServerSideEncryptionRule

    KMSDataEncryption

    Dize

    SM4

    Nesne için şifreleme algoritması. Bu parametre belirtilmezse AES-256 kullanılır. Bu parametre yalnızca SSEAlgorithm KMS olarak ayarlandığında geçerlidir.

    Üst düğüm: BucketInfo.Bucket.ServerSideEncryptionRule

    CrossRegionReplication

    Dize

    Disabled

    Paketin bölgeler arası çoğaltma (CRR) durumu.

    Geçerli değerler: Enabled ve Disabled.

    Üst düğüm: BucketInfo.Bucket

    TransferAcceleration

    Dize

    Disabled

    Paketin aktarma hızlandırma durumu.

    Geçerli değerler: Enabled ve Disabled.

    Üst düğüm: BucketInfo.Bucket

    HierarchicalNamespace

    Dize

    Enabled

    Paketin hiyerarşik ad alanı durumu.

    Geçerli değer: Enabled.

    Üst düğüm: BucketInfo.Bucket

    AccessMonitor

    Dize

    Enabled

    Paketin erişim izleme durumu.

    Geçerli değerler: Enabled ve Disabled.

    Üst düğüm: BucketInfo.Bucket

    BucketPolicy

    Konteyner

    Yok

    Günlük bilgileri için konteyner.

    Üst düğüm: BucketInfo.Bucket

    LogBucket

    Dize

    examplebucket

    Günlük kayıtlarını depolayan paketin adı.

    Üst düğüm: BucketInfo.Bucket.BucketPolicy

    LogPrefix

    Dize

    log/

    Günlük dosyalarının depolandığı dizin.

    Üst düğüm: BucketInfo.Bucket.BucketPolicy

    BlockPublicAccess

    Boolean

    true

    Paket için Genel Erişimi Engelle yapılandırması.

    • true: Genel Erişimi Engelle etkindir.

    • false: Genel Erişimi Engelle devre dışıdır.

    Örnekler

    Örnek istek

    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

    Örnek yanıtlar

    • Başarılı bir istek için örnek yanıt

      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>

    • Mevcut olmayan bir paket için örnek yanıt

      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>

    • Erişim reddedildi hatası için örnek yanıt

      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

    Bu işlemi çağırmak için aşağıdaki programlama dillerine yönelik SDK'ları kullanabilirsiniz:

    ossutil komut satırı aracı

    Bu işleme karşılık gelen ossutil komutu hakkında daha fazla bilgi için bkz. get-bucket-info.

    Hata kodları


    Hata kodu


    HTTP durum kodu


    Açıklama


    NoSuchBucket


    404


    Belirtilen paket mevcut değil.


    AccessDenied


    403


    Paket bilgilerini görüntüleme izniniz yok. Paket bilgilerini yalnızca paket sahibi görüntüleyebilir.