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. # CreateCluster Erstellt einen leeren Cluster Jeder Cluster unterstützt fünf Knoten. Sie verwenden die[CreateJob](API_CreateJob.md) Aktion separat, um die Jobs für jeden dieser Knoten zu erstellen. Der Cluster wird erst ausgeliefert, wenn diese fünf Knotenjobs erstellt wurden. ## Anforderungssyntax ``` { "AddressId": "string", "Description": "string", "ForwardingAddressId": "string", "JobType": "string", "KmsKeyARN": "string", "Notification": { "JobStatesToNotify": [ "string" ], "NotifyAll": boolean, "SnsTopicARN": "string" }, "OnDeviceServiceConfiguration": { "EKSOnDeviceService": { "EKSAnywhereVersion": "string", "KubernetesVersion": "string" }, "NFSOnDeviceService": { "StorageLimit": number, "StorageUnit": "string" }, "TGWOnDeviceService": { "StorageLimit": number, "StorageUnit": "string" } }, "RemoteManagement": "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", "SnowballType": "string", "TaxDocuments": { "IND": { "GSTIN": "string" } } } ``` ## Anfrageparameter 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_CreateCluster_RequestSyntax) ** Die ID für die Adresse, an die der Cluster versendet werden soll. Typ: Zeichenfolge Längenbeschränkungen: Feste Länge von 40. Pattern: `ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` Erforderlich: Ja ** [Description](#API_CreateCluster_RequestSyntax) ** Zum Beispiel eine optionale Beschreibung dieses spezifischen Clusters`Environmental Data Cluster-01`. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 1024 Zeichen. Pattern: `.*` Erforderlich: Nein ** [ForwardingAddressId](#API_CreateCluster_RequestSyntax) ** Dieses Feld wird in Ihrer Region nicht unterstützt. Typ: Zeichenfolge Längenbeschränkungen: Feste Länge von 40. Pattern: `ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` Erforderlich: Nein ** [JobType](#API_CreateCluster_RequestSyntax) ** Den Typen Typen Typen Typen Typen Derzeit wird für Cluster nur der Auftragstyp unterstützt`LOCAL_USE`. Informationen zu den Gerätetypen von Snow Family finden Sie unter [Geräte und Kapazitäten von Snow Family](https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html) im *Snowcone-Benutzerhandbuch* oder [Snow Family-Geräte und Kapazitäten](https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html) im *Snowball Edge-Benutzerhandbuch*. Typ: Zeichenfolge Zulässige Werte:` IMPORT | EXPORT | LOCAL_USE` Erforderlich: Ja ** [KmsKeyARN](#API_CreateCluster_RequestSyntax) ** Der`KmsKeyARN` Wert, den Sie mit diesem Cluster verknüpfen möchten. `KmsKeyARN`Werte werden mithilfe der [CreateKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html)API-Aktion inAWS Key Management Service (AWS KMS) erstellt. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge von 255. Pattern: `arn:aws.*:kms:.*:[0-9]{12}:key/.*` Erforderlich: Nein ** [Notification](#API_CreateCluster_RequestSyntax) ** Die Die Amazon Simple Notification Service (Amazon SNS) -Themaa-Einstellungen für diesen Cluster. Typ: [Notification](API_Notification.md) Objekt Required: No ** [OnDeviceServiceConfiguration](#API_CreateCluster_RequestSyntax) ** 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 ** [RemoteManagement](#API_CreateCluster_RequestSyntax) ** Ermöglicht den sicheren Betrieb und die Verwaltung von Snow-Geräten in einem Cluster aus der Ferne von außerhalb Ihres internen Netzwerks. Wenn diese Option aktiviert ist`INSTALLED_AUTOSTART`, ist die Fernverwaltung automatisch verfügbar, wenn das Gerät an Ihrem Standort ankommt. Andernfalls müssen Sie den Snowball Client verwenden, um das Gerät zu verwalten. Typ: Zeichenfolge Zulässige Werte:` INSTALLED_ONLY | INSTALLED_AUTOSTART` Required: No ** [Resources](#API_CreateCluster_RequestSyntax) ** Die Ressourcen, die mit dem Typen der Cluster-Job. Zu diesen Ressourcen gehören Amazon S3 S3-Buckets und optionaleAWS Lambda Funktionen, die in der Python-Sprache geschrieben sind. Typ: [JobResource](API_JobResource.md) Objekt Erforderlich: Ja ** [RoleARN](#API_CreateCluster_RequestSyntax) ** Den`RoleARN` Typen, den Sie mit diesem Cluster verknüpfen möchten. `RoleArn`Werte werden mithilfe der [CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html)API-Aktion inAWS Identity and Access Management (IAM) erstellt. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge von 255. Pattern: `arn:aws.*:iam::[0-9]{12}:role/.*` Erforderlich: Ja ** [ShippingOption](#API_CreateCluster_RequestSyntax) ** Die Versandgeschwindigkeit für jeden Knoten in diesem Cluster. Diese Geschwindigkeit bestimmt nicht, wie schnell Sie jedes Snowball Edge-Gerät erhalten, sondern gibt an, wie schnell sich jedes Gerät während des Transports an sein Ziel bewegt. Die regionalen Versandgeschwindigkeiten sind wie folgt: + In Australien haben Sie Zugang zum Expressversand. In der Regel werden Snow-Geräte, die per Express versendet werden, in etwa einem Tag geliefert. + In der Europäischen Union (EU) haben Sie Zugang zum Expressversand. In der Regel werden Snow-Geräte, die per Express versendet werden, in etwa einem Tag geliefert. Außerdem ist in den meisten EU-Ländern der Standardversand möglich. In der Regel dauert dieser für einen Weg weniger als eine Woche. + In Indien werden Snow-Geräte in ein bis sieben Tagen geliefert. + In den Vereinigten Staaten von Amerika (USA) haben Sie Zugriff auf eintägigen Versand und zweitägigen Versand. + In Australien haben Sie Zugang zum Expressversand. In der Regel werden Geräte, die per Express versendet werden, in etwa einem Tag geliefert. + In der Europäischen Union (EU) haben Sie Zugang zum Expressversand. In der Regel werden Snow-Geräte, die per Express versendet werden, in etwa einem Tag geliefert. Außerdem ist in den meisten EU-Ländern der Standardversand möglich. In der Regel dauert dieser für einen Weg weniger als eine Woche. + In Indien werden Snow-Geräte in ein bis sieben Tagen geliefert. + In den USA haben Sie Zugriff auf eintägigen Versand und zweitägigen Versand. Typ: Zeichenfolge Zulässige Werte:` SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD` Erforderlich: Ja ** [SnowballType](#API_CreateCluster_RequestSyntax) ** Der Typ der Snow Family-Geräte, die für diesen Cluster verwendet werden sollen. Für Cluster-Jobs unterstütztAWS Snow Family derzeit nur den`EDGE` Gerätetyp. Informationen zu den Gerätetypen von Snow Family finden Sie unter [Geräte und Kapazitäten von Snow Family](https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html) im *Snowcone-Benutzerhandbuch* oder [Snow Family-Geräte und Kapazitäten](https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html) im *Snowball Edge-Benutzerhandbuch*. Typ: Zeichenfolge Zulässige Werte:` STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD | V3_5C` Erforderlich: Ja ** [TaxDocuments](#API_CreateCluster_RequestSyntax) ** Die Steuerdokumente, die in Ihrem erforderlich sindAWS-Region. Typ: [TaxDocuments](API_TaxDocuments.md) Objekt Erforderlich: Nein ## Antwortsyntax ``` { "ClusterId": "string" } ``` ## Antwortelemente Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück. Die folgenden Daten werden vom Service im JSON-Format zurückgegeben. ** [ClusterId](#API_CreateCluster_ResponseSyntax) ** Die automatisch generierte ID für einen Cluster. Typ: Zeichenfolge Längenbeschränkungen: Feste Länge von 39. Pattern: `CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` ## Fehler 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 ** Job Typen Typen Typen Typen Typen Typen Typen Typen Eine oder mehrere Eingaben waren ungültig. Vergewissern Sie sich, dass derSnowballType Wert [CreateCluster:](#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 ** 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) ODER-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](https://docs.aws.amazon.com/goto/aws-cli/snowball-2016-06-30/CreateCluster) + [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/snowball-2016-06-30/CreateCluster) + [AWS-SDK für C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/CreateCluster) + [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/snowball-2016-06-30/CreateCluster) + [AWS-SDK für Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/CreateCluster) + [AWSSDK für JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/snowball-2016-06-30/CreateCluster) + [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/CreateCluster) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/CreateCluster) + [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/CreateCluster)