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

CreateJob

Erstellt einen Auftrag zum Importieren und Exportieren von Daten zwischen Amazon S3 und dem On-Premises-Rechenzentrum SieAWS-Konto müssen über die richtigen Vertrauensrichtlinien und Berechtigungen verfügen, um einen Job für ein Snow-Gerät zu erstellen. Wenn Sie einen Job für einen Knoten in einem Cluster erstellen, müssen Sie nur denclusterId Wert angeben. Die anderen Jobattribute werden vom Cluster übernommen.

Anmerkung

Bei der Bestellung von Clusteraufträgen wird nur der Snowball; Edge-Gerätetyp unterstützt.

Die Gerätekapazität ist optional.

Die Verfügbarkeit der Gerätetypen unterscheidet sich umAWS-Region. Weitere Informationen zur Regionsverfügbarkeit finden Sie unter AWSRegionale Dienste.

Snow Family-Geräte und ihre Kapazitäten.

  • Snow Family-Gerätetyp: SNC1_SSD

    • Kapazität: T14

    • Beschreibung: Snowcone

  • Snow Family Gerätetyp: SNC1_HDD

    • Kapazität: T8

    • Beschreibung: Snowcone

  • Gerätetyp: EDGE_S

    • Kapazität: T98

    • Beschreibung: Snowball Edge Storage Nur für die Datenübertragung optimiert

  • Gerätetyp: EDGE_CG

    • Kapazität: T42

    • Beschreibung: Snowball Edge Compute Optimized mit GPU

  • Gerätetyp: EDGE_C

    • Kapazität: T42

    • Beschreibung: Snowball Edge Compute Optimized ohne GPU

  • Gerätetyp: EDGE

    • Kapazität: T100

    • Beschreibung: Mit EC2 Compute Snowball Edge Storage Optimized

  • Gerätetyp: STANDARD

    • Kapazität: T50

    • Beschreibung: Original Snowball-Gerät

      Anmerkung

      Dieses Gerät ist nur in Ningxia, Peking und Singapur erhältlichAWS-Region

  • Gerätetyp: STANDARD

    • Kapazität: T80

    • Beschreibung: Original Snowball-Gerät

      Anmerkung

      Dieses Gerät ist nur in Ningxia, Peking und Singapur erhältlichAWS-Region.

Anforderungssyntax

{
   "AddressId": "string",
   "ClusterId": "string",
   "Description": "string",
   "DeviceConfiguration": { 
      "SnowconeDeviceConfiguration": { 
         "WirelessConnection": { 
            "IsWifiEnabled": boolean
         }
      }
   },
   "ForwardingAddressId": "string",
   "JobType": "string",
   "KmsKeyARN": "string",
   "LongTermPricingId": "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",
   "SnowballCapacityPreference": "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 das Snow-Gerät 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: Nein

ClusterId

Die ID eines Clusters. Wenn Sie einen Job für einen Knoten in einem Cluster erstellen, müssen Sie nur diesenclusterId Wert angeben. Die anderen Jobattribute werden vom Cluster vererbt.

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}

Erforderlich: Nein

Description

Definiert beispielsweise eine optionale Beschreibung dieses spezifischen JobsImportant Photos 2016-08-11.

Typ: Zeichenfolge

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

Pattern: .*

Erforderlich: Nein

DeviceConfiguration

Definiert die Gerätekonfiguration für einenAWS Snowcone Job.

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

Required: No

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

Definiert die Art eines Auftrags, den Sie erstellen.

Typ: Zeichenfolge

Zulässige Werte: IMPORT | EXPORT | LOCAL_USE

Required: No

KmsKeyARN

DieKmsKeyARN, die Sie diesem Job zuordnen KmsKeyARNs werden mit der API-Aktion CreateKeyAWS Key Management Service(KMS) erstellt.

Typ: Zeichenfolge

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

Pattern: arn:aws.*:kms:.*:[0-9]{12}:key/.*

Erforderlich: Nein

LongTermPricingId

Die ID des langfristigen Preistyps für das Gerät.

Typ: Zeichenfolge

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

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

Erforderlich: Nein

Notification

Definiert die Amazon-Notification Simple Notification Service (Amazon SNS) -Benachrichtigungseinstellungen für diesen Job.

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 Snow Family unterstützt Amazon S3 und NFS (Network File System) sowie denAWS Speicher-Gateway-Dienst vom Typ Tape Gateway.

Typ: OnDeviceServiceConfiguration Objekt

Required: No

RemoteManagement

Ermöglicht den sicheren Betrieb und die Verwaltung von Snowcone-Geräten 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

Definiert die Amazon S3 S3-Buckets, die diesem Job zugeordnet sind.

BeiIMPORT Jobs geben Sie den oder die Buckets an, in die Ihre übertragenen Daten importiert werden.

BeiEXPORT Jobs geben Sie den oder die Buckets an, aus denen Ihre übertragenen Daten exportiert werden. Optional können Sie auch einenKeyRange Wert angeben. Wenn Sie einen Bereich exportieren möchten, definieren Sie die Länge des Bereichs, indem Sie entweder einenBeginMarker Inklusivwert, einenEndMarker Inklusivwert oder beides angeben. Bereiche sind gemäß UTF-8 binär sortiert.

Typ: JobResource Objekt

Required: No

RoleARN

DieRoleARN, die Sie diesem Job zuordnen RoleArns werden mit der API-Aktion CreateRoleAWS 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: Nein

ShippingOption

Die Versandgeschwindigkeit für diesen Job. Diese Geschwindigkeit bestimmt nicht, wie schnell Sie das Snow-Gerät erhalten, sondern gibt an, wie schnell sich das Snow-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 USA haben Sie Zugriff auf eintägigen Versand und zweitägigen Versand.

Typ: Zeichenfolge

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

Required: No

SnowballCapacityPreference

Wenn Ihr Job in einer der US-Regionen erstellt wird, haben Sie die Möglichkeit, anzugeben, welche Größe des Snow-Geräts Sie für diesen Job wünschen. In allen anderen Regionen verfügen Snowballs über eine Speicherkapazität von 80 TB.

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: T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference

Required: No

SnowballType

Die Art der Snow Family-Geräte, die für diesen Job verwendet werden sollen.

Anmerkung

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

Der Typ desAWS Snow-Geräts, das für diesen Job verwendet werden soll. Derzeit wird allerdings nur der Gerätetyp für Cluster-Aufträge unterstütztEDGE.

Weitere Informationen finden Sie unter Snowball Edge-Geräteoptionen im Snowball Edge-Entwicklerhandbuch.

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

Required: No

TaxDocuments

Die Steuerdokumente, die in Ihrem erforderlich sindAWS-Region.

Typ: TaxDocuments Objekt

Erforderlich: Nein

Antwortsyntax

{
   "JobId": "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.

JobId

Die automatisch generierte ID für einen Job, zum BeispielJID123e4567-e89b-12d3-a456-426655440000.

Typ: Zeichenfolge

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

Pattern: (M|J)ID[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.

ClusterLimitExceededException

Die Job eines Endpunkts Derzeit unterstützen Cluster fünf Knoten. Wenn Sie weniger als fünf Knoten für Ihren Cluster haben und Sie mehr Knoten für diesen Cluster erstellen müssen, versuchen Sie es erneut und erstellen Sie Jobs, bis Ihr Cluster genau fünf Knoten hat.

HTTP Status Code: 400

Ec2RequestFailedException

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

HTTP Status Code: 400

InvalidInputCombinationException

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