

 **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 del bloqueo del almacén (GET política-bloqueo)
<a name="api-GetVaultLock"></a>

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

Esta operación recupera los siguientes atributos del subrecurso `lock-policy` establecido en el almacén especificado: 
+ La política de bloqueo de almacenes definida en el almacén.
+ El estado del bloqueo de almacenes, que puede ser `InProgess` o `Locked`.
+ Fecha de vencimiento del ID del bloqueo. El ID del bloqueo se utiliza para completar el proceso de bloqueo del almacén.
+ Momento en que se inició el bloque de almacenes y adoptó el estado `InProgress`.

Un bloqueo de almacenes adopta el estado `InProgress` llamando a [Inicio del bloqueo de almacenes (POST lock-policy)](api-InitiateVaultLock.md). Un bloqueo de almacenes adopta el estado `Locked` llamando a [Realización del bloqueo de almacenes (POST lockId)](api-CompleteVaultLock.md). Para detener el proceso de bloqueo, llame a [Anulación del bloqueo de almacenes (DELETE lock-policy)](api-AbortVaultLock.md). Para obtener más información acerca del proceso de bloqueo de almacenes, consulte [Bloqueo del almacén de Amazon Glacier](vault-lock.md).

Si no hay ninguna política de bloqueo de almacenes 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 bloqueo de almacenes, consulte [Políticas de bloqueo de almacenes](vault-lock-policy.md).

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

Para devolver la política de bloqueo de almacenes actual y otros atributos, envíe una solicitud HTTP `GET` al URI del subrecurso `lock-policy` del almacén, tal y como se muestra en el siguiente ejemplo de sintaxis.

### Sintaxis
<a name="api-GetVaultLock-requests-syntax"></a>

```
1. GET /AccountId/vaults/vaultName/lock-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-GetVaultLock-requests-parameters"></a>

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

### Encabezados de solicitud
<a name="api-GetVaultLock-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-GetVaultLock-requests-elements"></a>

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

## Respuestas
<a name="api-GetVaultLock-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-GetVaultLock-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",
  "State": "string",
  "ExpirationDate": "string",
  "CreationDate":"string"
}
```

### Encabezados de respuesta
<a name="api-GetVaultLock-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-GetVaultLock-responses-elements"></a>

El cuerpo de la respuesta contiene los siguientes campos JSON.

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

 **Estado**   
Estado del bloqueo del almacén.  
 Tipo: cadena  
 Valores válidos: `InProgress``|Locked`

 **ExpirationDate**   
Fecha y hora en formato UTC en que vence el ID de bloqueo. Este valor puede ser `null` si el bloque del almacén tiene el estado `Locked`.  
*Tipo*: una representación de cadena con el formato de fecha ISO 8601; por ejemplo, `2013-03-20T17:03:43.221Z`.

 **CreationDate**   
Fecha y hora en formato UTC en que el bloqueo de almacenes adoptó el estado `InProgress`.  
*Tipo*: una representación de cadena con el formato de fecha ISO 8601; por ejemplo, `2013-03-20T17:03:43.221Z`.

### Errores
<a name="api-GetVaultLock-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-GetVaultLock-examples"></a>

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

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

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

```
1. GET /-/vaults/examplevault/lock-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-GetVaultLock-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 la solicitud de ejemplo [Inicio del bloqueo de almacenes (POST lock-policy)](api-InitiateVaultLock.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": "Define-vault-lock",
14.           "Principal": {
15.             "AWS": "arn:aws:iam::999999999999:root"
16.           },
17.           "Effect": "Deny",
18.           "Action": "glacier:DeleteArchive",
19.           "Resource": [
20.             "arn:aws:glacier:us-west-2:999999999999:vaults/examplevault"
21.           ],
22.           "Condition": {
23.             "NumericLessThanEquals": {
24.               "glacier:ArchiveAgeInDays": "365"
25.             }
26.           }
27.         }
28.       ]
29.     }
30.   ",
31.   "State": "InProgress",
32.   "ExpirationDate": "exampledate",
33.   "CreationDate": "exampledate"  
34. }
```

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

 
+ [Anulación del bloqueo de almacenes (DELETE lock-policy)](api-AbortVaultLock.md)

 
+ [Realización del bloqueo de almacenes (POST lockId)](api-CompleteVaultLock.md)

 
+ [Inicio del bloqueo de almacenes (POST lock-policy)](api-InitiateVaultLock.md)

## Véase también
<a name="api-GetVaultLock_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-lock.html) 