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 S3 Glacier (S3 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 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 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 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 | 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)