Enumeración de etiquetas del almacén (GET etiquetas) - Amazon S3 Glacier
Sintaxis de la solicitudParámetros de solicitudEncabezados de solicitudCuerpo de la solicitudRespuestasEjemplosSecciones relacionadasVéase también

Esta página es solo para los clientes actuales del servicio S3 Glacier que utilizan Vaults y la API REST original de 2012.

Si busca soluciones de almacenamiento de archivos, le sugerimos que utilice las clases de almacenamiento S3 Glacier en Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval y S3 Glacier Deep Archive. Para obtener más información sobre estas opciones de almacenamiento, consulte Clases de almacenamiento de S3 Glacier y Almacenamiento de datos a largo plazo con clases de almacenamiento de S3 Glacier en la Guía del usuario de Amazon S3. Estas clases de almacenamiento utilizan la API de Amazon S3, están disponibles en todas las regiones y se pueden gestionar en la consola de Amazon S3. Ofrecen funciones como el análisis de costos de almacenamiento, Storage Lens, funciones de seguridad que incluyen múltiples opciones de cifrado y más.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Enumeración de etiquetas del almacén (GET etiquetas)

Esta operación muestra todas las etiquetas asociadas a un almacén. La operación devuelve una correspondencia vacía si no hay etiquetas. Para obtener más información acerca de las etiquetas, consulte Etiquetado de recursos de Amazon S3 Glacier.

Sintaxis de la solicitud

Para mostrar las etiquetas de un almacén, envíe una solicitud HTTP GET al URI de las etiquetas, tal y como se muestra en el siguiente ejemplo de sintaxis.

GET /AccountId/vaults/vaultName/tags HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

nota

El valor AccountId es el ID de Cuenta de AWS. Este valor debe coincidir con el ID de la Cuenta de AWS asociada con las credenciales que se utilizaron para firmar la solicitud. Puede especificar un ID de Cuenta de AWS o, si lo desea, un solo carácter “-” (guion), en cuyo caso, Amazon S3 Glacier usa el ID de la Cuenta de AWS asociada con las credenciales empleadas para firmar la solicitud. Si especifica su ID de cuenta, no incluya ningún guion (“-”) en él.

Parámetros de solicitud

Esta operación no usa parámetros de solicitud.

Encabezados de solicitud

Esta operación solo usa encabezados de solicitud que sean comunes para todas las operaciones. Para obtener información acerca de los encabezados de solicitudes comunes, consulte Encabezados de solicitudes comunes.

Cuerpo de la solicitud

Esta operación no tiene un cuerpo de la solicitud.

Respuestas

Si la operación se realiza correctamente, el servicio devuelve una respuesta HTTP 200 OK.

Sintaxis de la respuesta

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length
{
   "Tags": 
      {
         "string" : "string",
         "string" : "string"
      }
}

Encabezados de respuesta

Esta operación solo usa encabezados de respuesta que sean comunes a la mayoría de las respuestas. Para obtener información acerca de los encabezados de respuestas comunes, consulte Encabezados de respuesta comunes.

Cuerpo de respuesta

El cuerpo de la respuesta contiene los siguientes campos JSON.

Etiquetas

Etiquetas asociadas al almacén. Cada etiqueta se compone de una clave y un valor.

Tipo: Asignación de cadena a cadena

Obligatorio: sí

Errores

Para obtener información acerca de los mensajes de error y las excepciones de Amazon S3 Glacier, consulte Respuestas de error.

Ejemplos

Ejemplo: Mostrar las etiquetas de un almacén

En el ejemplo siguiente, se muestran las etiquetas de un almacén.

Solicitud de ejemplo

En este ejemplo, se envía una solicitud GET para recuperar una lista de etiquetas del almacén especificado.

GET /-/vaults/examplevault/tags HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2

Respuesta de ejemplo

Si la solicitud se ha realizado correctamente, Amazon S3 Glacier (S3 Glacier) devuelve una respuesta HTTP 200 OK con una lista de etiquetas del almacén, tal y como se muestra en el siguiente ejemplo.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Content-Type: application/json
Content-Length: length

{
   "Tags",
      {
         "examplekey1": "examplevalue1",
         "examplekey2": "examplevalue2"
      }  
}

Véase también

Para obtener más información sobre el uso de esta API en uno de los SDK de Amazon específicos de idioma, consulte lo siguiente: