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

GetJobUnlockCode

Importante

Aviso de fim do suporte: em 12 de novembro de 2024, AWS descontinuaremos os dispositivos Snowball AWS da geração anterior e os dispositivos Snowcone (e). HDD SDD Continuaremos oferecendo suporte aos clientes existentes que usam esses end-of-life dispositivos até 12 de novembro de 2025. Os dispositivos AWS Snowball de última geração estão disponíveis para todos os clientes. Veja esta postagem em blog para obter mais informações.

Retorna o valor do código UnlockCode do trabalho especificado. Um valor de UnlockCode específico pode ser acessado por até 360 dias após a criação do trabalho associado.

O valor de UnlockCode é um código de 29 caracteres com 25 caracteres alfanuméricos e 4 hifens. Esse código é utilizado para descriptografar o arquivo de manifesto quando é fornecido junto com o manifesto para o dispositivo Snow por meio do cliente Snowball quando o cliente é iniciado pela primeira vez. O único status válido para chamar isso API é WithCustomer porque os valores do manifesto e Unlock do código são usados para proteger seu dispositivo e só devem ser usados quando você tem o dispositivo.

Como melhores práticas, recomendamos não salvar uma cópia do 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.

Sintaxe da Solicitação

{ "JobId": "string" }

Parâmetros da solicitação

Para obter informações sobre os parâmetros comuns a todas as ações, consulte Parâmetros Comuns.

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

JobId

O ID do trabalho para o qual você deseja obter o valor de UnlockCode, por exemplo, JID123e4567-e89b-12d3-a456-426655440000.

Tipo: string

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

{ "UnlockCode": "string" }

Elementos de Resposta

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

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

UnlockCode

O valor de UnlockCode do trabalho especificado. O valor de UnlockCode pode ser acessado por até 360 dias após a criação do trabalho.

Tipo: string

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 retornados pelas 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.

HTTPCódigo de status: 400

InvalidResourceException

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

HTTPCódigo de status: 400

Consulte também

Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: