Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.
Centro de ayuda/ Object Storage Service/ Referencia de la API/ Las API/ Configuración avanzada del bucket/ Obtención de etiquetas de bucket
Actualización más reciente 2024-09-18 GMT+08:00
Ver PDF
Compartir

Obtención de etiquetas de bucket

Funciones

Esta operación obtiene información acerca de las etiquetas de un bucket.

Para realizar esta operación, debe tener el permiso GetBucketTagging. De forma predeterminada, solo el propietario del bucket puede obtener las etiquetas de un bucket. El propietario del bucket puede permitir que otros usuarios realicen esta operación estableciendo una política de bucket o concediéndoles el permiso.

Sintaxis de solicitud

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

Parámetros de solicitud

Esta solicitud no contiene parámetros de mensaje.

Encabezados de solicitud

Esta solicitud utiliza encabezados comunes. Para obtener más información, véase Tabla 3.

Elementos de solicitud

Esta solicitud no implica ningún elemento.

Sintaxis de respuesta

 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>

Encabezados de respuesta

La respuesta a la solicitud utiliza encabezados comunes. Para más detalles, consulte Tabla 1.

Elementos de respuesta

Esta respuesta contiene elementos para detallar la configuración de la etiqueta de bucket. Tabla 1 describe los elementos.

Tabla 1 Elementos para configurar etiquetas de bucket

Elemento

Descripción

Tagging

Elemento del conjunto de etiquetas y las etiqueta.

Tipo: container

Antepasado: ninguno

TagSet

Elemento del conjunto de etiquetas.

Tipo: container

Antepasado: Tagging

Tag

Elemento de la información de la etiqueta.

Tipo: container

Antepasado: TagSet

Key

Nombre de la etiqueta.

Tipo: string

Antepasado: Tag

Value

Valor de la etiqueta.

Tipo: string

Antepasado: Tag

Respuestas de error

Además de los códigos de error comunes, esta API también devuelve otros códigos de error. En la siguiente tabla se enumeran los errores comunes y las posibles causas. Para obtener más información, consulte Tabla 2.

Tabla 2 Errores de configuración de etiquetas de bucket

Código de error

Descripción

Código de estado de HTTP

NoSuchTagSet

El bucket especificado no tiene ninguna etiqueta.

404 Not Found

Modelo de solicitud

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=

Modelo de respuesta

 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>