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
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
Typeestiver definido comoselectouarchive-retrieval. Um erro ocorrerá se você especificar esse campo para uma solicitação de trabalho de recuperação de inventário.Valores válidos: deve ser um ID de arquivo válido que você obteve de uma solicitação anterior ao Amazon Glacier (Amazon Glacier).
Tipo: string
Obrigatório: sim quando
Typefor definido comoselectouarchive-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|JSONTipo: string
Obrigatório: não
- InventoryRetrievalParameters
-
Os parâmetros de entrada usados em uma recuperação de inventário de intervalo.
Tipo: InventoryRetrievalJobInput 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 objeto
Obrigatório: sim para trabalhos
select. - RetrievalByteRange
-
O intervalo de bytes a ser recuperado para um
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 ao megabyte significa que StartByteValuedeve ser divisível por 1 MB e EndByteValuemais 1 deve ser divisível por 1 MB ou ser o final do arquivo especificado como o valor do tamanho do byte do arquivo menos 1. Se não RetrievalByteRangeestiver alinhada em megabytes, essa operação retornará uma resposta.400Um erro ocorrerá se você especificar esse campo em uma solicitação de trabalho
inventory-retrievalouselect.Tipo: string
Obrigatório: não
- SelectParameters
-
Um objeto com informações sobre os parâmetros usados em uma seleção.
Tipo: SelectParameters objeto
Obrigatório: não
- SNSTopic
-
O Amazon Resource Name (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 está pronta para download. O tópico especificado publica a notificação para os assinantes.
O tópico do SNS deve existir. Caso 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ópicos do SNS, consulte CreateTopica Referência da API do Amazon Simple Notification Service.
Tipo: string
Obrigatório: não
- Nível
-
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|BulkTipo: 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-retrievalTipo: string
Obrigatório: sim
Mais informações
