**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á.
# Initiate Vault Lock (POST lock-policy)
## Descrição
Esta operação inicia o processo de bloqueio do cofre fazendo o seguinte:
+ Instalar uma política de bloqueio de cofre no cofre especificado.
+ Definir o estado de bloqueio do cofre como `InProgress`.
+ Retornar um ID de bloqueio, usado para concluir o processo de bloqueio do cofre.
Você pode definir uma política de bloqueio para cada cofre, e essa política pode ter até 20 KB. Para obter mais informações sobre políticas de bloqueio de cofre, consulte [Políticas do Vault Lock](vault-lock-policy.md).
Você deverá concluir o processo de bloqueio do cofre dentro de 24 horas depois que o bloqueio de cofre entrar no estado `InProgress`. Depois da janela de 24 horas, o ID de bloqueio vai expirar, o cofre sairá automaticamente do estado `InProgress` e a política de bloqueio do cofre será removida do cofre. Você chama [Complete Vault Lock (POST lockId)](api-CompleteVaultLock.md) para concluir o processo de bloqueio do cofre definindo o estado do bloqueio de cofre como `Locked`.
**nota**
Depois que um bloqueio de cofre estiver no estado `Locked`, você não poderá iniciar um novo bloqueio para o cofre.
Você pode interromper o processo de bloqueio de cofre chamando [Abort Vault Lock (DELETE lock-policy)](api-AbortVaultLock.md). Você pode obter o estado do bloqueio de cofre chamando [Get Vault Lock (GET lock-policy)](api-GetVaultLock.md). Para obter mais informações sobre o processo de bloqueio de cofre, consulte [Vault Lock do Amazon Glacier](vault-lock.md).
Se essa operação for chamada quando o bloqueio de cofre estiver no estado `InProgress`, a operação retornará um erro `AccessDeniedException`. Quando o bloqueio de cofre está no estado `InProgress`, você deverá chamar [Abort Vault Lock (DELETE lock-policy)](api-AbortVaultLock.md) antes de iniciar uma nova política de bloqueio de cofre.
## Solicitações
Para iniciar o processo de bloqueio de cofre, envie uma solicitação HTTP `POST` para o URI do sub-recurso `lock-policy` do cofre, conforme mostrado no exemplo de sintaxe a seguir.
### Sintaxe
```
1. POST /AccountId/vaults/vaultName/lock-policy 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": "string"
10. }
```
**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.
**Política**
A política de bloqueio de cofre como uma string JSON, que usa"\$1" como um caractere de escape.
Tipo: string
Obrigatório: Sim
## Respostas
Em resposta, o Amazon Glacier retornará uma resposta `HTTP 201 Created`, se a política for aceita.
### Sintaxe
```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-lock-id: lockId
```
### Cabeçalhos de resposta
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).
| Nome | Descrição |
| --- | --- |
| x-amz-lock-id | O ID de bloqueio, usado para concluir o processo de bloqueio do cofre. Tipo: string |
### 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 `PUT` HTTP para criar o URI do sub-recurso `lock-policy` do cofre. A string JSON `Policy` usa "\$1" como um caractere de escape.
```
1. PUT /-/vaults/examplevault/lock-policy 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
7.
8. {"Policy":"{\"Version\":\"2012-10-17\", \"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}"}
```
### Exemplo de resposta
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-lock-id: AE863rKkWZU53SLW5be4DUcW
```
## Seções relacionadas
+ [Abort Vault Lock (DELETE lock-policy)](api-AbortVaultLock.md)
+ [Complete Vault Lock (POST lockId)](api-CompleteVaultLock.md)
+ [Get Vault Lock (GET lock-policy)](api-GetVaultLock.md)
## Consulte também
Para obter mais informações sobre como usar essa API em um dos Amazon SDKs específicos de linguagem, consulte o seguinte:
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/initiate-vault-lock.html)