**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](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (servicio original independiente basado en bóveda) ya no acepta nuevos clientes. 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 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](https://aws.amazon.com/s3/storage-classes/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 [AWS Guía de soluciones para la transferencia de datos de los almacenes de Amazon Glacier a las clases de almacenamiento de Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).

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.

# Obtención de la política de acceso del almacén (GET política-acceso)
<a name="api-GetVaultAccessPolicy"></a>

## Description (Descripción)
<a name="api-GetVaultAccessPolicy-description"></a>

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)](api-SetVaultAccessPolicy.md). 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](vault-access-policy.md).

## Solicitudes
<a name="api-GetVaultAccessPolicy-requests"></a>

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
<a name="api-GetVaultAccessPolicy-requests-syntax"></a>

```
1. GET /AccountId/vaults/vaultName/access-policy HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```

 

**nota**  
El `AccountId` valor es el Cuenta de AWS identificador de la cuenta propietaria del almacén. 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 usa un ID de cuenta, no incluya ningún guion (“-”) en el ID.

### Parámetros de la solicitud
<a name="api-GetVaultAccessPolicy-requests-parameters"></a>

Esta operación no usa parámetros de solicitud.

### Encabezados de solicitud
<a name="api-GetVaultAccessPolicy-requests-headers"></a>

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](api-common-request-headers.md).

### Cuerpo de la solicitud
<a name="api-GetVaultAccessPolicy-requests-elements"></a>

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

## Respuestas
<a name="api-GetVaultAccessPolicy-responses"></a>

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

### Sintaxis
<a name="api-GetVaultAccessPolicy-responses-syntax"></a>

```
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
<a name="api-GetVaultAccessPolicy-responses-headers"></a>

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](api-common-response-headers.md).

### Cuerpo de respuesta
<a name="api-GetVaultAccessPolicy-responses-elements"></a>

El cuerpo de la respuesta contiene los siguientes campos JSON.

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

### Errores
<a name="api-GetVaultAccessPolicy-responses-errors"></a>

Para obtener información acerca de los mensajes de error y las excepciones de Amazon Glacier, consulte [Respuestas de error](api-error-responses.md).

## Ejemplos
<a name="api-GetVaultAccessPolicy-examples"></a>

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

### Solicitud de ejemplo
<a name="api-GetVaultAccessPolicy-example-request"></a>

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

```
1. GET /-/vaults/examplevault/access-policy HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. 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
<a name="api-GetVaultAccessPolicy-example-response"></a>

Si la solicitud se realizó correctamente, Amazon Glacier devuelve la política de acceso a almacenes como una cadena JSON en el cuerpo de la respuesta. La cadena JSON devuelta utiliza "\$1" 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)](api-SetVaultAccessPolicy.md). Sin embargo, en el ejemplo siguiente, la cadena JSON devuelta aparece sin caracteres de escape. 

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:00:00 GMT
 4. Content-Type: application/json
 5. Content-Length: length
 6. 
 7. {
 8.   "Policy": "
 9.     {
10.       "Version": "2012-10-17",		 	 	 
11.       "Statement": [
12.         {
13.           "Sid": "allow-time-based-deletes",
14.           "Principal": {
15.             "AWS": "999999999999"
16.           },
17.           "Effect": "Allow",
18.           "Action": "glacier:Delete*",
19.           "Resource": [
20.             "arn:aws:glacier:us-west-2:999999999999:vaults/examplevault"
21.           ],
22.           "Condition": {
23.             "DateGreaterThan": {
24.               "aws:CurrentTime": "2018-12-31T00:00:00Z"
25.             }
26.           }
27.         }
28.       ]
29.     }        
30.   "
31. }
```

## Secciones relacionadas
<a name="related-sections-GetVaultAccessPolicy"></a>

 
+ [Eliminación de la política de acceso del almacén (DELETE política-acceso)](api-DeleteVaultAccessPolicy.md)

 
+ [Configuración de la política de acceso al almacén (PUT access-policy)](api-SetVaultAccessPolicy.md)

## Véase también
<a name="api-GetVaultAccessPolicy_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos de Amazon SDKs, consulta lo siguiente:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/get-vault-access-policy.html)