**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á. # Set Data Retrieval Policy (PUT policy) ## Descrição 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 ### Sintaxe 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 Essa operação não usa parâmetros de solicitação. ### Cabeçalhos de solicitação 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 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 ### Sintaxe ``` HTTP/1.1 204 No Content x-amzn-RequestId: x-amzn-RequestId Date: Date ``` ### Cabeçalhos de resposta 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 Essa operação não retorna um corpo de resposta. ### Erros Para obter informações sobre exceções e mensagens de erro do Amazon Glacier, consulte [Respostas de erro](api-error-responses.md). ## Exemplos ### Exemplo de solicitação 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 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 + [Política de recuperação para obter dados (GET policy)](api-GetDataRetrievalPolicy.md) + [Initiate Job (trabalhos POST)](api-initiate-job-post.md)