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 e Noções básicas sobre as classes de armazenamento S3 Glacier para armazenamento de dados de longo prazo no Guia do usuário do Amazon S3. Essas classes de armazenamento usam a API do Amazon S3, estão disponíveis em todas as regiões e podem ser gerenciadas no console do Amazon S3. Elas oferecem análise de custos de armazenamento, Lente de Armazenamento, recursos avançados de criptografia opcionais e muito mais.

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:

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: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

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.

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: