Todos os produtos
Search

Este produto

    Object Storage Service:GetBucketInfo

    Central de documentação

    Object Storage Service:GetBucketInfo

    Última atualização: Sep 22, 2026

    Chame a operação GetBucketInfo para visualize as informações de um bucket.

    Notas de uso

    • É possível enviar esta requisição a partir de qualquer endpoint do Object Storage Service (OSS).

    • Por padrão, uma conta Alibaba Cloud tem permissão para visualize as informações do bucket. Para usar um usuário do Resource Access Management (RAM) ou do Security Token service (STS) para visualize essas informações, é necessária a permissão oss:GetBucketInfo. Para mais informações, consulte Attach a custom policy to a RAM user.

    Sintaxe da requisição

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

    Cabeçalhos da requisição

    O DescribeRegions usa apenas cabeçalhos de requisição comuns. Para mais informações, consulte Common request headers.

    Cabeçalhos da resposta

    A resposta contém apenas cabeçalhos de resposta comuns. Para mais informações, consulte Common response headers.

    Elementos da resposta

    Nome

    Tipo

    Exemplo

    Descrição

    BucketInfo

    Container

    N/A

    O container das informações do bucket.

    Nó filho: Bucket

    Nó pai: Nenhum

    Bucket

    Container

    N/A

    O container das informações do bucket.

    Nó pai: BucketInfo

    CreationDate

    Data e hora

    2013-07-31T10:56:21.000Z

    A data e a hora de criação do bucket, em UTC.

    Nó pai: BucketInfo.Bucket

    ExtranetEndpoint

    String

    oss-cn-hangzhou.aliyuncs.com

    O endpoint público.

    Nó pai: BucketInfo.Bucket

    IntranetEndpoint

    String

    oss-cn-hangzhou-internal.aliyuncs.com

    O endpoint interno.

    Nó pai: BucketInfo.Bucket

    Location

    String

    oss-cn-hangzhou

    A região em que o bucket está localizado. O valor é o id da região do OSS.

    Nó pai: BucketInfo.Bucket

    StorageClass

    String

    Standard

    A classe de armazenamento do bucket.

    Valores válidos: Standard, IA, Archive e ColdArchive.

    Para mais informações sobre classes de armazenamento, consulte Storage classes.

    Name

    String

    oss-example

    O nome do bucket.

    Nó pai: BucketInfo.Bucket

    ResourceGroupId

    String

    rg-aek27tc****

    O id do grupo de recursos ao qual o bucket pertence.

    Se o bucket pertencer ao grupo de recursos padrão, o valor deste parâmetro será rg-default-id.

    Nó pai: BucketInfo.Bucket

    Owner

    Container

    N/A

    O container das informações do proprietário do bucket.

    Nó pai: BucketInfo.Bucket

    ID

    String

    27183473914****

    O id do usuário proprietário do bucket.

    Nó pai: BucketInfo.Bucket.Owner

    DisplayName

    String

    username

    O nome do proprietário do bucket. Este parâmetro tem o mesmo valor do id.

    Nó pai: BucketInfo.Bucket.Owner

    AccessControlList

    Container

    N/A

    O container da lista de controle de acesso (ACL) do bucket.

    Para mais informações sobre ACLs de bucket, consulte Bucket ACL.

    Nó pai: BucketInfo.Bucket

    Grant

    Enumeração

    private

    A ACL do bucket.

    Valores válidos: private, public-read e public-read-write.

    Nó pai: BucketInfo.Bucket.AccessControlList

    DataRedundancyType

    Enumeração

    LRS

    O tipo de redundância de dados do bucket.

    Valores válidos: LRS e ZRS.

    Nó pai: BucketInfo.Bucket

    Versioning

    String

    Enabled

    O status de versionamento do bucket.

    Valores válidos: Enabled e Suspended.

    Para mais informações sobre estados de versionamento, consulte PutBucketVersioning.

    Nó pai: BucketInfo.Bucket

    ServerSideEncryptionRule

    Container

    N/A

    O container das regras de criptografia no lado do servidor.

    Para mais informações sobre criptografia no lado do servidor, consulte Server-side encryption.

    Nó pai: BucketInfo.Bucket

    SSEAlgorithm

    String

    KMS

    O método padrão de criptografia no lado do servidor.

    Valores válidos: KMS e AES256.

    Nó pai: BucketInfo.Bucket.ServerSideEncryptionRule

    KMSMasterKeyID

    String

    O id da chave do KMS em uso. Este parâmetro é retornado apenas se SSEAlgorithm estiver defina como KMS e um id de chave for especificado. Caso contrário, o parâmetro ficará vazio.

    Nó pai: BucketInfo.Bucket.ServerSideEncryptionRule

    KMSDataEncryption

    String

    SM4

    O algoritmo de criptografia do objeto. Se este parâmetro não for especificado, o AES-256 será usado. Este parâmetro é válido apenas quando SSEAlgorithm estiver defina como KMS.

    Nó pai: BucketInfo.Bucket.ServerSideEncryptionRule

    CrossRegionReplication

    String

    Disabled

    O status de replicação entre regiões (CRR) do bucket.

    Valores válidos: Enabled e Disabled.

    Nó pai: BucketInfo.Bucket

    TransferAcceleration

    String

    Disabled

    O status de aceleração de transferência do bucket.

    Valores válidos: Enabled e Disabled.

    Nó pai: BucketInfo.Bucket

    HierarchicalNamespace

    String

    Enabled

    O status de namespace hierárquico do bucket.

    Valor válido: Enabled.

    Nó pai: BucketInfo.Bucket

    AccessMonitor

    String

    Enabled

    O status de monitoramento de acesso do bucket.

    Valores válidos: Enabled e Disabled.

    Nó pai: BucketInfo.Bucket

    BucketPolicy

    Container

    N/A

    O container das informações de log.

    Nó pai: BucketInfo.Bucket

    LogBucket

    String

    examplebucket

    O nome do bucket que armazena os registros de log.

    Nó pai: BucketInfo.Bucket.BucketPolicy

    LogPrefix

    String

    log/

    O diretório em que os arquivos de log são armazenados.

    Nó pai: BucketInfo.Bucket.BucketPolicy

    BlockPublicAccess

    Boolean

    true

    A configuração do Block Public Access do bucket.

    • true: o Block Public Access está ativado.

    • false: o Block Public Access está desativado.

    Exemplos

    Exemplo de requisição

    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

    Exemplos de respostas

    • Exemplo de resposta para uma requisição bem-sucedida

      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>

    • Exemplo de resposta para um bucket inexistente

      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>

    • Exemplo de resposta para um erro de acesso negado

      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

    Use os SDKs das seguintes linguagens de programação para chamar esta operação:

    Ferramenta de linha de comando ossutil

    Para obter mais informações sobre o comando do ossutil correspondente a esta operação, consulte get-bucket-info.

    Códigos de erro

    Código de erro

    Código de status HTTP

    Descrição

    NoSuchBucket

    404

    O bucket especificado não existe.

    AccessDenied

    403

    Você não tem permissão para visualize as informações do bucket. Apenas o proprietário do bucket pode visualize essas informações.