UpdateJob - AWS Snowball
Sintaxe da SolicitaçãoParâmetros da solicitaçãoElementos de RespostaErrosConsulte também

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

UpdateJob

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.

Enquanto um valor de JobState de um trabalho é New, você pode atualizar algumas das informações associadas a um trabalho. Quando o trabalho muda para um estado de trabalho diferente, geralmente 60 minutos após a criação do trabalho, essa ação não está mais disponível.

Sintaxe da Solicitação

{
   "AddressId": "string",
   "Description": "string",
   "ForwardingAddressId": "string",
   "JobId": "string",
   "Notification": { 
      "DevicePickupSnsTopicARN": "string",
      "JobStatesToNotify": [ "string" ],
      "NotifyAll": boolean,
      "SnsTopicARN": "string"
   },
   "OnDeviceServiceConfiguration": { 
      "EKSOnDeviceService": { 
         "EKSAnywhereVersion": "string",
         "KubernetesVersion": "string"
      },
      "NFSOnDeviceService": { 
         "StorageLimit": number,
         "StorageUnit": "string"
      },
      "S3OnDeviceService": { 
         "FaultTolerance": number,
         "ServiceSize": number,
         "StorageLimit": number,
         "StorageUnit": "string"
      },
      "TGWOnDeviceService": { 
         "StorageLimit": number,
         "StorageUnit": "string"
      }
   },
   "PickupDetails": { 
      "DevicePickupId": "string",
      "Email": "string",
      "IdentificationExpirationDate": number,
      "IdentificationIssuingOrg": "string",
      "IdentificationNumber": "string",
      "Name": "string",
      "PhoneNumber": "string"
   },
   "Resources": { 
      "Ec2AmiResources": [ 
         { 
            "AmiId": "string",
            "SnowballAmiId": "string"
         }
      ],
      "LambdaResources": [ 
         { 
            "EventTriggers": [ 
               { 
                  "EventResourceARN": "string"
               }
            ],
            "LambdaArn": "string"
         }
      ],
      "S3Resources": [ 
         { 
            "BucketArn": "string",
            "KeyRange": { 
               "BeginMarker": "string",
               "EndMarker": "string"
            },
            "TargetOnDeviceServices": [ 
               { 
                  "ServiceName": "string",
                  "TransferOption": "string"
               }
            ]
         }
      ]
   },
   "RoleARN": "string",
   "ShippingOption": "string",
   "SnowballCapacityPreference": "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.

AddressId

O ID do objeto Address atualizado.

Tipo: string

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

Padrão: ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Obrigatório: não

Description

A descrição atualizada do objeto JobMetadata desse trabalho.

Tipo: string

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

Padrão: .*

Obrigatório: não

ForwardingAddressId

Esse campo não é compatível com a sua região.

Tipo: string

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

Padrão: ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Obrigatório: não

JobId

O ID do trabalho que você deseja atualizar, 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

Notification

O objeto Notification novo ou atualizado.

Tipo: objeto Notification

Obrigatório: não

OnDeviceServiceConfiguration

Especifica o serviço ou serviços no dispositivo da família Snow dos quais seus dados transferidos serão exportados ou importados. AWS O Snowball Edge é compatível com Amazon S3 NFS e (Network File System).

Tipo: objeto OnDeviceServiceConfiguration

Obrigatório: não

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

Informações que identificam a pessoa que está retirando o dispositivo.

Tipo: objeto PickupDetails

Obrigatório: não

Resources

O objeto JobResource atualizado ou o objeto JobResource atualizado.

Tipo: objeto JobResource

Obrigatório: não

RoleARN

A nova função Amazon Resource Name (ARN) que você deseja associar a esse trabalho. Para criar uma funçãoARN, use a API ação CreateRole AWS Identity and Access Management (IAM).

Tipo: string

Restrições de tamanho: tamanho máximo de 255.

Padrão: arn:aws.*:iam::[0-9]{12}:role/.*

Obrigatório: não

ShippingOption

O valor atualizado da opção de envio do objeto ShippingDetails desse trabalho.

Tipo: string

Valores Válidos: SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD

Obrigatório: não

SnowballCapacityPreference

A SnowballCapacityPreference atualizada do objeto JobMetadata desse trabalho.

Para obter informações sobre os tipos de dispositivos do Snowball Edge, consulte Informações de hardware do dispositivo no Guia do desenvolvedor do Snowball Edge.

Tipo: string

Valores Válidos: T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13

Obrigatório: não

Elementos de Resposta

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

Erros

Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.

ClusterLimitExceededException

Assistente de criação de trabalho. Atualmente, os clusters oferecem suporte a cinco nós. Se você tiver menos de cinco nós para o seu cluster e precisar criar mais nós para este cluster, tente novamente e crie trabalhos até que seu cluster tenha exatamente cinco nós.

HTTPCódigo de status: 400

Ec2RequestFailedException

Seu usuário não tem as EC2 permissões necessárias da Amazon para realizar a tentativa de ação.

HTTPCódigo de status: 400

InvalidInputCombinationException

Falha na criação do trabalho ou do cluster. Uma ou mais entradas eram inválidas. Confirme se o SnowballType valor CreateCluster: suporta seu CreateJob: JobType e tente novamente.

HTTPCódigo de status: 400

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

KMSRequestFailedException

A AWS Key Management Service chave fornecida não tem as permissões para realizar a CreateJob UpdateJob ação especificada.

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: