Obtener etiquetas de depósitos

Para mostrar las etiquetas de un depósito, debes realizar una solicitud GET que esté dirigida al depósito deseado y usar el parámetro de string de consulta tagging. Las etiquetas del depósito se muestran en un documento XML en el cuerpo de la respuesta.

Parámetros de string de consulta

Parámetro Descripción Obligatorio
tagging Puedes usarlo para mostrar las etiquetas asociadas con un depósito, y cada una tiene un par key:value. No

Consulta los parámetros de string de consulta de URL firmados para obtener información sobre los parámetros que incluyes cuando creas y usas URL firmadas.

Solicita encabezados

Consulta encabezados de solicitud comunes.

Elementos de cuerpo de la solicitud

Esta solicitud no incluye un documento XML en el cuerpo de la solicitud.

Sintaxis de la solicitud

La siguiente sintaxis se aplica a las solicitudes del depósito GET que usan el parámetro de string de consulta tagging.

GET /?tagging HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: 0
Authorization: AUTHENTICATION_STRING

Encabezados de respuesta

La solicitud puede mostrar una variedad de encabezados de respuesta según los encabezados de la solicitud que uses.

Elementos del cuerpo de la respuesta

Los siguientes elementos del cuerpo de respuesta solo se aplican si usas el parámetro de string de consulta tagging para obtener las etiquetas que se aplican al depósito.

Elemento Descripción
Tagging Es el contenedor de TagSet.
TagSet El contenedor de todas las etiquetas que se aplican al depósito.
Tag Es un contenedor de una etiqueta individual. Una etiqueta está compuesta por un par key:value.
Key La clave de una etiqueta.
Value El valor de una etiqueta.

Ejemplo

En el siguiente ejemplo, se recuperan las etiquetas de un depósito llamado my-bucket. En este ejemplo, el depósito tiene dos etiquetas aplicadas.

Solicitud

GET /?tagging HTTP/1.1
Host: my-bucket.storage.googleapis.com
Date: Thu, 24 Jan 2016 02:34:56 GMT
Content-Length: 0
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

Respuesta

HTTP/1.1 200 OK
Date: Thu, 24 Jan 2016 02:34:56 GMT
Expires: Mon, 01 Jan 1990 00:00:00 GMT
Cache-Control: no-cache, no-store, must-revalidate
Content-Length: 196
Content-Type: text/html

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
     <Tag>
       <Key>environment</Key>
       <Value>production</Value>
     </Tag>
     <Tag>
       <Key>billing</Key>
       <Value>marketing-department</Value>
     </Tag>
  </TagSet>
</Tagging>