Obtención de política de recuperación de datos (GET policy) - Amazon Glacier
DescripciónSolicitudesRespuestasEjemplosSecciones relacionadas

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.

Obtención de política de recuperación de datos (GET policy)

Descripción

Esta operación devuelve la política de recuperación de datos que se aplica actualmente en la Cuenta de AWS y la región de AWS especificadas en la solicitud GET. 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

Para devolver la política de recuperación de datos actual, envíe una solicitud HTTP GET al URI de la política de recuperación de datos, tal y como se muestra en el siguiente ejemplo de sintaxis.

Sintaxis

GET /AccountId/policies/data-retrieval HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
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

Esta operación no tiene un cuerpo de la solicitud.

Respuestas

Sintaxis

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
{
  "Policy":
    {
      "Rules":[
         {
            "BytesPerHour": Number,
            "Strategy": String	 
         }
       ]
    }
}

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

El cuerpo de la respuesta contiene los siguientes campos JSON.

BytesPerHour

El número máximo de bytes que se pueden recuperar en una hora.

Este campo solo estará presente si el valor del campo Strategy (Estrategia) es BytesPerHour.

Tipo: Número

Reglas

La regla de política. Aunque se trata de un tipo de lista, actualmente solo habrá una regla. Esta regla contendrá un campo Strategy y, opcionalmente, un campo BytesPerHour.

Tipo: Array

Strategy (Estrategia

Tipo de política de recuperación de datos.

Tipo: cadena

Valores válidos: BytesPerHour|FreeTier|None. BytesPerHour equivale a seleccionar Max Retrieval Rate (Velocidad de recuperación máx.) en la consola. FreeTier equivale a seleccionar Free Tier Only (Solo nivel gratis) en la consola. None equivale 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.

Errores

Para obtener información acerca de los mensajes de error y las excepciones de Amazon Glacier, consulte Respuestas de error.

Ejemplos

En el ejemplo siguiente, se muestra cómo obtener una política de recuperación de datos.

Solicitud de ejemplo

En este ejemplo, se envía una solicitud GET al URI de la ubicación de una política.

GET /-/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

Respuesta de ejemplo

En una respuesta correcta, la política de recuperación de datos aparecerá en el cuerpo de la respuesta en formato JSON. 

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: 85
 
{
  "Policy":
    {
      "Rules":[
         {
           "BytesPerHour":10737418240,
           "Strategy":"BytesPerHour"
          }
       ]
    }
}