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 den`clusterId` 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](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/?p=ngi&loc=4). **Snow Family-Geräte und ihre Kapazitäten.** + Snow Family-Gerätetyp: **SNC1\$1SSD** + Kapazität: T14 + Beschreibung: Snowcone + Snow Family Gerätetyp: **SNC1\$1HDD** + Kapazität: T8 + Beschreibung: Snowcone + Gerätetyp: **EDGE\$1S** + Kapazität: T98 + Beschreibung: Snowball Edge Storage Nur für die Datenübertragung optimiert + Gerätetyp: **EDGE\$1CG** + Kapazität: T42 + Beschreibung: Snowball Edge Compute Optimized mit GPU + Gerätetyp: **EDGE\$1C** + 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](CommonParameters.md). Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [AddressId](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** Die ID eines Clusters. Wenn Sie einen Job für einen Knoten in einem Cluster erstellen, müssen Sie nur diesen`clusterId` 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](#API_CreateJob_RequestSyntax) ** Definiert beispielsweise eine optionale Beschreibung dieses spezifischen Jobs`Important 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](#API_CreateJob_RequestSyntax) ** Definiert die Gerätekonfiguration für einenAWS Snowball Edge Job. 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: [DeviceConfiguration](API_DeviceConfiguration.md) Objekt Required: No ** [ForwardingAddressId](#API_CreateJob_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_CreateJob_RequestSyntax) ** Definiert die Art eines Auftrags, den Sie erstellen. Typ: Zeichenfolge Zulässige Werte:` IMPORT | EXPORT | LOCAL_USE` Required: No ** [KmsKeyARN](#API_CreateJob_RequestSyntax) ** Die`KmsKeyARN`, die Sie diesem Job zuordnen `KmsKeyARN`s werden mit der API-Aktion [CreateKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html)AWS 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](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** Definiert die Amazon-Notification Simple Notification Service (Amazon SNS) -Benachrichtigungseinstellungen für diesen Job. Typ: [Notification](API_Notification.md) Objekt Required: No ** [OnDeviceServiceConfiguration](#API_CreateJob_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 Snow Family unterstützt Amazon S3 und NFS (Network File System) sowie denAWS Speicher-Gateway-Dienst vom Typ Tape Gateway. Typ: [OnDeviceServiceConfiguration](API_OnDeviceServiceConfiguration.md) Objekt Required: No ** [RemoteManagement](#API_CreateJob_RequestSyntax) ** 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 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_CreateJob_RequestSyntax) ** Definiert die Amazon S3 S3-Buckets, die diesem Job zugeordnet sind. Bei`IMPORT` Jobs geben Sie den oder die Buckets an, in die Ihre übertragenen Daten importiert werden. Bei`EXPORT` Jobs geben Sie den oder die Buckets an, aus denen Ihre übertragenen Daten exportiert werden. Optional können Sie auch einen`KeyRange` Wert angeben. Wenn Sie einen Bereich exportieren möchten, definieren Sie die Länge des Bereichs, indem Sie entweder einen`BeginMarker` Inklusivwert, einen`EndMarker` Inklusivwert oder beides angeben. Bereiche sind gemäß UTF-8 binär sortiert. Typ: [JobResource](API_JobResource.md) Objekt Required: No ** [RoleARN](#API_CreateJob_RequestSyntax) ** Die`RoleARN`, die Sie diesem Job zuordnen `RoleArn`s werden mit der API-Aktion [CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html)AWS 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](#API_CreateJob_RequestSyntax) ** 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](#API_CreateJob_RequestSyntax) ** 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](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:` T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference` Required: No ** [SnowballType](#API_CreateJob_RequestSyntax) ** Die Art der Snow Family-Geräte, die für diesen Job verwendet werden sollen. Für Cluster-Jobs unterstütztAWS Snow Family derzeit nur den`EDGE` 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ützt`EDGE`. Weitere Informationen finden Sie unter [Snowball Edge-Geräteoptionen](https://docs.aws.amazon.com/snowball/latest/developer-guide/device-differences.html) im Snowball Edge-Entwicklerhandbuch. 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` Required: No ** [TaxDocuments](#API_CreateJob_RequestSyntax) ** Die Steuerdokumente, die in Ihrem erforderlich sindAWS-Region. Typ: [TaxDocuments](API_TaxDocuments.md) 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](#API_CreateJob_ResponseSyntax) ** Die automatisch generierte ID für einen Job, zum Beispiel`JID123e4567-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 unter[Häufige Fehler](CommonErrors.md). ** 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:](API_CreateCluster.md#Snowball-CreateCluster-request-SnowballType) Ihren [CreateJob:](#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)[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/CreateJob) + [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/snowball-2016-06-30/CreateJob) + [AWS-SDK für C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/CreateJob) + [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/snowball-2016-06-30/CreateJob) + [AWS-SDK für Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/CreateJob) + [AWSSDK für JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/snowball-2016-06-30/CreateJob) + [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/CreateJob) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/CreateJob) + [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/CreateJob)