UpdateJob - AWS Snowball Edge
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

nota

A partir de 7 de novembro de 2025, AWS Snowball Edge estará disponível somente para clientes existentes. Se você gostaria de usar AWS Snowball Edge, inscreva-se antes dessa data. Novos clientes devem explorar AWS DataSynctransferências on-line, o AWS Data Transfer Terminal para transferências físicas seguras ou soluções de AWS parceiros. Para computação de ponta, explore AWS Outposts.

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 que são comuns em todas as ações, consulte Parâmetros comuns.

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

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 e NFS (Network File System).

Tipo: objeto OnDeviceServiceConfiguration

Obrigatório: Não

PickupDetails
nota

A partir de 7 de novembro de 2025, AWS Snowball Edge estará disponível somente para clientes existentes. Se você gostaria de usar AWS Snowball Edge, inscreva-se antes dessa data. Novos clientes devem explorar AWS DataSynctransferências on-line, o AWS Data Transfer Terminal para transferências físicas seguras ou soluções de AWS parceiros. Para computação de ponta, explore AWS Outposts.

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

O nome de recurso da Amazon (ARN) da nova função que você deseja associar a esse trabalho. Para criar um ARN de função, use a ação da API 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 reenviará uma resposta 200 HTTP com um corpo HTTP 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.

Código de status HTTP: 400

Ec2RequestFailedException

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

Código de status HTTP: 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.

Código de status HTTP: 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.

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.

ResourceType

O valor do recurso fornecido é inválido.

Código de status HTTP: 400

KMSRequestFailedException

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

Código de Status HTTP: 400

Consulte Também

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: