**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.

# Operaciones de recuperación de datos
<a name="data-retrieval-policy-operations"></a>

A continuación, se muestran las operaciones relacionadas con la recuperación de datos disponibles en Amazon Glacier.

**Topics**
+ [Obtención de política de recuperación de datos (GET policy)](api-GetDataRetrievalPolicy.md)
+ [Enumeración de capacidad aprovisionada (GET capacidad-aprovisionada)](api-ListProvisionedCapacity.md)
+ [Adquisición de capacidad aprovisionada (POST capacidad-aprovisionada)](api-PurchaseProvisionedCapacity.md)
+ [Configuración de la política de recuperación de datos (PUT policy)](api-SetDataRetrievalPolicy.md)

# Obtención de política de recuperación de datos (GET policy)
<a name="api-GetDataRetrievalPolicy"></a>

## Descripción
<a name="api-GetDataRetrievalPolicy-description"></a>

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](data-retrieval-policy.md).

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

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

```
1. GET /AccountId/policies/data-retrieval 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 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
<a name="api-GetDataRetrievalPolicy-requests-parameters"></a>

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

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

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

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

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

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

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`\$1`FreeTier`\$1`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](data-retrieval-policy.md).

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

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

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

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

```
1. GET /-/policies/data-retrieval 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-GetDataRetrievalPolicy-example-response"></a>

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

```
 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: 85
 6.  
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.            "BytesPerHour":10737418240,
13.            "Strategy":"BytesPerHour"
14.           }
15.        ]
16.     }
17. }
```

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

 
+ [Configuración de la política de recuperación de datos (PUT policy)](api-SetDataRetrievalPolicy.md)

 
+ [Inicialización de trabajos (POST trabajos)](api-initiate-job-post.md)

# Enumeración de capacidad aprovisionada (GET capacidad-aprovisionada)
<a name="api-ListProvisionedCapacity"></a>

Esta operación muestra las unidades de capacidad aprovisionadas de la Cuenta de AWS especificada. Para obtener más información sobre la capacidad aprovisionada, consulte [Opciones de recuperación de archivos](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options). 

Una unidad de capacidad aprovisionada dura un mes a partir de la fecha y la hora de la compra, que es la fecha de inicio. La unidad se caduca en la fecha de vencimiento, que es exactamente un mes después de la fecha de inicio, al segundo más cercano. 

