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.
Adquisición de capacidad aprovisionada (POST capacidad-aprovisionada)
Esta operación adquiere una unidad de capacidad aprovisionada para una Cuenta de AWS.
Una unidad de capacidad aprovisionada dura un mes a partir de la fecha y la hora de la compra, que es la fecha de inicio. La unidad se caduca en la fecha de vencimiento, que es exactamente un mes después de la fecha de inicio, al segundo más cercano.
Si la fecha de inicio es el 31 de un mes, la fecha de vencimiento es el último día del mes siguiente. Por ejemplo, si la fecha de inicio es 31 de agosto, la fecha de vencimiento es 30 de septiembre. Por ejemplo, si la fecha de inicio es 31 de enero, la fecha de vencimiento es 28 de febrero.
La capacidad aprovisionada garantiza que la capacidad de recuperación para las recuperaciones rápidas esté disponible cuando la necesite. Cada unidad de capacidad garantiza que se puedan realizar al menos tres recuperaciones rápidas cada cinco minutos, y proporciona un desempeño de recuperación de hasta 150 MB/s. Para obtener más información sobre la capacidad aprovisionada, consulte Opciones de recuperación de archivos.
nota
Hay un límite de dos unidades de capacidad aprovisionadas por Cuenta de AWS.
Solicitudes
Si quiere adquirir una unidad de capacidad aprovisionada para una Cuenta de AWS, envíe una solicitud HTTP POST
al URI de la capacidad aprovisionada.
Sintaxis
POST /
AccountId
/provisioned-capacity 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 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
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 solicitud de la operación se realiza correctamente, el servicio devuelve una respuesta HTTP 201
Created
.
Sintaxis
HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date x-amz-capacity-id:
CapacityId
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 |
---|---|
|
ID que identifica la unidad de capacidad aprovisionada. Tipo: String |
Cuerpo de respuesta
Esta operación no devuelve ningún cuerpo de respuesta.
Errores
Esta operación incluye los siguientes errores, además de los posibles errores comunes a todas las operaciones de Amazon S3 Glacier. Para obtener información sobre los errores de Amazon S3 Glacier y una lista de códigos de error, consulte Respuestas de error.
Code | Descripción | Código de estado HTTP | Tipo |
---|---|---|---|
LimitExceededException |
Este valor se devuelve si la solicitud proporcionada sobrepasa el límite de unidades de capacidad aprovisionadas de la cuenta. | 400 Bad Request |
Cliente |
Ejemplos
En el siguiente ejemplo, se adquiere capacidad aprovisionada para una cuenta.
Solicitud de ejemplo
En el siguiente ejemplo, se envía una solicitud HTTP POST para adquirir una unidad de capacidad aprovisionada.
POST /123456789012/provisioned-capacity 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
Respuesta de ejemplo
Si la solicitud se realizó correctamente, Amazon S3 Glacier (S3 Glacier) devuelve una respuesta HTTP 201 Created
, tal y como se muestra en el ejemplo siguiente.
HTTP/1.1 201 Created x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT x-amz-capacity-id: zSaq7NzHFQDANTfQkDen4V7z
Secciones relacionadas