UpdateCluster

Während der Status eines Clusters inClusterState ClusterAstatus inAwaitingQuorum ClusterState Ain ClusterAeines Clusters in ClusterState Ain ClusterAeines Clusters in ClusterState Ain ClusterState A Sobald der Cluster in einen anderen Auftragsstatus wechselt, normalerweise 60 Minuten nach der Erstellung des Clusters, ist diese Aktion nicht mehr verfügbar.

Anforderungssyntax

{
   "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"
}

Anfrageparameter

Informationen zu den Parametern, die allen Aktionen gemeinsam sind, finden Sie unter Allgemeine Parameter.

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

AddressId

Die ID des aktualisiertenAddress Objekts.

Typ: Zeichenfolge

Längenbeschränkungen: Feste Länge von Feste Länge von Feste Länge von Feste Länge von Feste

Pattern: ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Erforderlich: Nein

ClusterId

Die ClusterID des Clusters, die Sie aktualisieren möchten, zum BeispielCID123e4567-e89b-12d3-a456-426655440000.

Typ: Zeichenfolge

Längenbeschränkungen: Feste Länge von Feste Länge von Feste Länge von Feste Länge von Feste

Pattern: CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Erforderlich: Ja

Description

Die aktualisierte Beschreibung dieses Clusters.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 1024 Zeichen.

Pattern: .*

Erforderlich: Nein

ForwardingAddressId

Dieses Feld wird in Ihrer Region nicht unterstützt.

Typ: Zeichenfolge

Längenbeschränkungen: Feste Länge von Feste Länge von Feste Länge von Feste Länge von Feste

Pattern: ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Erforderlich: Nein

Notification

Das neue oder aktualisierteNotification Objekt.

Typ: Notification Objekt

Required: No

OnDeviceServiceConfiguration

Gibt den Dienst oder die Dienste auf dem Snow Family-Gerät an, aus denen Ihre übertragenen Daten exportiert oder in die Sie importiert werden. AWS Die Gerätecluster von Snow Family unterstützen Amazon S3 und NFS (Network File System).

Typ: OnDeviceServiceConfiguration Objekt

Required: No

Resources

Die aktualisierten Anordnungen vonJobResource Objekten, die aktualisierteS3Resource Objekte oderLambdaResource Objekte enthalten können.

Typ: JobResource Objekt

Required: No

RoleARN

Die neue Amazon-Ressourcenname (ARN), die Sie dem Cluster verknüpfen möchten. Verwenden Sie die CreateRoleAPI-Aktion inAWS Identity and Access Management (IAM), um einen Rollen-ARN zu erstellen.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 255.

Pattern: arn:aws.*:iam::[0-9]{12}:role/.*

Erforderlich: Nein

ShippingOption

Der aktualisierte Versandoptionswert desShippingDetails Objekts dieses Clusters.

Typ: Zeichenfolge

Zulässige Werte: SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD

Required: No

Antwortelemente

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.

Fehler

Hinweise zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unterHäufige Fehler.

Ec2RequestFailedException

Ihrem IAM-Benutzer fehlen die erforderlichen Amazon EC2 EC2-Berechtigungen, um die versuchte Aktion auszuführen.

HTTP Status Code: 400

InvalidInputCombinationException

Die Erstellung eines Auftrags oder Clusters ist fehlgeschlagen. Eine oder mehrere Eingaben waren ungültig. Vergewissern Sie sich, dass derSnowballType Wert CreateCluster: Ihren CreateJob: -Wert unterstütztJobType, und versuchen Sie es erneut.

HTTP Status Code: 400

InvalidJobStateException

Die Aktion kann nicht ausgeführt werden, da der aktuelle Status des Jobs die Ausführung dieser Aktion nicht zulässt.

HTTP Status Code: 400

InvalidResourceException

Die angegebene Ressource kann nicht gefunden werden. Überprüfen Sie die Informationen, die Sie in Ihrer letzten Anfrage angegeben haben, und versuchen Sie es erneut.

HTTP Status Code: 400

KMSRequestFailedException

Dem bereitgestelltenAWS Key Management Service Schlüssel fehlen die Berechtigungen, um die angegebeneCreateJobUpdateJob OR-Aktion auszuführen.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter:

• AWS-Befehlszeilenschnittstelle

• AWS-SDK für .NET

• AWS-SDK für C++

• AWS-SDK for Go

• AWS-SDK für Java V2

• AWSSDK für JavaScript

• AWS SDK für PHP V3

• AWS SDK für Python

• AWS SDK für Ruby V3