Object Storage Service:GetObjectTagging

Versionamento

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

Sintaxe

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

Cabeçalhos da solicitação

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

Cabeçalhos da resposta

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

Elementos da resposta

Exemplos

• Consulta de tags em bucket sem versionamento.

  Neste exemplo, o objeto objectname reside no bucket sem versionamento bucketname. A solicitação GetObjectTagging consulta as tags {a:1} e {b:2} de objectname. O sistema retorna 200 OK após recuperar as tags.

  Exemplos de solicitações

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

  Exemplos de respostas

  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>

• Consulta de tags em bucket com versionamento.

  Neste cenário, o objeto objectname está no bucket com versionamento bucketname. A solicitação GetObjectTagging busca as tags {age:18} da versão especificada de objectname. O retorno é 200 OK após a recuperação da tag.

  Exemplos de solicitações

  GET /objectname?tagging&versionId=CAEQExiBgID.jImWlxciIDQ2ZjgwODIyNDk5MTRhNzBiYmQwYTZkMTYzZjM0****
  Host: BucketName.oss-cn-hangzhou.aliyuncs.com
  Date: Wed, 24 Jun 2020 08:50:28 GMT
  Authorization: OSS qn6q**************:77Dv****************

  Exemplos de respostas

  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

Use os SDKs do OSS nas seguintes linguagens de programação para chamar a operação GetObjectTagging:

• Java

• Python

• Go V2

• PHP

• C++

• .NET

• Node.js

• iOS

ossutil

Para obter informações sobre o comando ossutil correspondente à operação GetObjectTagging, consulte get-object-tagging.

Códigos de erro