Esta página es solo para los clientes actuales del servicio S3 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 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
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.
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 de la bóveda debe ser único dentro de una AWS región para un 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 S3 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 S3 Glacier (S3 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/VaultNameHTTP/1.1 Host: glacier.Region.amazonaws.com Date:DateAuthorization:SignatureValueContent-Length:Lengthx-amz-glacier-version: 2012-06-01
nota
El AccountId valor es el Cuenta de AWS ID. 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 S3 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
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 |
|---|---|
|
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 S3 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
S3 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/examplevaultSecciones relacionadas
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:
