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

Sobre o versionamento

Por padrão, a operação GetObjectTagging retorna apenas as tags da versão atual do objeto. Especifique o parâmetro versionId para consultar as tags de uma versão específica. Se a versão especificada for um marcador de exclusão, o OSS retornará 404 Not Found.

Sintaxe da solicitação

GET /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 Mar 2019 02:02:36 GMT
Authorization: SignatureValue

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição
tagging	String	Sim	Sub-recurso que identifica esta operação como de tagging.
versionId	String	Não	id da versão do objeto. Se não especificado, o sistema retorna as tags da versão atual. Caso a versão indicada seja um marcador de exclusão, o OSS retornará 404 Not Found.

Cabeçalhos da solicitação

Todos os cabeçalhos em uma solicitação GetObjectTagging são cabeçalhos comuns de solicitação. Para mais informações, consulte Common request headers.

Cabeçalhos da resposta

A resposta de uma solicitação GetObjectTagging inclui cabeçalhos comuns de resposta. Para mais informações, consulte Common response headers.

Ao consultar as tags de uma versão específica do objeto, a resposta também inclui o cabeçalho x-oss-version-id.

Elementos da resposta

Nome	Tipo	Descrição
Tagging	Container	Container raiz da resposta de tagging. Nós filhos: TagSet
TagSet	Container	Container que armazena todas as tags. Nó pai: Tagging. Nós filhos: Tag
Tag	Container	Uma única tag. Nó pai: TagSet. Nós filhos: Key e Value
Key	String	Chave da tag. Nó pai: Tag. Nós filhos: nenhum
Value	String	Valor da tag. Nó pai: Tag. Nós filhos: nenhum

Exemplos

Sem versionamento ativado: neste exemplo, uma solicitação GET consulta as tags do objeto objectname no bucket bucketname. As tags {a:1} e {b:2} são retornadas com o código de status 200 (OK).

Exemplo de solicitação

GET /objectname?tagging
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 Mar 2019 02:02:36 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Exemplo de resposta

200 (OK)
content-length: 209
server: AliyunOSS
x-oss-request-id: 5C919F38461FB4282600****
date: Wed, 20 Mar 2019 02:02:32 GMT
content-type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>a</Key>
      <Value>1</Value>
    </Tag>
    <Tag>
      <Key>b</Key>
      <Value>2</Value>
    </Tag>
  </TagSet>
</Tagging>

Com versionamento ativado: neste cenário, uma solicitação GET obtém as tags de uma versão específica do objeto objectname no bucket bucketname. O versionId foi definido na solicitação de exemplo. A tag {age:18} é retornada com o código de status 200 (OK).

Exemplo de solicitação

GET /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 24 Jun 2020 08:50:28 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Exemplo de resposta

200 (OK)
content-length: 161
server: AliyunOSS
x-oss-request-id: 5EF313D44506783438F3****
date: Wed, 24 Jun 2020 08:50:28 GMT
content-type: application/xml
x-oss-version-id: CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
    <Tag>
      <Key>age</Key>
      <Value>18</Value>
    </Tag>
  </TagSet>
</Tagging>

SDKs do OSS

Exemplos de SDK para a operação GetObjectTagging estão disponíveis nas seguintes linguagens de programação:

Ferramenta de linha de comando ossutil

Para obter informações sobre o comando do ossutil correspondente à operação GetObjectTagging, consulte GetObjectTagging.

Códigos de erro

Código de erro	Código de status HTTP	Descrição
FileAlreadyExists	409	Erro retornado quando o recurso de namespace hierárquico está ativado para o bucket e o objeto cujas tags se deseja consultar é um diretório.