Si la fecha de inicio es el 31 de un mes, la fecha de vencimiento es el último día del mes siguiente. Por ejemplo, si la fecha de inicio es 31 de agosto, la fecha de vencimiento es 30 de septiembre. Por ejemplo, si la fecha de inicio es 31 de enero, la fecha de vencimiento es 28 de febrero. Puede ver esta funcionalidad en la [Respuesta de ejemplo](#api-ListProvisionedCapacity-example1-response).

## Sintaxis de la solicitud
<a name="api-ListProvisionedCapacity-RequestSyntax"></a>

Para publicar la capacidad de recuperación aprovisionada de una cuenta, envíe una solicitud HTTP GET al URI de la capacidad aprovisionada, tal y como se muestra en el siguiente ejemplo de sintaxis.

```
1. GET /AccountId/provisioned-capacity 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. 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 solo `-` '' (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
<a name="api-ListProvisionedCapacity-RequestParameters"></a>

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

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

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

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

Si la operación se realiza correctamente, el servicio devuelve una respuesta HTTP `200 OK`.

### Sintaxis de la respuesta
<a name="api-ListProvisionedCapacity-ResponseSyntax"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length
{
   "ProvisionedCapacityList": 
      {
         "CapacityId" : "string",
         "StartDate" : "string"
         "ExpirationDate" : "string"
      }
}
```

### Encabezados de respuesta
<a name="api-ListProvisionedCapacity-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-ListProvisionedCapacity-body"></a>

El cuerpo de la respuesta contiene los siguientes campos JSON.

**CapacityId**  <a name="Glacier-ListProvisionedCapacity-response"></a>
ID que identifica la unidad de capacidad aprovisionada.  
 *Tipo*: cadena.

**StartDate**  
Fecha en que se adquirió la unidad de capacidad aprovisionada, en formato UTC (horario universal coordinado).  
*Tipo*: cadena. Una representación de cadena con el formato de fecha ISO 8601; por ejemplo, `2013-03-20T17:03:43.221Z`.

**ExpirationDate**  
Fecha en que caduca la unidad de capacidad aprovisionada, en formato UTC (horario universal coordinado).  
*Tipo*: cadena. Una representación de cadena con el formato de fecha ISO 8601; por ejemplo, `2013-03-20T17:03:43.221Z`.

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

En el siguiente ejemplo, se muestran las unidades de capacidad aprovisionadas de una cuenta.

### Solicitud de ejemplo
<a name="api-ListProvisionedCapacity-example1-request"></a>

En este ejemplo, se envía una solicitud GET para recuperar una lista con las unidades de capacidad aprovisionadas de una determinada cuenta.

```
1. GET /123456789012/priority-capacity 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-ListProvisionedCapacity-example1-response"></a>

Si la solicitud se ha realizado correctamente, Amazon Glacier (Amazon Glacier) devuelve una respuesta `HTTP 200 OK` con una lista de las unidades de capacidad aprovisionadas en la cuenta, tal y como se muestra en el siguiente ejemplo.

 La unidad de capacidad aprovisionada que aparece primero es un ejemplo de unidad con fecha de inicio del 31 de enero de 2017 y fecha de vencimiento del 28 de febrero de 2017. Como se ha explicado previamente, si la fecha de inicio es el 31 de un mes, la fecha de vencimiento es el último día del mes siguiente.

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:02:00 GMT
 4. Content-Type: application/json
 5. Content-Length: length
 6. 
 7. {
 8.    "ProvisionedCapacityList",
 9.       {
10.          "CapacityId": "zSaq7NzHFQDANTfQkDen4V7z",
11.          "StartDate": "2017-01-31T14:26:33.031Z",
12.          "ExpirationDate": "2017-02-28T14:26:33.000Z",
13.       },
14.       {
15.          "CapacityId": "yXaq7NzHFQNADTfQkDen4V7z",
16.          "StartDate": "2016-12-13T20:11:51.095Z"",
17.          "ExpirationDate": "2017-01-13T20:11:51.000Z" ",
18.       },
19.       ...
20. }
```

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

 
+ [Adquisición de capacidad aprovisionada (POST capacidad-aprovisionada)](api-PurchaseProvisionedCapacity.md)

# Adquisición de capacidad aprovisionada (POST capacidad-aprovisionada)
<a name="api-PurchaseProvisionedCapacity"></a>

Esta operación adquiere una unidad de capacidad aprovisionada para una Cuenta de AWS. 

Una unidad de capacidad aprovisionada dura un mes a partir de la fecha y la hora de la compra, que es la fecha de inicio. La unidad se caduca en la fecha de vencimiento, que es exactamente un mes después de la fecha de inicio, al segundo más cercano. 

Si la fecha de inicio es el 31 de un mes, la fecha de vencimiento es el último día del mes siguiente. Por ejemplo, si la fecha de inicio es 31 de agosto, la fecha de vencimiento es 30 de septiembre. Por ejemplo, si la fecha de inicio es 31 de enero, la fecha de vencimiento es 28 de febrero.

La capacidad aprovisionada garantiza que la capacidad de recuperación para las recuperaciones rápidas esté disponible cuando la necesite. Cada unidad de capacidad garantiza que se puedan realizar al menos tres recuperaciones rápidas cada cinco minutos y proporciona hasta un 150% de rendimiento MB/s de recuperación. Para obtener más información sobre la capacidad aprovisionada, consulte [Opciones de recuperación de archivos](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options). 

**nota**  
Hay un límite de dos unidades de capacidad aprovisionadas por unidad. Cuenta de AWS

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

Para comprar una unidad de capacidad aprovisionada y Cuenta de AWS enviar una `POST` solicitud HTTP al URI de capacidad aprovisionada.

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

```
1. POST /AccountId/provisioned-capacity HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Length: Length
6. x-amz-glacier-version: 2012-06-01
```

 

**nota**  
El `AccountId` valor es el ID. Cuenta de AWS 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 solo `-` '' (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
<a name="api-PurchaseProvisionedCapacity-requestParameters"></a>

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

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

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

Si la solicitud de la operación se realiza correctamente, el servicio devuelve una respuesta HTTP `201 Created`.

### Sintaxis
<a name="api-PurchaseProvisionedCapacity-response-syntax"></a>

```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-capacity-id: CapacityId
```

### Encabezados de respuesta
<a name="api-PurchaseProvisionedCapacity-responses-headers"></a>

Una respuesta correcta incluye los siguientes encabezados de respuesta, además de los encabezados de respuesta comunes a todas las operaciones. Para obtener más información acerca de los encabezados de respuesta comunes, consulte [Encabezados de respuesta comunes](api-common-response-headers.md).


|  Name  |  Description (Descripción) | 
| --- | --- | 
|  `x-amz-capacity-id`   |  ID que identifica la unidad de capacidad aprovisionada. Tipo: cadena  | 

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

Esta operación no devuelve ningún cuerpo de respuesta.

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

Esta operación incluye los siguientes errores, además de los posibles errores comunes a todas las operaciones de Amazon Glacier. Para obtener información sobre los errores de Amazon Glacier y una lista de códigos de error, consulte [Respuestas de error](api-error-responses.md).


| Código | Description (Descripción) | Código de estado HTTP | Tipo | 
| --- | --- | --- | --- | 
| LimitExceededException | Este valor se devuelve si la solicitud proporcionada sobrepasa el límite de unidades de capacidad aprovisionadas de la cuenta.  | 400 Bad Request | Cliente | 

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

En el siguiente ejemplo, se adquiere capacidad aprovisionada para una cuenta.

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

En el siguiente ejemplo, se envía una solicitud HTTP POST para adquirir una unidad de capacidad aprovisionada. 

```
1. POST /123456789012/provisioned-capacity HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
5. Content-Length: length
6. x-amz-glacier-version: 2012-06-01
```

### Respuesta de ejemplo
<a name="api-PurchaseProvisionedCapacity-example-response"></a>

Si la solicitud se realizó correctamente, Amazon Glacier (Amazon Glacier) devuelve una respuesta `HTTP 201 Created`, tal y como se muestra en el ejemplo siguiente.

```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
4. x-amz-capacity-id: zSaq7NzHFQDANTfQkDen4V7z
```

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

 
+ [Enumeración de capacidad aprovisionada (GET capacidad-aprovisionada)](api-ListProvisionedCapacity.md)

# Configuración de la política de recuperación de datos (PUT policy)
<a name="api-SetDataRetrievalPolicy"></a>

## Descripción
<a name="api-SetDataRetrievalPolicy-description"></a>

Esta operación establece y aplica una política de recuperación de datos en la región de AWS especificada en la solicitud `PUT`. Puede configurar una política por región de AWS para una 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](data-retrieval-policy.md). 

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

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

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.

```
 1. PUT /AccountId/policies/data-retrieval HTTP/1.1
 2. Host: glacier.Region.amazonaws.com
 3. Date: Date
 4. Authorization: SignatureValue
 5. Content-Length: Length
 6. x-amz-glacier-version: 2012-06-01
 7. 			
 8. {
 9.   "Policy":
10.     {
11.       "Rules":[
12.          {
13.              "Strategy": String,
14.              "BytesPerHour": Number          
15.          }
16.        ]
17.     }
18. }
```

 

**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
<a name="api-SetDataRetrievalPolicy-requests-parameters"></a>

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

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

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 en `BytesPerHour` y 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. Esta regla contendrá un campo Strategy y, opcionalmente, un campo BytesPerHour.  
*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`\$1`FreeTier`\$1`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](data-retrieval-policy.md).

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

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

```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```

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

Esta operación no devuelve ningún cuerpo de respuesta.

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

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

El siguiente ejemplo envía una solicitud HTTP PUT con el campo Strategy configurado en `BytesPerHour`. 

```
 1. PUT /-/policies/data-retrieval 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
 6. 			
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.              "Strategy":"BytesPerHour",
13.              "BytesPerHour":10737418240       
14.           }
15.        ]
16.     }
17. }
```

El siguiente ejemplo envía una solicitud HTTP PUT con el campo Strategy configurado en `FreeTier`. 

```
 1. PUT /-/policies/data-retrieval 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
 6. 			
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.              "Strategy":"FreeTier"   
13.           }
14.        ]
15.     }
16. }
```

El siguiente ejemplo envía una solicitud HTTP PUT con el campo Strategy configurado en `None`. 

```
 1. PUT /-/policies/data-retrieval 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
 6. 			
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.              "Strategy":"None"   
13.           }
14.        ]
15.     }
16. }
```

### Respuesta de ejemplo
<a name="api-SetDataRetrievalPolicy-example-response"></a>

Si la solicitud se realizó correctamente, Amazon Glacier (Amazon Glacier) establece la política y devuelve `HTTP 204 No Content`, tal y como se muestra en el ejemplo siguiente.

```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
```

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

 
+ [Obtención de política de recuperación de datos (GET policy)](api-GetDataRetrievalPolicy.md)

 
+ [Inicialización de trabajos (POST trabajos)](api-initiate-job-post.md)