Obtención de la política de acceso del almacén (GET política-acceso)

Descripción

Esta operación recupera el subrecurso access-policy definido en el almacén. Para obtener más información sobre este subrecurso, consulte Configuración de la política de acceso al almacén (PUT access-policy). Si no hay ninguna política de acceso definida en el almacén, la operación devuelve un error 404 Not found. Para obtener más información sobre las políticas de acceso a almacenes, consulte Políticas de acceso a almacenes.

Solicitudes

Para devolver la política de acceso a almacenes actual, envíe una solicitud HTTP GET al URI del subrecurso access-policy del almacén.

Sintaxis

GET /AccountId/vaults/vaultName/access-policy 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 la Cuenta de AWS propietaria del almacén. 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 usa un ID de cuenta, no incluya ningún guion (“-”) en el ID.

Parámetros de 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

En respuesta, Amazon S3 Glacier (S3 Glacier) devuelve la política de acceso a almacenes en formato JSON en el cuerpo de la respuesta.

Sintaxis

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
				
{
  "Policy": "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.

Auto Scaling

Política de acceso a almacenes en forma de una cadena JSON, donde se utiliza" \" como carácter de escape.

Tipo: String

Errores

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

Ejemplos

En el ejemplo siguiente, se muestra cómo obtener una política de acceso a almacenes.

Solicitud de ejemplo

En este ejemplo, se envía una solicitud GET al URI del subrecurso access-policy del almacén.

GET /-/vaults/examplevault/access-policy 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

Si la solicitud se realizó correctamente, S3 Glacier devuelve la política de acceso a almacenes como una cadena JSON en el cuerpo de la respuesta. La cadena JSON devuelta utiliza "\" como carácter de escape, tal y como se muestra en los ejemplos de Configuración de la política de acceso al almacén (PUT access-policy). Sin embargo, en el ejemplo siguiente, la cadena JSON devuelta aparece sin caracteres de escape.

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: length

{
  "Policy": "
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Sid": "allow-time-based-deletes",
          "Principal": {
            "AWS": "999999999999"
          },
          "Effect": "Allow",
          "Action": "glacier:Delete*",
          "Resource": [
            "arn:aws:glacier:us-west-2:999999999999:vaults/examplevault"
          ],
          "Condition": {
            "DateGreaterThan": {
              "aws:CurrentTime": "2018-12-31T00:00:00Z"
            }
          }
        }
      ]
    }        
  "
}

Secciones relacionadas

• Eliminación de la política de acceso del almacén (DELETE política-acceso)

• Configuración de la política de acceso al almacén (PUT access-policy)

Véase también

Para obtener más información sobre el uso de esta API en uno de los SDK de Amazon específicos de idioma, consulte lo siguiente:

• AWS Command Line Interface