jobParameters - Amazon S3 Glacier

Esta página é somente para clientes existentes do serviço S3 Glacier que usam o Vaults e o original de 2012. REST API

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 de armazenamento S3 Glacier no Guia do usuário do Amazon S3. Essas classes de armazenamento usam o Amazon S3API, estão disponíveis em todas as regiões e podem ser gerenciadas no console do Amazon S3. Eles oferecem recursos como análise de custos de armazenamento, lente de armazenamento, recursos avançados de criptografia opcional e muito mais.

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