jobParameters - Amazon S3 Glacier

Se você é novato no Amazon Simple Storage Service (Amazon S3), recomendamos que comece aprendendo mais sobre as classes de armazenamento S3 Glacier no Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval e S3 Glacier Deep Archive. Para obter mais informações, consulte Classes de armazenamento S3 Glacier e Classes de armazenamento para arquivamento de objetos no Guia do usuário do 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.

Índice

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

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

Tipo: string

Obrigatório: sim

Mais informações