Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda> Object Storage Service> Referência de API> As API> Configurações avançadas de bucket> Obtenção de tags de um bucket
Atualizado em 2022-11-07 GMT+08:00
Ver PDF

Obtenção de tags de um bucket

Funções

Esta operação obtém informações sobre tags de um bucket.

Para executar essa operação, você deve ter a permissão GetBucketTagging. Por padrão, somente o proprietário do bucket pode obter as tags de um bucket. O proprietário do bucket pode permitir que outros usuários executem essa operação definindo uma política de bucket ou concedendo a eles a permissão.

Sintaxe da solicitação

1
2
3
4
 
GET /?tagging HTTP/1.1 
Host: bucketname.obs.region.myhuaweicloud.com 
Date: date
Authorization: authorization string

Parâmetros de solicitação

Esta solicitação não contém nenhum parâmetro.

Cabeçalhos de solicitação

Essa solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 3.

Elementos de solicitação

Este pedido não envolve elementos.

Sintaxe da resposta

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
 
HTTP/1.1 status_code
x-obs-request-id: request id
x-obs-id-2: id
Content-Type: application/xml 
Content-Length: length
Date: date
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> 
<Tagging xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
    <TagSet> 
        <Tag> 
            <Key>key</Key> 
            <Value>value</Value> 
        </Tag> 
    </TagSet> 
</Tagging>

Cabeçalhos de resposta

A resposta à solicitação usa cabeçalhos comuns. Para mais detalhes, consulte Tabela 1.

Elementos de resposta

Essa resposta contém elementos para detalhar a configuração da tag do bucket. Tabela 1 descreve os elementos.

Tabela 1 Elementos para configurar tags de bucket

Elemento

Descrição

Tagging

Elemento do conjunto de tags e tag.

Tipo: elemento

Antepassado: nenhum

TagSet

Elemento do conjunto de tags.

Tipo: elemento

Antepassado: Adição de tags

Tag

Elemento da informação da tag.

Tipo: elemento

Antepassado: TagSet

Key

Nome da tag.

Tipo: string

Antepassado: Tag

Value

Valor da tag.

Tipo: string

Antepassado: Tag

Respostas de erro

Além dos códigos de erro comuns, essa API também retorna outros códigos de erro. A tabela a seguir lista erros comuns e possíveis causas. Para mais detalhes, consulte Tabela 2.

Tabela 2 Erros de configuração da tag do bucket

Código de erro

Descrição

Código de status HTTP

NoSuchTagSet

O bucket especificado não tem nenhuma tag.

404 Not Found

Solicitação de exemplo

1
2
3
4
5
6
 
GET /?tagging HTTP/1.1   
User-Agent: curl/7.29.0   
Host: examplebucket.obs.region.myhuaweicloud.com
Accept: */*   
Date: Wed, 27 Jun 2018 13:25:44 GMT  
Authorization: OBS H4IPJX0TQTHTHEBQQCEC:H1INcyc5i0XlHqYTfuzkPxLZUPM=

Resposta de exemplo

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
 
HTTP/1.1 200 OK 
x-obs-request-id: 0002B7532E0000015BEB35330C5884X1 
x-obs-id-2: s12w20LYNQqSb7moq4ibgJwmQRSmVQV+rFBqplOGYkXUpXeS/nOmbkyD+E35K79j 
Content-Type: application/xml 
Date: Wed, 27 Jun 2018 13:25:44 GMT 
Content-Length: 441 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Tagging xmlns="http://obs.ap-southeast-1.myhuaweicloud.com/doc/2015-06-30/">
  <TagSet>
    <Tag>
      <Key>TagName1</Key>
      <Value>TageSetVaule1</Value>
    </Tag>
  </TagSet>
</Tagging>