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 2023-07-11 GMT+08:00

Ver PDF

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

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

Parámetros de solicitud

Esta solicitud no contiene ningún parámetro.

Encabezados de solicitud

Esta solicitud utiliza encabezados comunes. Para más detalles, consulte Tabla 3.

Elementos de solicitud.

Esta solicitud no implica ningún elemento.

Sintaxis de respuesta

    
         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 cubeta
Elemento	Descripción
Tagging	Elemento del conjunto de etiquetas y las etiqueta. Tipo: element Antepasado: ninguno
TagSet	Elemento del conjunto de etiquetas. Tipo: element Antepasado: Tagging
Tag	Elemento de la información de la etiqueta. Tipo: element 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 más detalles, 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

    
         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

    
         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>