

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# UpdateCluster
<a name="API_UpdateCluster"></a>

Während der Status eines Clusters in`ClusterState` ClusterAstatus in`AwaitingQuorum` 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
<a name="API_UpdateCluster_RequestSyntax"></a>

```
{
   "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
<a name="API_UpdateCluster_RequestParameters"></a>

Informationen zu den Parametern, die allen Aktionen gemeinsam sind, finden Sie unter [Allgemeine Parameter](CommonParameters.md).

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [AddressId](#API_UpdateCluster_RequestSyntax) **   <a name="Snowball-UpdateCluster-request-AddressId"></a>
Die ID des aktualisierten[Address](API_Address.md) 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](#API_UpdateCluster_RequestSyntax) **   <a name="Snowball-UpdateCluster-request-ClusterId"></a>
Die ClusterID des Clusters, die Sie aktualisieren möchten, zum Beispiel`CID123e4567-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](#API_UpdateCluster_RequestSyntax) **   <a name="Snowball-UpdateCluster-request-Description"></a>
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](#API_UpdateCluster_RequestSyntax) **   <a name="Snowball-UpdateCluster-request-ForwardingAddressId"></a>
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](#API_UpdateCluster_RequestSyntax) **   <a name="Snowball-UpdateCluster-request-Notification"></a>
Das neue oder aktualisierte[Notification](API_Notification.md) Objekt.  
Typ: [Notification](API_Notification.md) Objekt  
Required: No

 ** [OnDeviceServiceConfiguration](#API_UpdateCluster_RequestSyntax) **   <a name="Snowball-UpdateCluster-request-OnDeviceServiceConfiguration"></a>
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](API_OnDeviceServiceConfiguration.md) Objekt  
Required: No

 ** [Resources](#API_UpdateCluster_RequestSyntax) **   <a name="Snowball-UpdateCluster-request-Resources"></a>
Die aktualisierten Anordnungen von[JobResource](API_JobResource.md) Objekten, die aktualisierte[S3Resource](API_S3Resource.md) Objekte oder[LambdaResource](API_LambdaResource.md) Objekte enthalten können.  
Typ: [JobResource](API_JobResource.md) Objekt  
Required: No

 ** [RoleARN](#API_UpdateCluster_RequestSyntax) **   <a name="Snowball-UpdateCluster-request-RoleARN"></a>
Die neue Amazon-Ressourcenname (ARN), die Sie dem Cluster verknüpfen möchten. Verwenden Sie die [CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html)API-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](#API_UpdateCluster_RequestSyntax) **   <a name="Snowball-UpdateCluster-request-ShippingOption"></a>
Der aktualisierte Versandoptionswert des[ShippingDetails](API_ShippingDetails.md) Objekts dieses Clusters.  
Typ: Zeichenfolge  
Zulässige Werte:` SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD`   
Required: No

## Antwortelemente
<a name="API_UpdateCluster_ResponseElements"></a>

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

## Fehler
<a name="API_UpdateCluster_Errors"></a>

Hinweise zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unter[Häufige Fehler](CommonErrors.md).

 ** 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:](API_CreateCluster.md#Snowball-CreateCluster-request-SnowballType) Ihren [CreateJob:](API_CreateJob.md#Snowball-CreateJob-request-JobType) -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 angegebene[CreateJob](API_CreateJob.md)[UpdateJob](API_UpdateJob.md) OR-Aktion auszuführen.  
HTTP Status Code: 400

## Weitere Informationen finden Sie unter:
<a name="API_UpdateCluster_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter:
+  [AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/goto/aws-cli/snowball-2016-06-30/UpdateCluster) 
+  [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/snowball-2016-06-30/UpdateCluster) 
+  [AWS-SDK für C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/UpdateCluster) 
+  [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/snowball-2016-06-30/UpdateCluster) 
+  [AWS-SDK für Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/UpdateCluster) 
+  [AWSSDK für JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/snowball-2016-06-30/UpdateCluster) 
+  [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/UpdateCluster) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/UpdateCluster) 
+  [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/UpdateCluster) 