Esta página é somente para clientes existentes do serviço S3 Glacier que usam o Vaults e a API REST original de 2012.
Se você estiver procurando por soluções de armazenamento de arquivamento, sugerimos usar as classes de armazenamento S3 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 Classes de armazenamento S3 Glacier e Armazenamento de dados de longo prazo usando classes
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.
Índice
- 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: devem ser um ID de arquivo válido obtido de uma solicitação anterior feita ao S3 Glacier (S3 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 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 resposta400.Um 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 nome do recurso da Amazon (ARN) do tópico do Amazon SNS, em que o S3 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 S3 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 na Referência de 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
- Type
-
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
