GetJobManifest - AWS Snowball

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á.

GetJobManifest

Retorna um link para um URL pré-assinada do Amazon S3 para o arquivo de manifesto associado ao valor de JobId especificado. Você pode acessar o arquivo de manifesto por até 60 minutos após a solicitação ter sido feita. Para acessar o arquivo de manifesto após 60 minutos, você precisará fazer outra chamada para a ação GetJobManifest.

O manifesto é um arquivo criptografado que você pode baixar após o início do seu trabalho entrar no status WithCustomer. Esse é o único status válido para chamar essa API, pois o manifesto e o valor do código UnlockCode são usados para proteger seu dispositivo e só devem ser usados quando você tem o dispositivo. O manifesto é descriptografado usando o valor do código UnlockCode quando os dois valores forem passados para o dispositivo Snow por meio do cliente do Snowball ao iniciar o cliente pela primeira vez.

Como melhores práticas, recomendamos não salvar uma cópia de um valor de UnlockCode no mesmo local que o arquivo de manifesto para esse trabalho. Salvar esses elementos separadamente ajuda a evitar que partes não autorizadas tenham acesso ao dispositivo Snow associado a esse trabalho.

As credenciais de um determinado trabalho, incluindo o arquivo de manifesto e o código de desbloqueio, expiram 360 dias após a criação do trabalho.

Sintaxe da Solicitação

{ "JobId": "string" }

Parâmetros da solicitação

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte Parâmetros comuns.

A solicitação aceita os dados a seguir no formato JSON.

JobId

O ID de um trabalho para o qual você deseja obter o arquivo de manifesto, por exemplo, JID123e4567-e89b-12d3-a456-426655440000.

Tipo: sequência

Restrições de tamanho: tamanho fixo de 39.

Padrão: (M|J)ID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Exigido: Sim

Sintaxe da Resposta

{ "ManifestURI": "string" }

Elementos de Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

ManifestURI

O URL assinado do Amazon S3 para o arquivo de manifesto associado ao valor de JobId especificado.

Tipo: sequência

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.024.

Padrão: .*

Erros

Para obter informações sobre os erros comuns a todas as ações, consulte Erros comuns.

InvalidJobStateException

A ação não pode ser executada porque o estado atual do trabalho não permite que essa ação seja executada.

Código de Status HTTP: 400

InvalidResourceException

Não foi possível encontrar o recurso especificado. Confira as informações fornecidas na última solicitação e tente novamente.

Código de Status HTTP: 400

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte: