CreateCluster - AWS Snowball
AnforderungssyntaxAnfrageparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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 dieCreateJob 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.

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

AddressId

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

Zum Beispiel eine optionale Beschreibung dieses spezifischen ClustersEnvironmental Data Cluster-01.

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 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

Den Typen Typen Typen Typen Typen Derzeit wird für Cluster nur der Auftragstyp unterstütztLOCAL_USE.

Informationen zu den Gerätetypen von Snow Family finden Sie unter Geräte und Kapazitäten von Snow Family im Snowcone-Benutzerhandbuch oder Snow Family-Geräte und Kapazitäten im Snowball Edge-Benutzerhandbuch.

Typ: Zeichenfolge

Zulässige Werte: IMPORT | EXPORT | LOCAL_USE

Erforderlich: Ja

KmsKeyARN

DerKmsKeyARN Wert, den Sie mit diesem Cluster verknüpfen möchten. KmsKeyARNWerte werden mithilfe der CreateKeyAPI-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

Die Die Amazon Simple Notification Service (Amazon SNS) -Themaa-Einstellungen für diesen Cluster.

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

RemoteManagement

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 istINSTALLED_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

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 Objekt

Erforderlich: Ja

RoleARN

DenRoleARN Typen, den Sie mit diesem Cluster verknüpfen möchten. RoleArnWerte werden mithilfe der CreateRoleAPI-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

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

Der Typ der Snow Family-Geräte, die für diesen Cluster verwendet werden sollen.

Anmerkung

Für Cluster-Jobs unterstütztAWS Snow Family derzeit nur denEDGE Gerätetyp.

Informationen zu den Gerätetypen von Snow Family finden Sie unter Geräte und Kapazitäten von Snow Family im Snowcone-Benutzerhandbuch oder Snow Family-Geräte und Kapazitäten 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

Die Steuerdokumente, die in Ihrem erforderlich sindAWS-Region.

Typ: TaxDocuments 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

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 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

Job Typen Typen Typen Typen Typen Typen Typen Typen 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

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 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: