Chame GetBucketInfo para visualizar informações do bucket - Object Storage Service: Central de Documentação do Alibaba Cloud

Notas de uso

Envie esta solicitação de qualquer endpoint do Object Storage Service (OSS).
Por padrão, uma conta Alibaba Cloud tem permissão para visualizar informações do bucket. Para usar um usuário do Resource Access Management (RAM) ou o Security Token Service (STS) nessa tarefa, é necessário ter a permissão oss:GetBucketInfo. Para mais detalhes, consulte Anexar uma política personalizada a um usuário RAM.

Sintaxe da solicitação

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

Cabeçalhos da solicitação

O DescribeRegions utiliza apenas cabeçalhos comuns de solicitação. Para mais informações, consulte Cabeçalhos comuns de solicitação.

Cabeçalhos da resposta

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

Elementos da resposta

Nome	Tipo	Exemplo	Descrição
BucketInfo	Container	N/A	Contêiner das informações do bucket. Nó filho: Bucket Nó pai: Nenhum
Bucket	Container	N/A	Contêiner dos dados do bucket. Nó pai: BucketInfo
CreationDate	Time	2013-07-31T10:56:21.000Z	Horário de criação do bucket, em UTC. Nó pai: BucketInfo.Bucket
ExtranetEndpoint	String	oss-cn-hangzhou.aliyuncs.com	Endpoint público. Nó pai: BucketInfo.Bucket
IntranetEndpoint	String	oss-cn-hangzhou-internal.aliyuncs.com	Endpoint interno. Nó pai: BucketInfo.Bucket
Location	String	oss-cn-hangzhou	Região onde o bucket está localizado. O valor corresponde ao ID da região no OSS. Nó pai: BucketInfo.Bucket
StorageClass	String	Standard	Classe de armazenamento do bucket. Valores válidos: Standard, IA, Archive e ColdArchive. Para saber mais sobre classes de armazenamento, consulte Classes de armazenamento.
Name	String	oss-example	Nome do bucket. Nó pai: BucketInfo.Bucket
ResourceGroupId	String	rg-aek27tc****	ID do grupo de recursos ao qual o bucket pertence. Se o bucket fizer parte do grupo de recursos padrão, este parâmetro terá o valor rg-default-id. Nó pai: BucketInfo.Bucket
Owner	Container	N/A	Contêiner com informações sobre o proprietário do bucket. Nó pai: BucketInfo.Bucket
ID	String	27183473914****	ID de usuário do proprietário do bucket. Nó pai: BucketInfo.Bucket.Owner
DisplayName	String	username	Nome do proprietário do bucket. Este parâmetro possui o mesmo valor que o ID. Nó pai: BucketInfo.Bucket.Owner
AccessControlList	Container	N/A	Contêiner da lista de controle de acesso (ACL) do bucket. Para mais detalhes sobre ACLs de bucket, consulte ACL do bucket. Nó pai: BucketInfo.Bucket
Grant	Enumeration	private	ACL do bucket. Valores válidos: private, public-read e public-read-write. Nó pai: BucketInfo.Bucket.AccessControlList
DataRedundancyType	Enumeration	LRS	Tipo de redundância de dados do bucket. Valores válidos: LRS e ZRS. Nó pai: BucketInfo.Bucket
Versioning	String	Enabled	Estado do 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	Contêiner das regras de criptografia no lado do servidor. Para saber mais sobre criptografia no lado do servidor, consulte Criptografia no lado do servidor. Nó pai: BucketInfo.Bucket
SSEAlgorithm	String	KMS	Método padrão de criptografia no lado do servidor. Valores válidos: KMS e AES256. Nó pai: BucketInfo.Bucket.ServerSideEncryptionRule
KMSMasterKeyID	String		ID da chave KMS em uso. Este parâmetro é retornado apenas se `SSEAlgorithm` estiver definido como `KMS` e um ID de chave for especificado. Caso contrário, o parâmetro fica vazio. Nó pai: BucketInfo.Bucket.ServerSideEncryptionRule
KMSDataEncryption	String	SM4	Algoritmo de criptografia do objeto. Se não especificado, usa-se AES-256. Válido somente quando `SSEAlgorithm` é `KMS`. Nó pai: BucketInfo.Bucket.ServerSideEncryptionRule
CrossRegionReplication	String	Disabled	Status da replicação entre regiões (CRR) do bucket. Valores válidos: Enabled e Disabled. Nó pai: BucketInfo.Bucket
TransferAcceleration	String	Disabled	Status da aceleração de transferência do bucket. Valores válidos: Enabled e Disabled. Nó pai: BucketInfo.Bucket
HierarchicalNamespace	String	Enabled	Status do namespace hierárquico do bucket. Valor válido: Enabled. Nó pai: BucketInfo.Bucket
AccessMonitor	String	Enabled	Status do rastreamento de acesso do bucket. Valores válidos: Enabled e Disabled. Nó pai: BucketInfo.Bucket
BucketPolicy	Container	N/A	Contêiner das informações de log. Nó pai: BucketInfo.Bucket
LogBucket	String	examplebucket	Nome do bucket que armazena os registros de log. Nó pai: BucketInfo.Bucket.BucketPolicy
LogPrefix	String	log/	Diretório onde os arquivos de log são armazenados. Nó pai: BucketInfo.Bucket.BucketPolicy
BlockPublicAccess	Boolean	true	Configuração de Bloqueio de Acesso Público para o bucket. true: O Bloqueio de Acesso Público está ativado. false: O Bloqueio de Acesso Público está desativado.

Exemplos

Exemplo de solicitaçã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 resposta

Resposta de exemplo para uma solicitaçã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>

Resposta de exemplo 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>

Resposta de exemplo para 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 linguagens de programação abaixo para chamar esta operação:

Ferramenta de linha de comando ossutil

Para obter detalhes sobre o comando 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ões para visualizar as informações do bucket. Apenas o proprietário pode acessar esses dados.