Adición de etiquetas a un almacén (POST tags add) - Amazon Glacier
Sintaxis de la solicitudParámetros de la solicitudRespuestasEjemplosSecciones relacionadasVéase también

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

Si busca soluciones de almacenamiento de archivos, le recomendamos que utilice las clases de almacenamiento de Amazon 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 las clases de almacenamiento de Amazon Glacier.

Amazon Glacier (servicio original independiente basado en bóveda) ya no aceptará nuevos clientes a partir del 15 de diciembre de 2025, sin que ello afecte a los clientes actuales. Amazon Glacier es un servicio independiente propio APIs que almacena datos en almacenes y es distinto de las clases de almacenamiento Amazon S3 y Amazon S3 Glacier. Sus datos actuales permanecerán seguros y accesibles en Amazon Glacier de forma indefinida. No se requiere ninguna migración. Para un almacenamiento de archivos a largo plazo y de bajo costo, AWS recomienda las clases de almacenamiento Amazon S3 Glacier, que ofrecen una experiencia de cliente superior con S3 basada en cubos APIs, Región de AWS disponibilidad total, costos más bajos e AWS integración de servicios. Si desea mejorar las capacidades, considere la posibilidad de migrar a las clases de almacenamiento de Amazon S3 Glacier mediante nuestra Guía de AWS soluciones para transferir datos de los almacenes de Amazon Glacier a las clases de almacenamiento de Amazon S3 Glacier.

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.

Adición de etiquetas a un almacén (POST tags add)

Esta operación agrega las etiquetas especificadas a un almacén. Cada etiqueta se compone de una clave y un valor. Cada almacén puede tener un máximo de 50 etiquetas. Si la solicitud provoca que se supere el límite de etiquetas del almacén, la operación genera el error LimitExceededException.

Si ya existe una etiqueta en el almacén con una clave especificada, se sobrescribirá el valor de clave existente. Para obtener más información acerca de las etiquetas, consulte Etiquetado de los recursos de Amazon Glacier.

Sintaxis de la solicitud

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

POST /AccountId/vaults/vaultName/tags?operation=add HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01
			
{
   "Tags": 
      {
         "string": "string",
         "string": "string"
      }        
}

nota

El AccountId valor es el Cuenta de AWS identificador. Este valor debe coincidir con el Cuenta de AWS ID asociado a las credenciales utilizadas para firmar la solicitud. Puede especificar un Cuenta de AWS ID o, si lo desea, un solo - '' (guión), en cuyo caso Amazon Glacier utilizará el Cuenta de AWS ID asociado a las credenciales utilizadas para firmar la solicitud. Si especifica su ID de cuenta, no incluya ningún guion (“-”) en él.

Parámetros de la solicitud

Nombre Descripción Obligatorio
operation=add

Un parámetro de cadena de consulta individual operation con el valor add para diferenciarlo de Eliminación de etiquetas del almacén (POST eliminación-etiquetas).

 Sí

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

El cuerpo de la solicitud contiene los siguientes campos JSON.

Etiquetas

Las etiquetas que se agregarán al almacén. Cada etiqueta se compone de una clave y un valor. El valor puede ser una cadena vacía.

Tipo: Asignación de cadena a cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 10 caracteres.

Obligatorio: sí

Respuestas

Si la solicitud de la operación se realiza correctamente, el servicio devuelve una respuesta HTTP 204 No Content.

Sintaxis

HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date

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

Esta operación no devuelve ningún cuerpo de respuesta.

Errores

Para obtener información sobre las excepciones y los mensajes de error de Amazon Glacier, consulteRespuestas de error.

Ejemplos

Solicitud de ejemplo

El siguiente ejemplo envía una solicitud HTTP POST con las etiquetas para agregar al almacén.

POST /-/vaults/examplevault/tags?operation=add HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
Content-Length: length
x-amz-glacier-version: 2012-06-01
			
{
  "Tags": 
    {
       "examplekey1": "examplevalue1",
       "examplekey2": "examplevalue2"
    }        
}

Respuesta de ejemplo

Si la solicitud se ha realizado correctamente, Amazon Glacier devuelve unHTTP 204 No Content, como se muestra en el siguiente ejemplo.

HTTP/1.1 204 No Content
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT

Véase también

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