Esta página es solo para los clientes actuales del servicio S3 Glacier que utilizan Vaults y el original de 2012. REST API
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
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 recursos de Amazon S3 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 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
Nombre | Descripción | Obligatorio |
---|---|---|
operation=add
|
Un parámetro de cadena de consulta individual |
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 acerca de los mensajes de error y las excepciones de Amazon S3 Glacier, consulte Respuestas 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 realizó correctamente, S3 Glacier devuelve HTTP 204 No Content
, tal y como se muestra en el ejemplo siguiente.
HTTP/1.1 204 No Content x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT
Secciones relacionadas
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: