**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á. # Trabalho de descrição (GET JobID) ## Description Esta operação retorna informações sobre um trabalho iniciado anteriormente, incluindo a data de início do trabalho, o usuário que o iniciou, o código de status do trabalho/mensagem e o tópico do Amazon Simple Notification Service (Amazon SNS) para notificar depois que o Amazon Glacier concluir o trabalho. Para obter mais informações sobre como iniciar um trabalho, consulte [Initiate Job (trabalhos POST)](api-initiate-job-post.md). **nota** Essa operação permite verificar o status do trabalho. No entanto, é altamente recomendável configurar um tópico do Amazon SNS e especificá-lo na solicitação do trabalho de inicialização para que o Amazon Glacier possa notificar o tópico após a conclusão do trabalho. Um ID do trabalho não vai expirar por pelo menos 24 horas depois que o Amazon Glacier concluir o trabalho. ## Solicitações ### Sintaxe Para obter informações sobre um trabalho, você usa o método `GET` HTTP e delimita a solicitação ao trabalho específico. O caminho do URI relativo é o mesmo retornado pelo Amazon Glacier quando você iniciou o trabalho. ``` 1. GET /AccountID/vaults/VaultName/jobs/JobID HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: date 4. Authorization: signatureValue 5. 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. **nota** Na solicitação, se você omitir o `JobID`, a resposta retornará uma lista de todos os trabalhos ativos no cofre especificado. Para obter mais informações sobre como listar trabalhos, consulte [List Jobs (GET jobs)](api-jobs-get.md). ### 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 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](api-common-request-headers.md). ### Corpo da Solicitação Essa operação não tem um corpo de solicitação. ## Respostas ### Sintaxe ``` HTTP/1.1 201 Created x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: Length { "Action": "string", "ArchiveId": "string", "ArchiveSHA256TreeHash": "string", "ArchiveSizeInBytes": number, "Completed": boolean, "CompletionDate": "string", "CreationDate": "string", "InventoryRetrievalParameters": { "EndDate": "string", "Format": "string", "Limit": "string", "Marker": "string", "StartDate": "string" }, "InventorySizeInBytes": number, "JobDescription": "string", "JobId": "string", "JobOutputPath": "string", "OutputLocation": { "S3": { "AccessControlList": [ { "Grantee": { "DisplayName": "string", "EmailAddress": "string", "ID": "string", "Type": "string", "URI": "string" }, "Permission": "string" } ], "BucketName": "string", "CannedACL": "string", "Encryption": { "EncryptionType": "string", "KMSContext": "string", "KMSKeyId": "string" }, "Prefix": "string", "StorageClass": "string", "Tagging": { "string": "string" }, "UserMetadata": { "string": "string" } } }, "RetrievalByteRange": "string", "SelectParameters": { "Expression": "string", "ExpressionType": "string", "InputSerialization": { "csv": { "Comments": "string", "FieldDelimiter": "string", "FileHeaderInfo": "string", "QuoteCharacter": "string", "QuoteEscapeCharacter": "string", "RecordDelimiter": "string" } }, "OutputSerialization": { "csv": { "FieldDelimiter": "string", "QuoteCharacter": "string", "QuoteEscapeCharacter": "string", "QuoteFields": "string", "RecordDelimiter": "string" } } }, "SHA256TreeHash": "string", "SNSTopic": "string", "StatusCode": "string", "StatusMessage": "string", "Tier": "string", "VaultARN": "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](api-common-response-headers.md). ### Corpo da resposta O corpo da resposta contém os seguintes campos JSON. **Ação** O tipo de trabalho. É `ArchiveRetrieval`, `InventoryRetrieval` ou `Select`. *Tipo:* string **ArchiveId** O ID de arquivo solicitado para um trabalho de seleção ou de recuperação de arquivo. Do contrário, esse campo será `null`. *Tipo:* string **ArquivoSHA256TreeHash** O hash da SHA256 árvore de todo o arquivo para um trabalho de recuperação de arquivamento. Para trabalhos de recuperação do inventário, esse campo é `null`. *Tipo:* string **ArchiveSizeInBytes** Para um trabalho `ArchiveRetrieval`, trata-se do tamanho em bytes do arquivo solicitado para download. Para o trabalho `InventoryRetrieval`, o valor é `null`. *Tipo*: número **Completed** O status do trabalho. Quando um trabalho de recuperação de arquivo ou inventário for concluído, você obterá a saída do trabalho usando o [Get Job Output (GET output)](api-job-output-get.md). *Tipo*: booliano **CompletionDate** A hora UTC (Horário Coordenado Universal) em que a solicitação de trabalho foi concluída. Enquanto o trabalho estiver em andamento, o valor será nulo. *Tipo:* string **CreationDate** A hora UTC em que o trabalho foi criado. *Tipo*: uma representação de string no formato de data ISO 8601, por exemplo `2013-03-20T17:03:43.221Z`. **InventoryRetrievalParameters** Os parâmetros de entrada usados em uma recuperação de inventário de intervalo. *Tipo*: [InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md) objeto **InventorySizeInBytes** Para um trabalho `InventoryRetrieval`, trata-se do tamanho em bytes do inventário solicitado para download. No trabalho `ArchiveRetrieval` ou `Select`, o valor é `null`. *Tipo*: número **JobDescription** A descrição do trabalho fornecida por você quando iniciou o trabalho. *Tipo:* string **JobId** O ID que identifica o trabalho no Amazon Glacier. *Tipo:* string **JobOutputPath** Contém o local de saída do trabalho. *Tipo:* string **OutputLocation** Um objeto com informações sobre o local onde os resultados e os erros do trabalho de seleção são armazenados. *Tipo*: [OutputLocation](api-OutputLocation.md) objeto **RetrievalByteRange** O intervalo de bytes recuperados para trabalhos de recuperação de arquivamento no formato "*StartByteValue*-”. *EndByteValue* Se você não especificar um intervalo na recuperação do arquivo, o arquivo inteiro será recuperado; também é *StartByteValue*igual a 0 e é igual ao tamanho do arquivo *EndByteValue*menos 1. Em trabalhos de seleção ou de recuperação de inventário, este campo é `null`. *Tipo:* string **SelectParameters** Um objeto com informações sobre os parâmetros usados em uma seleção. *Tipo*: [SelectParameters](api-SelectParameters.md) objeto **SHA256TreeHash** O valor do hash da SHA256 árvore para o intervalo solicitado de um arquivo. Se a solicitação [Initiate Job (trabalhos POST)](api-initiate-job-post.md) para um arquivo tiver especificado um intervalo alinhado ao hash de árvore, esse campo retornará um valor. Para obter mais informações sobre o alinhamento ao hash de árvore para recuperações do intervalo de arquivos, consulte [Receber somas de verificação durante o download de dados](checksum-calculations-range.md). Para o caso específico quando todo o arquivo for recuperado, esse valor será igual ao valor `ArchiveSHA256TreeHash`. Esse campo é `null` nas seguintes situações: + Os trabalhos de recuperação de arquivo que especificam um intervalo não alinhado ao hash de árvore. + Trabalhos de arquivamento que especificam um intervalo igual a todo o arquivamento e cujo status do trabalho seja `InProgress`. + Trabalhos de inventário. + Trabalhos de seleção. *Tipo:* string **SNSTopic** Um tópico do Amazon SNS que recebe notificação. *Tipo:* string **StatusCode** O código que indica o status do trabalho. *Valores válidos*: `InProgress` \$1 `Succeeded` \$1 `Failed` *Tipo:* string **StatusMessage** Uma mensagem amigável que descreve o status do trabalho. *Tipo:* string **Nível** O nível de acesso a dados a ser usado na seleção ou na recuperação de arquivo. *Valores válidos*: `Bulk` \$1 `Expedited` \$1 `Standard` *Tipo:* string **VaultARN** O nome de recurso da Amazon (ARN) do cofre do qual o trabalho é um sub-recurso. *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. ### Solicitação de exemplo: obter descrição do trabalho ``` 1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID 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 O corpo da resposta inclui JSON que descreve o trabalho especificado. Observe que, nos trabalhos de recuperação de inventário e de arquivo, os campos JSON são iguais. No entanto, quando um campo não se aplica ao tipo de trabalho, o valor é `null`. Esta é uma resposta de exemplo para um trabalho de recuperação de arquivo. Observe o seguinte: + O valor do campo `Action` é `ArchiveRetrieval`. + O campo `ArchiveSizeInBytes` mostra o tamanho do arquivo solicitado no trabalho de recuperação do arquivo. + O `ArchiveSHA256TreeHash` campo mostra o hash da SHA256 árvore de todo o arquivo. + O campo `RetrievalByteRange` mostra o intervalo solicitado no pedido Initiate Job. Neste exemplo, todo o arquivo é solicitado. + O `SHA256TreeHash` campo mostra o hash da SHA256 árvore para o intervalo solicitado na solicitação de Initiate Job. Neste exemplo, ele é igual ao campo `ArchiveSHA256TreeHash`, o que significa que todo o arquivo foi solicitado. + O valor do campo `InventorySizeInBytes` é `null` porque não se aplica a um trabalho de recuperação de arquivo. ``` 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: 419 6. { 7. "Action": "ArchiveRetrieval", 8. "ArchiveId": "NkbByEejwEggmBz2fTHgJrg0XBoDfjP4q6iu87-TjhqG6eGoOY9Z8i1_AUyUsuhPAdTqLHy8pTl5nfCFJmDl2yEZONi5L26Omw12vcs01MNGntHEQL8MBfGlqrEXAMPLEArchiveId", 9. "ArchiveSizeInBytes": 16777216, 10. "ArchiveSHA256TreeHash": "beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60", 11. "Completed": false, 12. "CompletionDate": null, 13. "CreationDate": "2012-05-15T17:21:39.339Z", 14. "InventorySizeInBytes": null, 15. "JobDescription": "My ArchiveRetrieval Job", 16. "JobId": "HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID", 17. "RetrievalByteRange": "0-16777215", 18. "SHA256TreeHash": "beb0fe31a1c7ca8c6c04d574ea906e3f97b31fdca7571defb5b44dca89b5af60", 19. "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic", 20. "StatusCode": "InProgress", 21. "StatusMessage": "Operation in progress.", 22. "Tier": "Bulk", 23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" 24. } ``` Esta é uma resposta de exemplo para um trabalho de recuperação de inventário. Observe o seguinte: + O valor do campo `Action` é `InventoryRetrieval`. + Os valores de campo `ArchiveSizeInBytes`, `ArchiveSHA256TreeHash` e `RetrievalByteRange` são nulos porque não se aplicam a um trabalho de recuperação de inventário. + O valor de campo `InventorySizeInBytes` é `null` porque o trabalho ainda está em andamento e não preparou totalmente o inventário para download. Se o trabalho tivesse sido concluído antes da solicitação do trabalho de descrição, esse campo informaria o tamanho do resultado. ``` { "Action": "InventoryRetrieval", "ArchiveId": null, "ArchiveSizeInBytes": null, "ArchiveSHA256TreeHash": null, "Completed": false, "CompletionDate": null, "CreationDate": "2012-05-15T23:18:13.224Z", "InventorySizeInBytes": null, "JobDescription": "Inventory Description", "JobId": "HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVh7vEXAMPLEjobID", "RetrievalByteRange": null, "SHA256TreeHash": null, "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic", "StatusCode": "InProgress", "StatusMessage": "Operation in progress.", "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault" } ``` Esta é uma resposta de exemplo para um trabalho de recuperação de inventário completo que contém um marcador usado para continuar a paginação da recuperação do inventário de cofre. ``` { "Action": "InventoryRetrieval", "ArchiveId": null, "ArchiveSHA256TreeHash": null, "ArchiveSizeInBytes": null, "Completed": true, "CompletionDate": "2013-12-05T21:51:13.591Z", "CreationDate": "2013-12-05T21:51:12.281Z", "InventorySizeInBytes": 777062, "JobDescription": null, "JobId": "sCC2RZNBF2nildYD_roe0J9bHRdPQUbDRkmTdg-mXi2u3lc49uW6TcEhDF2D9pB2phx-BN30JaBru7PMyOlfXHdStzu8", "NextInventoryRetrievalMarker": null, "RetrievalByteRange": null, "SHA256TreeHash": null, "SNSTopic": null, "StatusCode": "Succeeded", "StatusMessage": "Succeeded", "Tier": "Bulk", "VaultARN": "arn:aws:glacier-devo:us-west-2:836579025725:vaults/inventory-icecube-2", "InventoryRetrievalParameters": { "StartDate": "2013-11-12T13:43:12Z", "EndDate": "2013-11-20T08:12:45Z", "Limit": "120000", "Format": "JSON", "Marker": "vyS0t2jHQe5qbcDggIeD50chS1SXwYMrkVKo0KHiTUjEYxBGCqRLKaiySzdN7QXGVVV5XZpNVG67pCZ_uykQXFMLaxOSu2hO_-5C0AtWMDrfo7LgVOyfnveDRuOSecUo3Ueq7K0" }, } ``` ## Seções relacionadas + [Get Job Output (GET output)](api-job-output-get.md) + [Gerenciamento de identidade e acesso para o Amazon Glacier](security-iam.md)