

 **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á.

# GlacierJobDescription
<a name="api-GlacierJobDescription"></a>

Contém a descrição de um trabalho do Amazon Glacier.

## Conteúdo
<a name="api-GlacierJobDescription-contents"></a>

**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

**ArchiveSHA256TreeHash**  
O hash de árvore SHA256 de todo o arquivo de uma recuperação do arquivo. 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

**Concluído**  
`true` se o trabalho for concluído;, do contrário `false`.  
*Tipo*: booliano

**CompletionDate**  
A data em que o trabalho foi concluído.  
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*: uma representação de string no formato de data ISO 8601, por exemplo `2013-03-20T17:03:43.221Z`.

**CreationDate**  
A data UTC quando o trabalho foi iniciado.  
*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 que você forneceu 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 recuperado para trabalhos de recuperação de arquivo no formato "{{StartByteValue}}-{{EndByteValue}}". Se nenhum intervalo for especificado na recuperação do arquivo, então, todo o arquivo será recuperado e *StartByteValue* será igual a 0 e *EndByteValue* será igual ao tamanho do arquivo menos 1. Para trabalhos de recuperação do inventário, esse 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 de árvore SHA256 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).  
Quando todo o arquivo for recuperado, esse valor será igual ao valor de `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**  
O nome do recurso da Amazon (ARN) que representa um tópico do Amazon SNS em que a notificação da conclusão ou da falha do trabalho é enviada, se a notificação tiver sido configurada na iniciação do trabalho ([Initiate Job (trabalhos POST)](api-initiate-job-post.md)).  
*Tipo:* string

**StatusCode**  
O código que indica o status do trabalho.  
*Valores válidos*: `InProgress` \| `Succeeded` \| `Failed`  
*Tipo:* string

**StatusMessage**  
A mensagem de status do trabalho.  
*Tipo:* string

**Tier**  
O nível de acesso a dados a ser usado na seleção ou na recuperação de arquivo.  
*Valores válidos*: `Expedited` \| `Standard` \| `Bulk`  
*Tipo:* string

**VaultARN**  
O ARN do cofre do qual o trabalho é um sub-recurso.  
*Tipo:* string

## Mais informações
<a name="more-info-api-GlacierJobDescription"></a>
+ [Initiate Job (trabalhos POST)](api-initiate-job-post.md)