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 é InProgess ou Locked.

• 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 Fechadura S3 Glacier Vault.

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

nota

O valor de AccountId é o ID de Conta da AWS da conta proprietária do cofre. Você pode especificar um ID de Conta da AWS ou, de forma opcional, um '-' (hífen) único; nesse caso, o Amazon S3 Glacier usa o ID de Conta da AWS associado à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 estado Locked.

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

• Abort Vault Lock (DELETE lock-policy)

• Complete Vault Lock (POST lockId)

• Initiate Vault Lock (POST lock-policy)

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