Creación de un almacén (almacén PUT) - Amazon Glacier
DescripciónSolicitudesRespuestasEjemplosSecciones relacionadasVéase también

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

Si busca soluciones de almacenamiento de archivos, se recomienda 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 almacenes) 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 con sus propias API 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 hay que hacer migraciones. 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 del cliente superior con las API basadas en buckets de S3, 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 AWSGuía de soluciones para la transferencia de datos de los almacenes de Amazon Glacier a las clases de almacenamiento de Amazon S3 Glacier.

Creación de un almacén (almacén PUT)

Descripción

Esta operación crea un nuevo almacén con el nombre especificado.  El nombre del almacén debe ser único en una región de AWS de una Cuenta de AWS. Puede crear hasta 1000 almacenes por cada cuenta. Para obtener información acerca de cómo crear más almacenes, consulte la página de detalles del producto de Amazon Glacier.

Cuando asigne un nombre a un almacén, debe ajustarse a las siguientes directrices.

  • Los nombres pueden tener de 1 a 255 caracteres de longitud.

  • Los caracteres válidos son las letras de la A a la Z (mayúsculas y minúsculas), los números del 0 al 9, “_” (guion bajo), “-” (guion) y “.” (punto).

Esta operación es idempotente. Esto significa que puede enviar la misma solicitud varias veces, aunque no tendrá ningún efecto después de la primera vez, cuando Amazon Glacier (Amazon Glacier) crea el almacén.

Solicitudes

Sintaxis

Para crear un almacén, envíe una solicitud HTTP PUT al URI del almacén que se va a crear.

PUT /AccountId/vaults/VaultName HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
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 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 la 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

El cuerpo de la solicitud de esta operación debe estar vacío (0 bytes).

Respuestas

Sintaxis

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location

Encabezados de respuesta

Una respuesta correcta incluye los siguientes encabezados de respuesta, además de los encabezados de respuesta comunes a todas las operaciones. Para obtener más información acerca de los encabezados de respuesta comunes, consulte Encabezados de respuesta comunes.

Nombre Descripción

Location

Ruta relativa del URI del trabajo que se ha creado.

Tipo: cadena

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 Glacier, consulte Respuestas de error.

Ejemplos

Solicitud de ejemplo

En el siguiente ejemplo, se envía una solicitud HTTP PUT para crear un almacén llamado examplevault. 

PUT /-/vaults/examplevault HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Content-Length: 0
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

Amazon Glacier crea el almacén y devuelve la ruta relativa del URI del almacén en el encabezado Location. El ID de la cuenta siempre se muestra en el encabezado Location, con independencia de si en la solicitud se especificó el ID de la cuenta o un guion ('-').

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Location: /111122223333/vaults/examplevault

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: