**Esta página destina-se somente a clientes atuais do serviço Amazon Glacier que usam cofres e a API REST original de 2012.**

Se você estiver procurando soluções de armazenamento de arquivos do Amazon Glacier, recomendamos usar as classes de armazenamento do Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para saber mais sobre essas opções de armazenamento, consulte [Classes de armazenamento do Amazon Glacier](https://aws.amazon.com/s3/storage-classes/glacier/).

O Amazon Glacier (serviço autônomo original baseado em cofre) não está mais aceitando novos clientes. O Amazon Glacier é um serviço independente APIs que armazena dados em cofres e é diferente das classes de armazenamento Amazon S3 e Amazon S3 Glacier. Seus dados existentes permanecerão seguros e acessíveis no Amazon Glacier indefinidamente. Nenhuma migração é necessária. Para armazenamento de arquivamento de baixo custo e longo prazo, AWS recomenda as classes de armazenamento [Amazon S3 Glacier](https://aws.amazon.com/s3/storage-classes/glacier/), que oferecem uma experiência superior ao cliente com APIs base em buckets S3, disponibilidade Região da AWS total, custos mais baixos e integração de serviços. AWS Se você quiser recursos aprimorados, considere migrar para as classes de armazenamento do Amazon S3 Glacier usando nossas [Orientações de soluções da AWS para transferir dados dos cofres do Amazon Glacier para as classes de armazenamento do Amazon S3 Glacier](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Operações de recuperação de dados
<a name="data-retrieval-policy-operations"></a>

Estas são as operações relacionadas à recuperação de dados disponíveis no Amazon Glacier.

**Topics**
+ [Política de recuperação para obter dados (GET policy)](api-GetDataRetrievalPolicy.md)
+ [List Provisioned Capacity (GET provisioned-capacity)](api-ListProvisionedCapacity.md)
+ [Purchase Provisioned Capacity (POST provisioned-capacity)](api-PurchaseProvisionedCapacity.md)
+ [Set Data Retrieval Policy (PUT policy)](api-SetDataRetrievalPolicy.md)

# Política de recuperação para obter dados (GET policy)
<a name="api-GetDataRetrievalPolicy"></a>

## Descrição
<a name="api-GetDataRetrievalPolicy-description"></a>

Esta operação retorna a política de recuperação de dados atual da conta da Conta da AWS e da região da AWS especificada na solicitação `GET`. Para obter mais informações sobre políticas de recuperação de dados, consulte [Políticas de recuperação de dados do Amazon Glacier](data-retrieval-policy.md).

## Solicitações
<a name="api-GetDataRetrievalPolicy-requests"></a>

Para retornar a política de recuperação de dados atual, envie uma solicitação `GET` HTTP para o URI da política de recuperação de dados conforme mostrado no exemplo de sintaxe a seguir.

### Sintaxe
<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**  
O valor de `AccountId` é o ID da Conta da AWS. Esse valor deve corresponder ao ID de Conta da AWS associado às credenciais usadas para assinar a solicitação. Você pode especificar um ID da Conta da AWS ou, de opcionalmente, um '`-`' (hífen) único. Nesse caso, o Amazon Glacier usa o ID de Conta da AWS associado às credenciais usadas para assinar a solicitação. Se você especificar o ID da conta, não inclua nenhum hífen ('-') no ID.

### Parâmetros da solicitação
<a name="api-GetDataRetrievalPolicy-requests-parameters"></a>

Essa operação não usa parâmetros de solicitação.

### Cabeçalhos de solicitação
<a name="api-GetDataRetrievalPolicy-requests-headers"></a>

Essa operação usa somente os cabeçalhos de solicitação que são comuns a todas as operações. Para informações sobre os cabeçalhos de solicitação comuns, consulte [Cabeçalhos de solicitação comuns](api-common-request-headers.md).

### Corpo da Solicitação
<a name="api-GetDataRetrievalPolicy-requests-elements"></a>

Essa operação não tem um corpo de solicitação.

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

### Sintaxe
<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	 
         }
       ]
    }
}
```

### Cabeçalhos de resposta
<a name="api-GetDataRetrievalPolicy-responses-headers"></a>

Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte [Cabeçalhos de resposta comuns](api-common-response-headers.md).

### Corpo da resposta
<a name="api-GetDataRetrievalPolicy-responses-elements"></a>

O corpo da resposta contém os seguintes campos JSON.

 

**BytesPerHour**  
O número máximo de bytes que podem ser recuperados em uma hora.  
Este campo estará presente somente se o valor do campo **Strategy** for `BytesPerHour`.   
*Tipo*: número

**Regras**  
A regra da política. Embora esse seja um tipo de lista, atualmente deve haver somente uma regra, que contém um campo Strategy e, como opção, um campo BytesPerHour.  
*Tipo*: matriz

**Strategy**  
O tipo de política de recuperação de dados.  
*Tipo:* string  
Valores válidos: `BytesPerHour`\$1`FreeTier`\$1`None`. `BytesPerHour` é equivalente a selecionar **Max Retrieval Rate (Taxa de recuperação máxima)** no console. `FreeTier` é equivalente a selecionar **Somente nível gratuito** no console. `None` é equivalente a selecionar **No Retrieval Policy (Nenhuma política de recuperação)** no console. Para obter mais informações sobre como selecionar políticas de recuperação de dados no console, consulte [Políticas de recuperação de dados do Amazon Glacier](data-retrieval-policy.md).

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

Para obter informações sobre exceções e mensagens de erro do Amazon Glacier, consulte [Respostas de erro](api-error-responses.md).

## Exemplos
<a name="api-GetDataRetrievalPolicy-examples"></a>

O exemplo a seguir demonstra como obter uma política de recuperação de dados.

### Exemplo de solicitação
<a name="api-GetDataRetrievalPolicy-example-request"></a>

Neste exemplo, uma solicitação `GET` é enviada para o URI do local de uma 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
```

### Exemplo de resposta
<a name="api-GetDataRetrievalPolicy-example-response"></a>

Uma resposta bem-sucedida mostra a política de recuperação de dados no corpo da resposta em 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. }
```

## Seções relacionadas
<a name="related-sections-GetDataRetrievalPolicy"></a>

 
+ [Set Data Retrieval Policy (PUT policy)](api-SetDataRetrievalPolicy.md)

 
+ [Initiate Job (trabalhos POST)](api-initiate-job-post.md)

# List Provisioned Capacity (GET provisioned-capacity)
<a name="api-ListProvisionedCapacity"></a>

Esta operação lista a capacidade provisionada para a Conta da AWS especificada. Para obter mais informações sobre a capacidade provisionada, consulte [Opções de recuperação de arquivos](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options). 

Uma unidade de capacidade provisionada dura um mês a partir da data e hora da compra, que é a data de início. A unidade expira na data de expiração, que é exatamente um mês depois da data de início até o segundo mais próximo. 

Se a data de início é dia 31 de um mês, a data de expiração será o último dia do mês seguinte. Por exemplo, se a data de início é dia 31 de agosto, a data de expiração será dia 30 de setembro. Se a data de início é dia 31 de janeiro, a data de expiração será dia 28 de fevereiro. Você pode consultar essa funcionalidade em [Exemplo de resposta](#api-ListProvisionedCapacity-example1-response).

## Sintaxe da solicitação
<a name="api-ListProvisionedCapacity-RequestSyntax"></a>

Para listar a capacidade de recuperação provisionada para uma conta, envie uma solicitação GET HTTP para o URI de capacidade provisionado conforme mostrado no exemplo de sintaxe a seguir.

```
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**  
O `AccountId` valor é o Conta da AWS ID. Esse valor deve corresponder ao Conta da AWS ID associado às credenciais usadas para assinar a solicitação. Você pode especificar um Conta da AWS ID ou, opcionalmente, um único '`-`' (hífen). Nesse caso, o Amazon Glacier usa Conta da AWS o ID associado às credenciais usadas para assinar a solicitação. Se você especificar o ID da conta, não inclua nenhum hífen ('-') no ID.

## Parâmetros da solicitação
<a name="api-ListProvisionedCapacity-RequestParameters"></a>

Essa operação não usa parâmetros de solicitação.

## Cabeçalhos de solicitação
<a name="api-ListProvisionedCapacity-requests-headers"></a>

Essa operação usa somente os cabeçalhos de solicitação que são comuns a todas as operações. Para informações sobre os cabeçalhos de solicitação comuns, consulte [Cabeçalhos de solicitação comuns](api-common-request-headers.md).

## Corpo da Solicitação
<a name="api-ListProvisionedCapacity-requests-elements"></a>

Essa operação não tem um corpo de solicitação.

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

Se a operação for bem-sucedida, o serviço reenviará uma resposta `200 OK` HTTP.

### Sintaxe da resposta
<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"
      }
}
```

### Cabeçalhos de resposta
<a name="api-ListProvisionedCapacity-headers"></a>

Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte [Cabeçalhos de resposta comuns](api-common-response-headers.md).

### Corpo da resposta
<a name="api-ListProvisionedCapacity-body"></a>

O corpo da resposta contém os seguintes campos JSON.

**CapacityId**  <a name="Glacier-ListProvisionedCapacity-response"></a>
O ID que identifica a unidade de capacidade provisionada.  
 *Tipo*: string

**StartDate**  
A data em que a unidade de capacidade provisionada foi comprada, em Coordinated Universal Time (UTC – Tempo universal coordenado).  
*Tipo*: string Uma representação de string no formato de data ISO 8601, por exemplo `2013-03-20T17:03:43.221Z`.

**ExpirationDate**  
A data em que a unidade de capacidade provisionada expira, em UTC.  
*Tipo*: string Uma representação de string no formato de data ISO 8601, por exemplo `2013-03-20T17:03:43.221Z`.

### Erros
<a name="api-ListProvisionedCapacity-errors"></a>

Para obter informações sobre exceções e mensagens de erro do Amazon Glacier, consulte [Respostas de erro](api-error-responses.md).

## Exemplos
<a name="api-ListProvisionedCapacity-examples"></a>

O exemplo a seguir lista as unidades de capacidade provisionada para uma conta.

### Exemplo de solicitação
<a name="api-ListProvisionedCapacity-example1-request"></a>

Neste exemplo, uma solicitação GET é enviada para recuperar uma lista das unidades de capacidade provisionada para a conta especificada.

```
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
```

### Exemplo de resposta
<a name="api-ListProvisionedCapacity-example1-response"></a>

Se a solicitação for bem-sucedida, o Amazon Glacier retornará um `HTTP 200 OK` com uma lista de unidades de capacidade provisionada para a conta, conforme mostrado no exemplo a seguir.

 A unidade de capacidade provisionada listada primeiro é um exemplo de unidade com data de início no dia 31 de janeiro de 2017 e data de expiração no dia 28 de fevereiro de 2017. Conforme mencionado anteriormente, se a data de início é dia 31 de um mês, a data de expiração será o último dia do mês seguinte.

```
 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. }
```

## Seções relacionadas
<a name="api-ListProvisionedCapacity-related-sections"></a>

 
+ [Purchase Provisioned Capacity (POST provisioned-capacity)](api-PurchaseProvisionedCapacity.md)

# Purchase Provisioned Capacity (POST provisioned-capacity)
<a name="api-PurchaseProvisionedCapacity"></a>

Esta operação adquire uma unidade de capacidade provisionada para uma Conta da AWS. 

Uma unidade de capacidade provisionada dura um mês a partir da data e hora da compra, que é a data de início. A unidade expira na data de expiração, que é exatamente um mês depois da data de início até o segundo mais próximo. 

Se a data de início é dia 31 de um mês, a data de expiração será o último dia do mês seguinte. Por exemplo, se a data de início é dia 31 de agosto, a data de expiração será dia 30 de setembro. Se a data de início é dia 31 de janeiro, a data de expiração será dia 28 de fevereiro.

A capacidade provisionada ajuda a garantir que sua capacidade de recuperação para recuperações expressas esteja disponível quando você precisar dela. Cada unidade de capacidade garante que pelo menos três recuperações rápidas possam ser realizadas a cada cinco minutos e fornece até 150 MB/s de taxa de transferência de recuperação. Para obter mais informações sobre a capacidade provisionada, consulte [Opções de recuperação de arquivos](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options). 

**nota**  
Há um limite de duas unidades de capacidade provisionada por. Conta da AWS

## Solicitações
<a name="api-PurchaseProvisionedCapacity-requests"></a>

Para comprar uma unidade de capacidade provisionada para Conta da AWS enviar uma `POST` solicitação HTTP para o URI de capacidade provisionada.

### Sintaxe
<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**  
O `AccountId` valor é o Conta da AWS ID. Esse valor deve corresponder ao Conta da AWS ID associado às credenciais usadas para assinar a solicitação. Você pode especificar um Conta da AWS ID ou, opcionalmente, um único '`-`' (hífen). Nesse caso, o Amazon Glacier usa Conta da AWS o ID associado às credenciais usadas para assinar a solicitação. Se você especificar o ID da conta, não inclua nenhum hífen ('-') no ID.

### Parâmetros da solicitação
<a name="api-PurchaseProvisionedCapacity-requestParameters"></a>

#### Cabeçalhos de solicitação
<a name="api-PurchaseProvisionedCapacity-requests-headers"></a>

Essa operação usa somente os cabeçalhos de solicitação que são comuns a todas as operações. Para informações sobre os cabeçalhos de solicitação comuns, consulte [Cabeçalhos de solicitação comuns](api-common-request-headers.md).

#### Corpo da Solicitação
<a name="api-PurchaseProvisionedCapacity-requests-elements"></a>

Essa operação não tem um corpo de solicitação.

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

Se a solicitação de operação for bem-sucedida, o serviço retornará uma resposta `201 Created` HTTP.

### Sintaxe
<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
```

### Cabeçalhos de resposta
<a name="api-PurchaseProvisionedCapacity-responses-headers"></a>

Uma resposta bem-sucedida inclui os seguintes cabeçalhos de resposta, além dos cabeçalhos de resposta que são comuns a todas as operações. Para mais informações sobre os cabeçalhos de resposta comuns, consulte [Cabeçalhos de resposta comuns](api-common-response-headers.md).


|  Name (Nome)  |  Description | 
| --- | --- | 
|  `x-amz-capacity-id`   |  O ID que identifica a unidade de capacidade provisionada. Tipo: string  | 

### Corpo da resposta
<a name="api-PurchaseProvisionedCapacity-responses-elements"></a>

Essa operação não retorna um corpo de resposta.

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

Essa operação inclui os seguintes erros, além dos possíveis erros comuns a todas as operações do Amazon Glacier. Para obter informações sobre erros do Amazon Glacier e uma lista de códigos de erro, consulte [Respostas de erro](api-error-responses.md).


| Código | Description | Código de status HTTP | Tipo | 
| --- | --- | --- | --- | 
| LimitExceededException | Retornado se a determinada solicitação excederia o limite da conta de unidades de capacidade provisionada.  | 400 Bad Request | Cliente | 

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

O exemplo a seguir compra a capacidade provisionada para uma conta.

### Exemplo de solicitação
<a name="api-PurchaseProvisionedCapacity-example-request"></a>

O exemplo a seguir envia uma solicitação POST HTTP para comprar uma unidade de capacidade provisionada. 

```
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
```

### Exemplo de resposta
<a name="api-PurchaseProvisionedCapacity-example-response"></a>

Se a solicitação for bem-sucedida, o Amazon Glacier retornará uma resposta `HTTP 201 Created`, conforme mostrado no exemplo a seguir.

```
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
```

## Seções relacionadas
<a name="api-PurchaseProvisionedCapacity-related-sections"></a>

 
+ [List Provisioned Capacity (GET provisioned-capacity)](api-ListProvisionedCapacity.md)

# Set Data Retrieval Policy (PUT policy)
<a name="api-SetDataRetrievalPolicy"></a>

## Descrição
<a name="api-SetDataRetrievalPolicy-description"></a>

Esta operação define e impõe uma política de recuperação de dados na região da AWS especificada na solicitação `PUT`. Você pode definir uma política por região da AWS para uma Conta da AWS. A política é imposta após alguns minutos de uma operação `PUT` bem-sucedida. 

 A operação set policy não afeta trabalhos de recuperação que estavam em andamento antes da imposição da política. Para obter mais informações sobre políticas de recuperação de dados, consulte [Políticas de recuperação de dados do Amazon Glacier](data-retrieval-policy.md). 

## Solicitações
<a name="api-SetDataRetrievalPolicy-requests"></a>

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

Para definir uma política de recuperação de dados, envie uma solicitação HTTP PUT para o URI da política de recuperação de dados conforme mostrado no exemplo de sintaxe a seguir.

```
 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**  
O valor de `AccountId` é o ID da Conta da AWS. Esse valor deve corresponder ao ID de Conta da AWS associado às credenciais usadas para assinar a solicitação. Você pode especificar um ID da Conta da AWS ou, de opcionalmente, um '`-`' (hífen) único. Nesse caso, o Amazon Glacier usa o ID de Conta da AWS associado às credenciais usadas para assinar a solicitação. Se você especificar o ID da conta, não inclua nenhum hífen ('-') no ID.

### Parâmetros da solicitação
<a name="api-SetDataRetrievalPolicy-requests-parameters"></a>

Essa operação não usa parâmetros de solicitação.

### Cabeçalhos de solicitação
<a name="api-SetDataRetrievalPolicy-requests-headers"></a>

Essa operação usa somente os cabeçalhos de solicitação que são comuns a todas as operações. Para informações sobre os cabeçalhos de solicitação comuns, consulte [Cabeçalhos de solicitação comuns](api-common-request-headers.md).

### Corpo da Solicitação
<a name="api-SetDataRetrievalPolicy-requests-elements"></a>

O corpo da solicitação contém os campos JSON a seguir.

 

**BytesPerHour**  
O número máximo de bytes que podem ser recuperados em uma hora.  
Este campo somente será obrigatório se o valor do campo Strategy for `BytesPerHour`. A operação PUT será rejeitada se o campo Strategy não for definido como `BytesPerHour` e você definir esse campo.  
*Tipo*: número  
*Obrigatório*: sim, se o campo Strategy for definido como `BytesPerHour`. Do contrário, não.  
*Valores válidos*: valor do inteiro mínimo de 1. Valor do inteiro máximo de 2^63 - 1 inclusive.

**Regras**  
A regra da política. Embora esse seja um tipo de lista, atualmente deve haver somente uma regra, que contém um campo Strategy e, como opção, um campo BytesPerHour.  
*Tipo*: matriz  
*Obrigatório*: Sim

**Strategy**  
O tipo de política de recuperação de dados a ser definido.  
*Tipo:* string  
*Obrigatório*: Sim  
Valores válidos: `BytesPerHour`\$1`FreeTier`\$1`None`. `BytesPerHour` é equivalente a selecionar **Max Retrieval Rate (Taxa de recuperação máxima)** no console. `FreeTier` é equivalente a selecionar **Somente nível gratuito** no console. `None` é equivalente a selecionar **No Retrieval Policy (Nenhuma política de recuperação)** no console. Para obter mais informações sobre como selecionar políticas de recuperação de dados no console, consulte [Políticas de recuperação de dados do Amazon Glacier](data-retrieval-policy.md).

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

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

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

### Cabeçalhos de resposta
<a name="api-SetDataRetrievalPolicy-responses-headers"></a>

Essa operação usa somente os cabeçalhos de resposta que são comuns a maioria das respostas. Para informações sobre os cabeçalhos de resposta comuns, consulte [Cabeçalhos de resposta comuns](api-common-response-headers.md).

### Corpo da resposta
<a name="api-SetDataRetrievalPolicy-responses-elements"></a>

Essa operação não retorna um corpo de resposta.

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

Para obter informações sobre exceções e mensagens de erro do Amazon Glacier, consulte [Respostas de erro](api-error-responses.md).

## Exemplos
<a name="api-SetDataRetrievalPolicy-examples"></a>

### Exemplo de solicitação
<a name="api-SetDataRetrievalPolicy-example-request"></a>

O exemplo a seguir envia uma solicitação HTTP PUT com o campo Strategy definido como `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. }
```

O exemplo a seguir envia uma solicitação HTTP PUT com o campo Strategy definido como `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. }
```

O exemplo a seguir envia uma solicitação HTTP PUT com o campo Strategy definido como `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. }
```

### Exemplo de resposta
<a name="api-SetDataRetrievalPolicy-example-response"></a>

Se a solicitação for bem-sucedida, o Amazon Glacier define a política e retorna uma resposta `HTTP 204 No Content`, conforme mostrado no exemplo a seguir.

```
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
```

## Seções relacionadas
<a name="related-sections-SetDataRetrievalPolicy"></a>

 
+ [Política de recuperação para obter dados (GET policy)](api-GetDataRetrievalPolicy.md)

 
+ [Initiate Job (trabalhos POST)](api-initiate-job-post.md)