Todos os produtos
Search

Este produto

    Object Storage Service:GetBucketTags

    Central de documentação

    Object Storage Service:GetBucketTags

    Última atualização: Sep 08, 2026

    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 ao chamar a operação GetBucketTags. Para mais detalhes, consulte Grant a custom policy.

    Elementos da resposta

    Elemento

    Tipo

    Descrição

    Tagging

    Container

    Contêiner que armazena as tags retornadas do bucket.

    Nó pai: Nenhum

    Nota

    Se o bucket não tiver tags configuradas, o corpo da mensagem XML retornará 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 da tag.

    Nó pai: Tag

    Value

    String

    Valor da tag.

    Nó pai: Tag

    Exemplos

    • Exemplo de solicitação

      GET /? tagging
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 13:09:13 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    • 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 chamar 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

    O bucket especificado não existe.

    AccessDenied

    403

    Você não tem permissão para consultar as tags configuradas no bucket. Somente o proprietário do bucket pode realizar essa consulta.