Esta página destina-se somente a clientes atuais do serviço S3 Glacier que usam cofres e a API REST original de 2012.
Se você estiver procurando soluções de armazenamento de arquivos, sugerimos usar as classes de armazenamento do S3 Glacier no 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 S3 Glacier
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á.
Get Vault Lock (GET lock-policy)
Descrição
Esta operação recupera os seguintes atributos do sub-recurso lock-policy definido no cofre especificado:
-
A política do bloqueio de cofre definida no cofre.
-
O estado do bloqueio de cofre, que é
InProgessouLocked. -
Quando o ID de bloqueio expira. O ID de bloqueio é usado para concluir o processo de bloqueio do cofre.
-
Quando o bloqueio de cofre foi iniciado e colocado no estado
InProgress.
Um bloqueio de cofre é colocado no estado InProgress chamando Initiate Vault Lock (POST lock-policy). Um bloqueio de cofre é colocado no estado Locked chamando Complete Vault Lock (POST lockId). Você pode interromper o processo de bloqueio de cofre chamando Abort Vault Lock (DELETE lock-policy). Para obter mais informações sobre o processo de bloqueio de cofre, consulte Vault Lock do S3 Glacier.
Se não houver política de bloqueio de cofre definida no cofre, a operação retornará um erro 404
Not found. Para obter mais informações sobre políticas de bloqueio de cofre, consulte Políticas do Vault Lock.
Solicitações
Para retornar a política de bloqueio de cofre atual e outros atributos, envie uma solicitação GET HTTP para o URI do sub-recurso lock-policy do cofre conforme mostrado no exemplo da sintaxe a seguir.
Sintaxe
GET /AccountId/vaults/vaultName/lock-policy HTTP/1.1 Host: glacier.Region.amazonaws.com Date:DateAuthorization:SignatureValuex-amz-glacier-version: 2012-06-01
nota
O AccountId valor é o Conta da AWS ID da conta proprietária do cofre. Você pode especificar uma Conta da AWS ID ou, opcionalmente, um único '-' (hífen). Nesse caso, o Amazon S3 Glacier usa Conta da AWS a ID associada às credenciais usadas para assinar a solicitação. Se você usar um ID de conta, não inclua nenhum hífen ('-') no ID.
Parâmetros de 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.
Corpo da Solicitação
Essa operação não tem um corpo de solicitação.
Respostas
Em resposta, o Amazon S3 Glacier (S3 Glacier) retorna a política de acesso ao cofre em formato JSON no corpo da resposta.
Sintaxe
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" }
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.
Corpo da resposta
O corpo da resposta contém os seguintes campos JSON.
- Política
-
A política de bloqueio de cofre como uma string JSON, que usa"\" como um caractere de escape.
Tipo: string
- Estado
-
O estado do bloqueio de cofre.
Tipo: string
Valores válidos:
InProgress|Locked - ExpirationDate
-
A data e hora UTC em que o ID de bloqueio expira. Esse valor poderá ser
null, se o bloqueio de cofre estiver em um estadoLocked.Tipo: uma representação de string no formato de data ISO 8601, por exemplo
2013-03-20T17:03:43.221Z. - CreationDate
-
A data e hora UTC em que o bloqueio de cofre foi colocado no estado
InProgress.Tipo: uma representação de string no formato de data ISO 8601, por exemplo
2013-03-20T17:03:43.221Z.
Erros
Para obter informações sobre exceções e mensagens de erro do Amazon S3 Glacier, consulte Respostas de erro.
Exemplos
O exemplo a seguir demonstra como obter uma política de bloqueio de cofre.
Exemplo de solicitação
Neste exemplo, uma solicitação GET é enviada para o URI do sub-recurso lock-policy de um cofre.
GET /-/vaults/examplevault/lock-policy HTTP/1.1 Host: glacier.us-west-2.amazonaws.com x-amz-Date: 20170210T120000Z x-amz-glacier-version: 2012-06-01 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
Se a solicitação tiver sido bem-sucedida, o S3 Glacier retornará a política de acesso ao cofre como uma string JSON no corpo da resposta. A string JSON retornada usa"\" como um caractere de escape, conforme mostrado na solicitação de exemplo Initiate Vault Lock (POST lock-policy). No entanto, o exemplo a seguir mostra a string JSON retornada sem caracteres de escape para fins de legibilidade.
HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: length
{
"Policy": "
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "Define-vault-lock",
"Principal": {
"AWS": "arn:aws:iam::999999999999:root"
},
"Effect": "Deny",
"Action": "glacier:DeleteArchive",
"Resource": [
"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault"
],
"Condition": {
"NumericLessThanEquals": {
"glacier:ArchiveAgeInDays": "365"
}
}
}
]
}
",
"State": "InProgress",
"ExpirationDate": "exampledate",
"CreationDate": "exampledate"
}Seções relacionadas
Consulte também
Para obter mais informações sobre o uso dessa API em uma das linguagens específicas da Amazon SDKs, consulte o seguinte:
