GetBucketTags - Object Storage Service: Central de Documentação do Alibaba Cloud

Use esta operação para consultar as tags configuradas em um bucket.

Sintaxe da solicitação

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

Observações

A permissão oss:GetBucketTagging é necessária para obter as informações de tag do bucket com a operação GetBucketTags. Para mais detalhes, consulte Conceder uma política personalizada.

Elementos da resposta

Elemento	Tipo	Descrição
Tagging	Container	Contêiner que armazena as tags retornadas do bucket. Nó pai: Nenhum Nota Se nenhuma tag estiver configurada no bucket, o corpo da mensagem XML será retornado com o elemento Tagging vazio.
TagSet	Container	Contêiner que armazena as tags retornadas do bucket. Nó pai: Nenhum
Tag	Container	Contêiner que armazena uma tag retornada do bucket. Nó pai: TagSet
Key	String	Chave de uma tag. Nó pai: Tag
Value	String	Valor de uma tag. Nó pai: Tag

Exemplos

Exemplo de solicitação

GET /? tagging
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Tue, 20 Dec 2018 13:09:13 GMT
Authorization: OSS qn6q**************:77Dv****************

Exemplo de resposta

200 (OK)
content-length: 237
server: AliyunOSS
x-oss-request-id: 5C1B2D24B90AD5490CFE368E
date: Thu, 20 Dec 2018 13:12:21 GMT
content-type: application/xml
<? xml version="1.0" encoding="UTF-8"? >
<Tagging>
  <TagSet>
    <Tag>
      <Key>testa</Key>
      <Value>value1-test</Value>
    </Tag>
    <Tag>
      <Key>testb</Key>
      <Value>value2-test</Value>
    </Tag>
  </TagSet>
</Tagging>

SDKs do OSS

Use os SDKs do OSS nas linguagens de programação a seguir para executar a operação GetBucketTags:

ossutil

Para obter informações sobre o comando do ossutil correspondente à operação GetBucketTags, consulte get-bucket-tags.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
NoSuchBucket	404	Erro retornado quando o bucket especificado não existe.
AccessDenied	403	Erro retornado quando você não tem permissão para consultar as tags configuradas no bucket. Somente o proprietário do bucket pode consultar essas tags.