Adquisición de capacidad aprovisionada (POST capacidad-aprovisionada) - Amazon Glacier

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.

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 hasta un 150% de rendimiento MB/s de recuperación. 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 unidad. Cuenta de AWS

Solicitudes

Para comprar una unidad de capacidad aprovisionada y Cuenta de AWS enviar una POST solicitud HTTP al URI de 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 AccountId valor es el ID. Cuenta de AWS 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

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

x-amz-capacity-id

ID que identifica la unidad de capacidad aprovisionada.

Tipo: cadena

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 Glacier. Para obtener información sobre los errores de Amazon Glacier y una lista de códigos de error, consulteRespuestas de error.

Código 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 ha realizado correctamente, Amazon Glacier (Amazon Glacier) devuelve una HTTP 201 Created respuesta, como se muestra en el siguiente ejemplo.

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