**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á.
# jobParameters
Fornece opções para definir um trabalho.
## Conteúdo
**ArchiveId**
O ID do arquivo desejado. Este campo só será obrigatório se o campo `Type` estiver definido como `select` ou `archive-retrieval`. Um erro ocorrerá se você especificar esse campo para uma solicitação de trabalho de recuperação de inventário.
*Valores válidos*: devem ser um ID de arquivo válido obtido de uma solicitação anterior feita ao Amazon Glacier.
*Tipo:* string
*Obrigatório*: sim quando `Type` for definido como `select` ou `archive-retrieval`.
**Descrição**
A descrição opcional do trabalho.
*Valores válidos*: a descrição deve ser menor ou igual a 1.024 bytes. Os caracteres permitidos são ASCII 7 bits sem códigos de controle — mais especificamente, valores ASCII 32–126 decimais ou 0x20–0x7E hexadecimais.
*Tipo:* string
*Obrigatório*: não
**Formato**
(Opcional) O formato da saída, ao iniciar um trabalho para recuperar um inventário de cofre. Se você estiver iniciando um trabalho de inventário e não especificar um campo `Format`, JSON será o formato padrão.
*Valores válidos*: `CSV` \| `JSON`
*Tipo:* string
*Obrigatório*: não
**InventoryRetrievalParameters**
Os parâmetros de entrada usados em uma recuperação de inventário de intervalo.
*Tipo*: [InventoryRetrievalJobInput](api-InventoryRetrievalJobInput.md) objeto
*Obrigatório*: não
**OutputLocation**
Um objeto com informações sobre o local onde os resultados do trabalho de seleção são armazenados.
*Tipo*: [OutputLocation](api-OutputLocation.md) objeto
*Obrigatório*: sim para trabalhos `select`.
**RetrievalByteRange**
O intervalo de bytes a ser recuperado para uma `archive-retrieval`, no formato “{{StartByteValue}}-{{EndByteValue}}”. Se esse campo não for especificado, todo o arquivo será recuperado. Se esse campo for especificado, o intervalo de bytes deverá ser alinhado a megabyte (1024\*1024). Alinhado a megabyte significa que *StartByteValue* deve ser divisível por 1 MB e *EndByteValue* mais 1 deve ser divisível por 1 MB ou ser o final do arquivo especificado como o valor do tamanho de bytes do arquivo menos 1. Se **RetrievalByteRange** não estiver alinhado a megabyte, essa operação retornará a resposta `400`.
Um erro ocorrerá se você especificar esse campo em uma solicitação de trabalho `inventory-retrieval` ou `select`.
*Tipo:* string
*Obrigatório*: não
**SelectParameters**
Um objeto com informações sobre os parâmetros usados em uma seleção.
*Tipo*: [SelectParameters](api-SelectParameters.md) objeto
*Obrigatório*: não
**SNSTopic**
O nome do recurso da Amazon (ARN) do tópico do Amazon SNS, em que o Amazon Glacier envia uma notificação quando o trabalho é concluído e a saída fica pronta para fazer download. O tópico especificado publica a notificação para os assinantes.
O tópico do SNS deve existir. Do contrário, o Amazon Glacier não o criará para você. Além disso, o tópico do SNS deve ter uma política que permita à conta que criou o trabalho publicar mensagens no tópico. Para obter informações sobre nomes de tópico do SNS, consulte [CreateTopic](https://docs.aws.amazon.com/sns/latest/api/API_CreateTopic.html) na *Referência de API* do *Amazon Simple Notification Service*.
*Tipo:* string
*Obrigatório*: não
**Tier**
O nível a ser usado para um trabalho de seleção ou de recuperação de arquivo. `Standard` é o valor padrão usado.
*Valores válidos*: `Expedited` \| `Standard` \| `Bulk`
*Tipo:* string
*Obrigatório*: não
**Tipo**
O tipo de trabalho. Você pode iniciar um trabalho para executar uma consulta select em um arquivo, recuperar um arquivo ou obter um inventário de um cofre.
*Valores válidos*: `select` \| `archive-retrieval` \| `inventory-retrieval`
*Tipo:* string
*Obrigatório*: sim
## Mais informações
+ [Initiate Job (trabalhos POST)](api-initiate-job-post.md)