Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # UpdateJob Lorsque la`JobState` valeur d'une tâche est`New`, vous pouvez mettre à jour certaines informations associées à une tâche. Une fois que la tâche change d'état, généralement dans les 60 minutes suivant sa création, cette action n'est plus disponible. ## Syntaxe de la requête ``` { "AddressId": "string", "Description": "string", "ForwardingAddressId": "string", "JobId": "string", "Notification": { "JobStatesToNotify": [ "string" ], "NotifyAll": boolean, "SnsTopicARN": "string" }, "OnDeviceServiceConfiguration": { "EKSOnDeviceService": { "EKSAnywhereVersion": "string", "KubernetesVersion": "string" }, "NFSOnDeviceService": { "StorageLimit": number, "StorageUnit": "string" }, "TGWOnDeviceService": { "StorageLimit": number, "StorageUnit": "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" } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres communs à toutes les actions, voir [Paramètres communs](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [AddressId](#API_UpdateJob_RequestSyntax) ** L'ID de l'[Address](API_Address.md)objet mis à jour. Type : String Contraintes de longueur : longueur fixe de 40. Modèle : `ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` Obligatoire : non ** [Description](#API_UpdateJob_RequestSyntax) ** Description mise à jour de l'[JobMetadata](API_JobMetadata.md)objet de cette tâche. Type : String Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 1024. Modèle : `.*` Obligatoire : non ** [ForwardingAddressId](#API_UpdateJob_RequestSyntax) ** Ce champ n'est pas pris en charge dans votre région. Type : String Contraintes de longueur : longueur fixe de 40. Modèle : `ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` Obligatoire : non ** [JobId](#API_UpdateJob_RequestSyntax) ** L'ID de la tâche que vous souhaitez mettre à jour, par exemple`JID123e4567-e89b-12d3-a456-426655440000`. Type : String Contraintes de longueur : longueur fixe de 39. Modèle : `(M|J)ID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` Obligatoire : oui ** [Notification](#API_UpdateJob_RequestSyntax) ** L'[Notification](API_Notification.md)objet nouveau ou mis à jour. Type : objet [Notification](API_Notification.md) Obligatoire : non ** [OnDeviceServiceConfiguration](#API_UpdateJob_RequestSyntax) ** Spécifie le ou les services de l'appareil Snow Family à partir desquels les données transférées seront exportées ou importées. AWS Snow Family prend en charge Amazon S3 et NFS (Network File System) ainsi que le serviceAWS Storage Gateway de type Tape Gateway. Type : objet [OnDeviceServiceConfiguration](API_OnDeviceServiceConfiguration.md) Obligatoire : non ** [Resources](#API_UpdateJob_RequestSyntax) ** L'`JobResource`objet mis à jour, ou l'[JobResource](API_JobResource.md)objet mis à jour. Type : objet [JobResource](API_JobResource.md) Obligatoire : non ** [RoleARN](#API_UpdateJob_RequestSyntax) ** Le nouveau rôle Amazon (ARN) que vous souhaitez associer à cette tâche. Pour créer un ARN de rôle, utilisez l'action d'API [CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html)Gestion des identités et des accès AWS(IAM). Type : String Contraintes de longueur : longueur maximale de 255. Modèle : `arn:aws.*:iam::[0-9]{12}:role/.*` Obligatoire : non ** [ShippingOption](#API_UpdateJob_RequestSyntax) ** La valeur de l'option d'expédition mise à jour de l'[ShippingDetails](API_ShippingDetails.md)objet de cette tâche. Type : String Valeurs valides :` SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD` Obligatoire : non ** [SnowballCapacityPreference](#API_UpdateJob_RequestSyntax) ** La mise à jour`SnowballCapacityPreference` de l'[JobMetadata](API_JobMetadata.md)objet de cette tâche. Les Snowfailed. Pour plus d'informations sur les types d'appareils de la [famille Snow, consultez les sections Appareils et capacités](https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html) de la famille [Snow dans le *guide de l'utilisateur Snowcone* ou Appareils et capacités de la famille Snow](https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html) dans le *guide de l'utilisateur Snowball Edge*. Type : String Valeurs valides :` T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference` Obligatoire : non ## Éléments de réponse Si l'action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide. ## Erreurs Pour plus d'informations sur les erreurs communes à toutes les actions, consultez[Erreurs courantes](CommonErrors.md). ** ClusterLimitExceededException ** Job création failed Actuellement, les clusters prennent en charge cinq nœuds. Si vous avez moins de cinq nœuds pour votre cluster et que vous avez d'autres nœuds à créer pour ce cluster, réessayez et créez des tâches jusqu'à ce que votre cluster compte exactement cinq nœuds. Code d'état HTTP : 400 ** Ec2RequestFailedException ** Votre utilisateur IAM ne dispose pas des autorisations Amazon EC2 nécessaires pour effectuer l'action tentée. Code d'état HTTP : 400 ** InvalidInputCombinationException ** La création failed Une ou plusieurs entrées n'étaient pas valides. Vérifiez que laSnowballType valeur [CreateCluster:](API_CreateCluster.md#Snowball-CreateCluster-request-SnowballType) est compatible avec votre [CreateJob:JobType](API_CreateJob.md#Snowball-CreateJob-request-JobType), puis réessayez. Code d'état HTTP : 400 ** InvalidJobStateException ** L'action ne peut pas être exécutée car l'état actuel de la tâche ne permet pas d'effectuer cette action. Code d'état HTTP : 400 ** InvalidResourceException ** La ressource spécifiée est introuvable. Vérifiez les informations que vous avez fournies dans la dernière requête, et réessayez. Code d'état HTTP : 400 ** KMSRequestFailedException ** LaAWS Key Management Service clé fournie ne dispose pas des autorisations nécessaires pour exécuter l'[UpdateJob](#API_UpdateJob)action[CreateJob](API_CreateJob.md) ou l'action spécifiée. Code d'état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes : + [Interface de ligne de commande AWS](https://docs.aws.amazon.com/goto/aws-cli/snowball-2016-06-30/UpdateJob) + [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/snowball-2016-06-30/UpdateJob) + [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/UpdateJob) + [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/snowball-2016-06-30/UpdateJob) + [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/UpdateJob) + [AWSSDK pour JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/snowball-2016-06-30/UpdateJob) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/UpdateJob) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/UpdateJob) + [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/UpdateJob)