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 laClusterState 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.
Cette demande accepte les données suivantes au format JSON.
- AddressId
-
L'ID de l'Addressobjet 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
-
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
-
Description mise à jour de ce cluster.
Type : String
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 1024.
Modèle :
.*Obligatoire : non
- ForwardingAddressId
-
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
-
L'Notificationobjet nouveau ou mis à jour.
Type : objet Notification
Obligatoire : non
- OnDeviceServiceConfiguration
-
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
Obligatoire : non
- Resources
-
Les tableaux d'JobResourceobjets mis à jour qui peuvent inclure desS3Resource objets ouLambdaResource des objets mis à jour.
Type : objet JobResource
Obligatoire : non
- RoleARN
-
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'CreateRoleAPI dansAWS Identity and Access Management (IAM).
Type : String
Contraintes de longueur : longueur maximale de 255.
Modèle :
arn:aws.*:iam::[0-9]{12}:role/.*Obligatoire : non
- ShippingOption
-
La valeur de l'option d'expédition mise à jour de l'ShippingDetailsobjet de ce cluster.
Type : String
Valeurs valides :
SECOND_DAY | NEXT_DAY | EXPRESS | STANDARDObligatoire : 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, consultezErreurs courantes.
- 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: est compatible avec votre CreateJob: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'UpdateJobactionCreateJob 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 :
