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. # UpdateCluster Lorsque la`ClusterState` valeur d'un cluster est à l'`AwaitingQuorum`état Ad., vous pouvez mettre à jour certaines informations associées à un cluster. Une fois que le cluster passe à un autre état de tâche, généralement 60 minutes après sa création, cette action n'est plus disponible. ## Syntaxe de la requête ``` { "AddressId": "string", "ClusterId": "string", "Description": "string", "ForwardingAddressId": "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" } ``` ## 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_UpdateCluster_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 ** [ClusterId](#API_UpdateCluster_RequestSyntax) ** ID du cluster que vous souhaitez mettre à jour, par exemple`CID123e4567-e89b-12d3-a456-426655440000`. Type : String Contraintes de longueur : longueur fixe de 39. Modèle : `CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` Obligatoire : oui ** [Description](#API_UpdateCluster_RequestSyntax) ** Description mise à jour de ce cluster. Type : String Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 1024. Modèle : `.*` Obligatoire : non ** [ForwardingAddressId](#API_UpdateCluster_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 ** [Notification](#API_UpdateCluster_RequestSyntax) ** L'[Notification](API_Notification.md)objet nouveau ou mis à jour. Type : objet [Notification](API_Notification.md) Obligatoire : non ** [OnDeviceServiceConfiguration](#API_UpdateCluster_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 Les clusters d'appareils de la famille Snow prennent en charge Amazon S3 et NFS (Network File System). Type : objet [OnDeviceServiceConfiguration](API_OnDeviceServiceConfiguration.md) Obligatoire : non ** [Resources](#API_UpdateCluster_RequestSyntax) ** Les tableaux d'[JobResource](API_JobResource.md)objets mis à jour qui peuvent inclure des[S3Resource](API_S3Resource.md) objets ou[LambdaResource](API_LambdaResource.md) des objets mis à jour. Type : objet [JobResource](API_JobResource.md) Obligatoire : non ** [RoleARN](#API_UpdateCluster_RequestSyntax) ** Nouveau rôle Amazon Resource Name (ARN) que vous souhaitez associer à ce cluster. Pour créer un ARN de rôle, utilisez l'action d'[CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html)API dansGestion 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_UpdateCluster_RequestSyntax) ** La valeur de l'option d'expédition mise à jour de l'[ShippingDetails](API_ShippingDetails.md)objet de ce cluster. Type : String Valeurs valides :` SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD` 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). ** 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 d'un job ou d'un cluster a échoué. 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 lors de votre 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.md)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/UpdateCluster) + [AWS SDK pour .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/snowball-2016-06-30/UpdateCluster) + [Kit AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/UpdateCluster) + [Kit AWS SDK pour Go](https://docs.aws.amazon.com/goto/SdkForGoV1/snowball-2016-06-30/UpdateCluster) + [Kit SDK AWS pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/UpdateCluster) + [AWSSDK pour JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/snowball-2016-06-30/UpdateCluster) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/UpdateCluster) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/UpdateCluster) + [Kit SDK AWS pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/UpdateCluster)