**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á. # Get Job Output (GET output) ## Description Essa operação faz download da saída do trabalho iniciado por você usando a operação [Initiate Job (trabalhos POST)](api-initiate-job-post.md). 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ê fizer download de um arquivo inteiro, o tamanho esperado será o tamanho do arquivo quando fez upload dele no Amazon Glacier. O tamanho esperado também é retornado nos cabeçalhos da resposta **Obter saída de trabalho**. Em caso de um trabalho de recuperação de arquivo, dependendo do intervalo de bytes especificado por você, 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. Um ID do trabalho não vai expirar por pelo menos 24 horas depois que o Amazon Glacier concluir o trabalho. Ou seja, você pode fazer download do resultado do trabalho dentro do período de 24 horas depois que o Amazon Glacier concluir o trabalho. ## 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. ``` 1. GET /AccountId/vaults/VaultName/jobs/JobID/output HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. Range: ByteRangeToRetrieve 6. x-amz-glacier-version: 2012-06-01 ``` **nota** O `AccountId` valor é o Conta da AWS ID da conta proprietária do cofre. Você pode especificar um Conta da AWS ID ou, opcionalmente, um único '`-`' (hífen). Nesse caso, o Amazon Glacier usa Conta da AWS o ID 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 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](api-common-request-headers.md). | Name (Nome) | Description | Obrigatório | | --- | --- | --- | | Range | O intervalo de bytes a ser recuperado da saída. Por exemplo, se você quiser fazer download dos primeiros 1.048.576 bytes, especifique o intervalo como `bytes=0-1048575`. Para obter mais informações, acesse [Definição do campo de cabeçalho do intervalo](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35). O intervalo se refere a qualquer intervalo especificado na solicitação Initiate Job. Por padrão, essa operação faz download de toda a saída. Se a saída do trabalho for grande, você poderá usar o cabeçalho da solicitação `Range` para recuperar uma parte da saída. Isso permite fazer download de toda a saída em blocos de bytes menores. Por exemplo, suponhamos que você tenha 1 GB de saída de trabalho cujo download deseja fazer e opte por fazer download de blocos de 128 MB de dados por vez, em um total de oito solicitações Get Job Output. Você usará o seguinte processo para fazer download da saída do trabalho: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/amazonglacier/latest/dev/api-job-output-get.html) Tipo: string Padrão: nenhum Restrições: nenhuma | Não | ### 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. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: x-amzn-RequestId 3. Date: Date 4. Content-Type: ContentType 5. Content-Length: Length 6. x-amz-sha256-tree-hash: ChecksumComputedByAmazonGlacier 7. 8. [Body containing job output.] ``` ### Cabeçalhos de resposta | Cabeçalho | Description | | --- | --- | | Content-Range | O intervalo de bytes retornado pelo Amazon Glacier. Se somente o download da saída parcial tiver sido feito, a resposta fornecerá o intervalo de bytes retornado pelo Amazon Glacier. Por exemplo, `bytes 0-1048575/8388608` retorna o primeiro 1 MB de 8 MB. Para obter mais informações sobre o cabeçalho `Content-Range`, acesse [Definição do campo de cabeçalho Content-Range](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.16). Tipo: string | | Content-Type | O Content-Type depende da saída do trabalho ser um arquivo ou um inventário de cofre. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/amazonglacier/latest/dev/api-job-output-get.html) Tipo: string | | x-amz-sha256-tree-hash​ | A soma de verificação dos dados na resposta. Esse cabeçalho é retornado somente quando se recupera a saída de um trabalho de recuperação de arquivo. Além disso, esse cabeçalho é exibido quando o intervalo de dados recuperados solicitado no pedido Initiate Job está alinhado ao hash de árvore e o intervalo para download no Get Job Output também está alinhado ao hash de árvore. Para obter mais informações sobre intervalos alinhados ao hash de árvore, consulte [Receber somas de verificação durante o download de dados](checksum-calculations-range.md). Por exemplo, se na solicitação Initiate Job, tiver especificado um intervalo alinhado ao hash de árvore (o que inclui todo o arquivo), você receberá a soma de verificação dos dados cujo download fez nas seguintes condições: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/amazonglacier/latest/dev/api-job-output-get.html) Tipo: string | ### 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. ``` 1. { 2. "VaultARN": String, 3. "InventoryDate": String, 4. "ArchiveList": [ 5. {"ArchiveId": String, 6. "ArchiveDescription": String, 7. "CreationDate": String, 8. "Size": Number, 9. "SHA256TreeHash": String 10. }, 11. ... 12. ] 13. } ``` 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. **nota** No formato CSV retornado, os campos podem ser retornados com o campo inteiro entre aspas duplas. Os campos que contenham uma vírgula ou aspas duplas sempre são retornados entre aspas duplas. Por exemplo, `my archive description,1` é retornado como `"my archive description,1"`. Caracteres de aspas duplas que estejam entre campos entre aspas duplas têm *escape* com um caractere de barra invertida antes deles. Por exemplo, `my archive description,1"2` é retornado como `"my archive description,1\"2"` e `my archive description,1\"2` é retornado como `"my archive description,1\\"2"`. O caractere de barra invertida não é de escape. O corpo da resposta JSON contém os seguintes campos JSON: **ArchiveDescription** A descrição de um arquivo. *Tipo:* string **ArchiveId** O ID de um arquivo. *Tipo:* string **ArchiveList** Uma matriz de metadados de arquivo. Cada objeto na matriz representa metadados de um arquivo contido no cofre. *Tipo*: matriz **CreationDate** A data e hora UTC em que o arquivo foi criado. *Tipo*: uma representação de string no formato de data ISO 8601, por exemplo `2013-03-20T17:03:43.221Z`. **InventoryDate** A data e hora UTC do inventário mais recente do cofre que foi concluído após alterações terem sido feitas no cofre. Embora o Amazon Glacier prepare um inventário de cofre uma vez por dia, a data do inventário será atualizada somente se tiver ocorrido adições ou exclusões de arquivo no cofre desde o último inventário. *Tipo*: uma representação de string no formato de data ISO 8601, por exemplo `2013-03-20T17:03:43.221Z`. **SHA256TreeHash** O hash de árvore do arquivo. *Tipo:* string **Tamanho** O tamanho em bytes do arquivo. *Tipo*: número **VaultARN** O Amazon Resource Name (ARN – Nome de recurso da Amazon) do qual a recuperação do arquivo foi solicitada. *Tipo:* string ### Erros Para obter informações sobre exceções e mensagens de erro do Amazon Glacier, consulte [Respostas de erro](api-error-responses.md). ## 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 à solicitação do trabalho de recuperação de arquivo de iniciação. #### Exemplo de solicitação ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. 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. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. x-amz-sha256-tree-hash: beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60 4. Date: Wed, 10 Feb 2017 12:00:00 GMT 5. Content-Type: application/octet-stream 6. Content-Length: 1048576 7. 8. [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`. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Type: application/json 5. Content-Length: 906 6. 7. { 8. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault", 9. "InventoryDate": "2011-12-12T14:19:01Z", 10. "ArchiveList": [ 11. { 12. "ArchiveId": "DMTmICA2n5Tdqq5BV2z7og-A20xnpAPKt3UXwWxdWsn_D6auTUrW6kwy5Qyj9xd1MCE1mBYvMQ63LWaT8yTMzMaCxB_9VBWrW4Jw4zsvg5kehAPDVKcppUD1X7b24JukOr4mMAq-oA", 13. "ArchiveDescription": "my archive1", 14. "CreationDate": "2012-05-15T17:19:46.700Z", 15. "Size": 2140123, 16. "SHA256TreeHash": "6b9d4cf8697bd3af6aa1b590a0b27b337da5b18988dbcc619a3e608a554a1e62" 17. }, 18. { 19. "ArchiveId": "2lHzwhKhgF2JHyvCS-ZRuF08IQLuyB4265Hs3AXj9MoAIhz7tbXAvcFeHusgU_hViO1WeCBe0N5lsYYHRyZ7rrmRkNRuYrXUs_sjl2K8ume_7mKO_0i7C-uHE1oHqaW9d37pabXrSA", 20. "ArchiveDescription": "my archive2", 21. "CreationDate": "2012-05-15T17:21:39.339Z", 22. "Size": 2140123, 23. "SHA256TreeHash": "7f2fe580edb35154041fa3d4b41dd6d3adaef0c85d2ff6309f1d4b520eeecda3" 24. } 25. ] 26. } ``` ### Exemplo 2: fazer download somente da saída parcial Este exemplo recupera somente uma parte do arquivo preparado pelo Amazon Glacier em resposta à solicitação do trabalho de recuperação de arquivo de iniciação. A solicitação usa o cabeçalho `Range` opcional para recuperar somente os primeiros 1.024 bytes. #### Exemplo de solicitação ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID/output HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. Range: bytes=0-1023 5. x-amz-glacier-version: 2012-06-01 6. 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 cabeçalho `Content-Range` que especifica o intervalo de bytes retornado pelo Amazon Glacier. ``` 1. HTTP/1.1 206 Partial Content 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Range: bytes 0-1023/8388608 5. Content-Type: application/octet-stream 6. Content-Length: 1024 7. 8. [Archive data.] ``` ## Seções relacionadas + [Trabalho de descrição (GET JobID)](api-describe-job-get.md) + [Initiate Job (trabalhos POST)](api-initiate-job-post.md) + [Gerenciamento de identidade e acesso para o Amazon Glacier](security-iam.md)