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>