Esta página é somente para clientes atuais do serviço Amazon Glacier que usam Vaults e a API REST original de 2012.

Se você estiver procurando por soluções de armazenamento de arquivos, recomendamos usar as classes de armazenamento Amazon 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 as classes de armazenamento do Amazon Glacier.

O Amazon Glacier (serviço autônomo original baseado em cofre) não aceitará mais novos clientes a partir de 15 de dezembro de 2025, sem impacto para os clientes existentes. 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, 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 AWS nossa orientação de soluções para transferir dados dos cofres do Amazon Glacier para as 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 Job Output (GET output)

Descrição

Essa operação faz download da saída do trabalho iniciado por você usando a operação Initiate Job (trabalhos POST). Dependendo do tipo de trabalho especificado por você quando iniciou o trabalho, a saída será o conteúdo de um arquivo ou um inventário de cofre.

Você pode fazer download de toda a saída do ou de uma parte da saída especificando um intervalo de bytes. Para trabalhos de recuperação de arquivo e inventário, você deve verificar o tamanho obtido por download em relação ao tamanho retornado nos cabeçalhos da resposta Obter saída de trabalho.

Para trabalhos de recuperação de arquivo, você também deve verificar se o tamanho é o esperado. Se você fizer download de uma parte da saída, o tamanho esperado se baseará no intervalo de bytes especificado. Por exemplo, se especificar um intervalo de bytes=0-1048575, você deverá verificar se o tamanho do download é de 1.048.576 bytes. Se você baixar um arquivo inteiro, o tamanho esperado será o tamanho do arquivo quando você o carregou no Amazon Glacier (Amazon Glacier). O tamanho esperado também é retornado nos cabeçalhos da resposta Obter saída de trabalho.

No caso de um trabalho de recuperação de arquivamento, dependendo do intervalo de bytes especificado, o Amazon Glacier retorna a soma de verificação da parte dos dados. Para garantir que a parte obtida por download seja de dados corretos, compute a soma de verificação no cliente, verifique se os valores são correspondentes e se o tamanho é o esperado.

Uma ID de trabalho não expira por pelo menos 24 horas após a conclusão do trabalho pelo Amazon Glacier. Ou seja, você pode baixar a saída do trabalho dentro do período de 24 horas após a conclusão do trabalho pelo Amazon Glacier.

Solicitações

Sintaxe

Para recuperar uma saída de trabalho, você envia a solicitação GET HTTP para o URI do output do trabalho específico.

GET /AccountId/vaults/VaultName/jobs/JobID/output HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Range: ByteRangeToRetrieve
x-amz-glacier-version: 2012-06-01

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 os seguintes cabeçalhos de solicitação, além dos cabeçalhos de solicitação que são comuns a todas as operações. Para mais 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

Sintaxe

Para uma solicitação de recuperação que retorne todos os dados do trabalho, a resposta da saída do trabalho retorna um código de resposta 200 OK. Quando o conteúdo parcial é solicitado, por exemplo, se você tiver especificado o cabeçalho Range na solicitação, o código de resposta 206 Partial Content será retornado.

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: ContentType
Content-Length: Length
x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier

[Body containing job output.]

Cabeçalhos de resposta

Corpo da resposta

O Amazon Glacier retorna a saída do trabalho no corpo da resposta. Dependendo do tipo de trabalho, a saída pode ser o conteúdo do arquivo ou o inventário de cofre. No caso de um inventário de cofre, por padrão, a lista de inventários é retornada como o corpo JSON a seguir.

{
 "VaultARN": String,
 "InventoryDate": String,
 "ArchiveList": [
      {"ArchiveId": String,
       "ArchiveDescription": String,
       "CreationDate": String,
       "Size": Number,
       "SHA256TreeHash": String
      },
      ...
    ]
}

Se você tiver solicitado o formato de saída Comma-Separated Values (CSV – Valores separados por vírgula) quando iniciou o trabalho de inventário, o inventário de cofre será retornado em formato CSV no corpo. O formato CSV tem cinco colunas "ArchiveId“," ArchiveDescription “," CreationDate “, “Tamanho” e "SHA256TreeHash" com as mesmas definições dos campos JSON correspondentes.

O corpo da resposta JSON contém os seguintes campos JSON:

Erros

Para obter informações sobre exceções e mensagens de erro do Amazon Glacier, consulte. Respostas de erro

Exemplos

O exemplo a seguir mostra a solicitação de um trabalho que recupera um arquivo.

Exemplo 1: fazer download da saída

Este exemplo recupera dados preparados pelo Amazon Glacier em resposta à sua solicitação de trabalho de recuperação de arquivamento inicial.

Exemplo de solicitação

GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output 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

Esta é uma resposta de exemplo de um trabalho de recuperação de arquivo. O cabeçalho Content-Type é application/octet-stream e esse cabeçalho x-amz-sha256-tree-hash está incluído na resposta, o que significa que todos os dados do trabalho são retornados.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/octet-stream
Content-Length: 1048576

[Archive data.]

Esta é uma resposta de exemplo de um trabalho de recuperação de inventário. O cabeçalho Content-Type é application/json. A resposta também não inclui o cabeçalho x-amz-sha256-tree-hash.

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: 906

{
 "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
 "InventoryDate": "2011-12-12T14:19:01Z",
 "ArchiveList": [
   {
     "ArchiveId": "DMTmICA2n5Tdqq5BV2z7og-A20xnpAPKt3UXwWxdWsn_D6auTUrW6kwy5Qyj9xd1MCE1mBYvMQ63LWaT8yTMzMaCxB_9VBWrW4Jw4zsvg5kehAPDVKcppUD1X7b24JukOr4mMAq-oA",
     "ArchiveDescription": "my archive1",
     "CreationDate": "2012-05-15T17:19:46.700Z",
     "Size": 2140123,
     "SHA256TreeHash": "6b9d4cf8697bd3af6aa1b590a0b27b337da5b18988dbcc619a3e608a554a1e62"
   },
   {
     "ArchiveId": "2lHzwhKhgF2JHyvCS-ZRuF08IQLuyB4265Hs3AXj9MoAIhz7tbXAvcFeHusgU_hViO1WeCBe0N5lsYYHRyZ7rrmRkNRuYrXUs_sjl2K8ume_7mKO_0i7C-uHE1oHqaW9d37pabXrSA",
     "ArchiveDescription": "my archive2",
     "CreationDate": "2012-05-15T17:21:39.339Z",
     "Size": 2140123,
     "SHA256TreeHash": "7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3"
   }
  ]
}

Exemplo 2: fazer download somente da saída parcial

Este exemplo recupera somente uma parte do arquivo preparado pelo Amazon Glacier em resposta à sua solicitação de trabalho de recuperação de arquivamento inicial. A solicitação usa o cabeçalho Range opcional para recuperar somente os primeiros 1.024 bytes.

Exemplo de solicitação

GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
Range: bytes=0-1023	
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

A resposta bem-sucedida a seguir mostra a resposta 206 Partial Content. Nesse caso, a resposta também inclui um Content-Range cabeçalho que especifica o intervalo de bytes que o Amazon Glacier retorna.

HTTP/1.1 206 Partial Content
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Range: bytes 0-1023/8388608
Content-Type: application/octet-stream
Content-Length: 1024

[Archive data.]

Seções relacionadas