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** AWS Snowball Edge não está mais disponível para novos clientes. Novos clientes devem explorar [AWS DataSync](https://aws.amazon.com/datasync/)transferências on-line, o [Terminal de Transferência de AWS Dados](https://aws.amazon.com/data-transfer-terminal/) para transferências físicas seguras ou soluções de AWS parceiros. Para computação de ponta, explore [AWS Outposts](https://aws.amazon.com/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](CommonParameters.md). A solicitação aceita os dados a seguir no formato JSON. ** [AddressId](#API_UpdateJob_RequestSyntax) ** O ID do objeto [Address](API_Address.md) 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](#API_UpdateJob_RequestSyntax) ** A descrição atualizada do objeto [JobMetadata](API_JobMetadata.md) desse trabalho. Tipo: string Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 1.024. Padrão: `.*` Obrigatório: não ** [ForwardingAddressId](#API_UpdateJob_RequestSyntax) ** 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](#API_UpdateJob_RequestSyntax) ** 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}` Obrigatório: Sim ** [Notification](#API_UpdateJob_RequestSyntax) ** O objeto [Notification](API_Notification.md) novo ou atualizado. Tipo: objeto [Notification](API_Notification.md) Obrigatório: não ** [OnDeviceServiceConfiguration](#API_UpdateJob_RequestSyntax) ** 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](API_OnDeviceServiceConfiguration.md) Obrigatório: não ** [PickupDetails](#API_UpdateJob_RequestSyntax) ** AWS Snowball Edge não está mais disponível para novos clientes. Novos clientes devem explorar [AWS DataSync](https://aws.amazon.com/datasync/)transferências on-line, o [Terminal de Transferência de AWS Dados](https://aws.amazon.com/data-transfer-terminal/) para transferências físicas seguras ou soluções de AWS parceiros. Para computação de ponta, explore [AWS Outposts](https://aws.amazon.com/outposts/). Informações que identificam a pessoa que está retirando o dispositivo. Tipo: objeto [PickupDetails](API_PickupDetails.md) Obrigatório: não ** [Resources](#API_UpdateJob_RequestSyntax) ** O objeto `JobResource` atualizado ou o objeto [JobResource](API_JobResource.md) atualizado. Tipo: objeto [JobResource](API_JobResource.md) Obrigatório: não ** [RoleARN](#API_UpdateJob_RequestSyntax) ** 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](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html) 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](#API_UpdateJob_RequestSyntax) ** O valor atualizado da opção de envio do objeto [ShippingDetails](API_ShippingDetails.md) desse trabalho. Tipo: string Valores válidos: `SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD` Obrigatório: não ** [SnowballCapacityPreference](#API_UpdateJob_RequestSyntax) ** A `SnowballCapacityPreference` atualizada do objeto [JobMetadata](API_JobMetadata.md) desse trabalho. Para obter informações sobre os tipos de dispositivos do Snowball Edge, consulte [Informações de hardware do dispositivo no Guia](https://docs.aws.amazon.com/snowball/latest/developer-guide/device-differences.html) 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 informações sobre os erros comuns retornados pelas ações, consulte [Tipos de erro comuns](CommonErrors.md). ** 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:](API_CreateCluster.md#Snowball-CreateCluster-request-SnowballType) é compatível com seu [CreateJob: JobType](API_CreateJob.md#Snowball-CreateJob-request-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 [UpdateJob](#API_UpdateJob) ação [CreateJob](API_CreateJob.md) ou a 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: + [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/snowball-2016-06-30/UpdateJob) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/snowball-2016-06-30/UpdateJob) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/UpdateJob) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/snowball-2016-06-30/UpdateJob) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/UpdateJob) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snowball-2016-06-30/UpdateJob) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/snowball-2016-06-30/UpdateJob) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/UpdateJob) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/UpdateJob) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/UpdateJob)