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
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.
Configuración de la política de recuperación de datos (PUT policy)
Descripción
Esta operación establece y, a continuación, promulga una política de recuperación de datos en la AWS región especificada en la solicitud. PUT Puede establecer una política por AWS región para un. Cuenta de AWS La política se aplica a los pocos minutos de una operación PUT correcta.
La operación de establecimiento de política no afecta a los trabajos de recuperación que estaban en curso antes de que se aplicara la política. Para obtener más información sobre las políticas de recuperación de datos, consulte Políticas de recuperación de datos de Amazon Glacier.
Solicitudes
Sintaxis
Para establecer una política de recuperación de datos actual, envíe una solicitud HTTP PUT al URI de la política de recuperación de datos, tal y como se muestra en el siguiente ejemplo de sintaxis.
PUT /AccountId/policies/data-retrieval HTTP/1.1 Host: glacier.Region.amazonaws.com Date:DateAuthorization:SignatureValueContent-Length:Lengthx-amz-glacier-version: 2012-06-01 { "Policy": { "Rules":[ { "Strategy": String, "BytesPerHour": Number } ] } }
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 único - '' (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
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 contiene los siguientes campos JSON.
- BytesPerHour
-
El número máximo de bytes que se pueden recuperar en una hora.
Este campo solo es obligatorio si el valor del campo Strategy es
BytesPerHour. La operación PUT se rechazará si el campo Strategy no está establecido enBytesPerHoury configura este campo.Tipo: Número
Obligatorio: Sí, si el campo Strategy (Estrategia) está configurado en
BytesPerHour. De lo contrario, no lo es.Valores válidos: Valor entero mínimo de 1. Valor entero máximo de 2^63 - 1 incluido.
- Reglas
-
La regla de política. Aunque se trata de un tipo de lista, actualmente solo debe haber una regla, que contenga un campo de estrategia y, opcionalmente, un BytesPerHour campo.
Tipo: Array
Obligatorio: sí
- Strategy (Estrategia)
-
Tipo de política de recuperación de datos para establecer.
Tipo: cadena
Obligatorio: sí
Valores válidos:
BytesPerHour|FreeTier|None.BytesPerHourequivale a seleccionar Max Retrieval Rate (Velocidad de recuperación máx.) en la consola.FreeTierequivale a seleccionar Free Tier Only (Solo nivel gratis) en la consola.Noneequivale a seleccionar No Retrieval Policy (Sin política de recuperación) en la consola. Para obtener más información sobre la selección de las políticas de recuperación de datos en la consola, consulte Políticas de recuperación de datos de Amazon Glacier.
Respuestas
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 sobre las excepciones y los mensajes de error de Amazon Glacier, consulteRespuestas de error.
Ejemplos
Solicitud de ejemplo
El siguiente ejemplo envía una solicitud HTTP PUT con el campo Strategy configurado en BytesPerHour.
PUT /-/policies/data-retrieval HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 { "Policy": { "Rules":[ { "Strategy":"BytesPerHour", "BytesPerHour":10737418240 } ] } }
El siguiente ejemplo envía una solicitud HTTP PUT con el campo Strategy configurado en FreeTier.
PUT /-/policies/data-retrieval HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 { "Policy": { "Rules":[ { "Strategy":"FreeTier" } ] } }
El siguiente ejemplo envía una solicitud HTTP PUT con el campo Strategy configurado en None.
PUT /-/policies/data-retrieval HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2 { "Policy": { "Rules":[ { "Strategy":"None" } ] } }
Respuesta de ejemplo
Si la solicitud se ha realizado correctamente, Amazon Glacier (Amazon Glacier) establece la política y devuelve unHTTP 204 No Content, como se muestra en el siguiente ejemplo.
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