翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # CreateJob Amazon S3 とオンプレミスデータセンターとの間でデータをインポートまたはエクスポートするためのジョブを作成します。Snow デバイスのジョブを作成するには、 AWS アカウント に適切な信頼ポリシーとアクセス許可が必要です。クラスター内のノードのジョブを作成する場合は、`clusterId` 値を指定するだけです。その他のジョブ属性は、クラスターから継承されます。 **注記** クラスター化されたジョブを注文する場合は、Snowball; Edge デバイスタイプのみがサポートされます。 デバイスの容量は任意です。 デバイスタイプの可用性は、 AWS リージョンによって異なります。各リージョンでご利用いただけるサービスの詳細については、[AWS リージョン別のサービス](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/?p=ngi&loc=4)を参照してください。 **Snow ファミリーのデバイスとその容量。** + デバイスタイプ: **SNC1\$1SSD** + 容量: T14 + 説明: Snowcone + デバイスタイプ: **SNC1\$1HDD** + 容量: T8 + 説明: Snowcone + デバイスタイプ: **EDGE\$1S** + 容量: T98 + 説明: Snowball Edge Storage Optimized (データ転送用) + デバイスタイプ: **EDGE\$1CG** + 容量: T42 + 説明: Snowball Edge Compute Optimized GPU + デバイスタイプ: **EDGE\$1C** + 容量: T42 + 説明: Snowball Edge Compute Optimized without GPU + デバイスタイプ: **EDGE** + 容量: T100 + 説明: EC2 コンピューティングで最適化された Snowball Edge ストレージ **注記** このデバイスは T98 に置き換えられました。 + デバイスタイプ: **STANDARD** + 容量: T50 + 説明: 元の Snowball デバイス **注記** このデバイスは、寧夏、北京、シンガポールでのみ使用できます。 AWS リージョン + デバイスタイプ: **STANDARD** + 容量: T80 + 説明: 元の Snowball デバイス **注記** このデバイスは、寧夏回族自治区、北京、シンガポールでのみご利用いただけます AWS リージョン。 + Snow Family デバイスタイプ: **RACK\$15U\$1C** + 容量: T13 + 説明: Snowblade。 + デバイスタイプ: **V3\$15S** + 容量: T240 + 説明: Snowball Edge Storage Optimized 210TB ## リクエストの構文 ``` { "AddressId": "string", "ClusterId": "string", "Description": "string", "DeviceConfiguration": { "SnowconeDeviceConfiguration": { "WirelessConnection": { "IsWifiEnabled": boolean } } }, "ForwardingAddressId": "string", "ImpactLevel": "string", "JobType": "string", "KmsKeyARN": "string", "LongTermPricingId": "string", "Notification": { "DevicePickupSnsTopicARN": "string", "JobStatesToNotify": [ "string" ], "NotifyAll": boolean, "SnsTopicARN": "string" }, "OnDeviceServiceConfiguration": { "EKSOnDeviceService": { "EKSAnywhereVersion": "string", "KubernetesVersion": "string" }, "NFSOnDeviceService": { "StorageLimit": number, "StorageUnit": "string" }, "S3OnDeviceService": { "FaultTolerance": number, "ServiceSize": number, "StorageLimit": number, "StorageUnit": "string" }, "TGWOnDeviceService": { "StorageLimit": number, "StorageUnit": "string" } }, "PickupDetails": { "DevicePickupId": "string", "Email": "string", "IdentificationExpirationDate": number, "IdentificationIssuingOrg": "string", "IdentificationNumber": "string", "Name": "string", "PhoneNumber": "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" } } } ``` ## リクエストパラメータ すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。 リクエストは、次のJSON形式のデータを受け入れます。 ** [AddressId](#API_CreateJob_RequestSyntax) ** Snow デバイスの配送先住所の ID。 型: 文字列 長さの制限: 固定長は 40 です。 パターン: `ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` 必須: いいえ ** [ClusterId](#API_CreateJob_RequestSyntax) ** クラスターの ID。クラスター内のノードのジョブを作成する場合は、`clusterId` 値を指定するだけです。その他のジョブ属性は、クラスターから継承されます。 型: 文字列 長さの制限: 固定長は 39 です。 パターン: `CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` 必須: いいえ ** [Description](#API_CreateJob_RequestSyntax) ** この特定のジョブの説明を任意で定義します。たとえば、`Important Photos 2016-08-11` など。 型: 文字列 長さの制限: 最小長は 1 です。最大長は 1,024 です。 パターン: `^[a-zA-Z0-9\s\-\_\.\:]+$` 必須: いいえ ** [DeviceConfiguration](#API_CreateJob_RequestSyntax) ** AWS Snowball Edge ジョブのデバイス設定を定義します。 Snow ファミリーデバイスの種類については、*Snowcone ユーザーガイド*の[Snow ファミリーのデバイスと容量](https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html)または*Snowball Edge ユーザーガイド*の[Snow ファミリーのデバイスと容量](https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html)を参照してください。 型: [DeviceConfiguration](API_DeviceConfiguration.md) オブジェクト 必須：いいえ ** [ForwardingAddressId](#API_CreateJob_RequestSyntax) ** このフィールドは、お住まいのリージョンではサポートされていません。 型: 文字列 長さの制限: 固定長は 40 です。 パターン: `ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` 必須: いいえ ** [ImpactLevel](#API_CreateJob_RequestSyntax) ** ジョブの作成時に提供される、デバイスで保存または処理されるデータの最も大きい影響レベル。 型: 文字列 有効な値: `IL2 | IL4 | IL5 | IL6 | IL99` 必須：いいえ ** [JobType](#API_CreateJob_RequestSyntax) ** 作成するジョブのタイプを定義します。 型: 文字列 有効な値: `IMPORT | EXPORT | LOCAL_USE` 必須：いいえ ** [KmsKeyARN](#API_CreateJob_RequestSyntax) ** このジョブ`KmsKeyARN`に関連付ける 。 `KmsKeyARN`は [CreateKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html) AWS Key Management Service （KMS) APIアクションを使用して作成されます。 型: 文字列 長さの制限：最大長は 255 です。 パターン: `arn:aws.*:kms:.*:[0-9]{12}:key/.*` 必須: いいえ ** [LongTermPricingId](#API_CreateJob_RequestSyntax) ** デバイスの長期価格タイプの ID。 型: 文字列 長さの制限: 固定長は 41 です。 パターン: `LTPID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` 必須: いいえ ** [Notification](#API_CreateJob_RequestSyntax) ** このジョブの Amazon Simple Notification Service (Amazon SNS) 通知設定を定義します。 型: [Notification](API_Notification.md) オブジェクト 必須：いいえ ** [OnDeviceServiceConfiguration](#API_CreateJob_RequestSyntax) ** 転送されたデータをエクスポートまたはインポートする Snow Family デバイスのサービスを指定します。 AWS Snow Family は Amazon S3 と NFS (ネットワークファイルシステム）、および AWS Storage Gateway サービステープゲートウェイタイプをサポートしています。 型: [OnDeviceServiceConfiguration](API_OnDeviceServiceConfiguration.md) オブジェクト 必須：いいえ ** [PickupDetails](#API_CreateJob_RequestSyntax) ** デバイスを受け取る人を識別する情報。 型: [PickupDetails](API_PickupDetails.md) オブジェクト 必須：いいえ ** [RemoteManagement](#API_CreateJob_RequestSyntax) ** Snowcone デバイスを内部ネットワークの外部からリモートで安全に操作および管理できます。`INSTALLED_AUTOSTART` に設定した場合では、デバイスがお客様の場所に到着すると、リモート管理が自動的に利用できるようになります。それ以外の場合は、Snowball Edge クライアントを使用してデバイスを管理する必要があります。`NOT_INSTALLED` に設定すると、デバイスのリモート管理はできなくなります。 型: 文字列 有効な値: `INSTALLED_ONLY | INSTALLED_AUTOSTART | NOT_INSTALLED` 必須：いいえ ** [Resources](#API_CreateJob_RequestSyntax) ** このジョブに関連付けられた Amazon S3 バケットを定義します。 `IMPORT` ジョブでは、転送されたデータのインポート先となるバケットを指定します。 `EXPORT` ジョブでは、転送されたデータのエクスポート元となるバケットを指定します。また、任意で `KeyRange` 値も指定できます。範囲をエクスポートする場合は、`BeginMarker` 値か `EndMarker` 値を包括する値、または両方を指定して、範囲の長さを定義します。範囲は UTF-8 バイナリソートされます。 型: [JobResource](API_JobResource.md) オブジェクト 必須：いいえ ** [RoleARN](#API_CreateJob_RequestSyntax) ** このジョブ`RoleARN`に関連付ける 。 `RoleArn`は [CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html) AWS Identity and Access Management （IAM) APIアクションを使用して作成されます。 型: 文字列 長さの制限：最大長は 255 です。 パターン: `arn:aws.*:iam::[0-9]{12}:role/.*` 必須: いいえ ** [ShippingOption](#API_CreateJob_RequestSyntax) ** このジョブの配送速度。この速度は、Snow デバイスをどれくらい早く入手できるかではなく、転送中にSnowデバイスが目的地に移動する速さを表します。リージョンの配送速度は次のとおりです。 + オーストラリアでは、至急便を利用できます。通常、至急便で発送された Snow デバイスは約 1 日で配送されます。 + 欧州連合 (EU) では、至急便を利用できます。通常、至急便で発送された Snow デバイスは約 1 日で配送されます。また、EU のほとんどの国で通常便も利用できます。こちらは通常片道 1 週間以内です。 + インドでは、Snow デバイスが 1～7 日で配送されます。 + 米国では、翌日配送と 翌々日配送を利用できます。 型: 文字列 有効な値: `SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD` 必須：いいえ ** [SnowballCapacityPreference](#API_CreateJob_RequestSyntax) ** 米国リージョンのいずれかでジョブを作成する場合は、このジョブに必要な Snow デバイスのサイズを指定できます。他のすべての地域では、Snowball のストレージ容量は 80 TB です。 Snow ファミリーデバイスの種類については、*Snowcone ユーザーガイド*の[Snow ファミリーのデバイスと容量](https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html)または*Snowball Edge ユーザーガイド*の[Snow ファミリーのデバイスと容量](https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html)を参照してください。 型: 文字列 有効な値: `T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13` 必須：いいえ ** [SnowballType](#API_CreateJob_RequestSyntax) ** このジョブに使用する Snow ファミリーデバイスのタイプ。 クラスタージョブの場合、 AWS Snow Family は現在`EDGE`デバイスタイプのみをサポートしています。 このジョブに使用する AWS Snow デバイスのタイプ。現在、クラスタージョブでサポートされているデバイスタイプは `EDGE` のみです。 詳細については、Snowball Edge デベロッパーガイドの「[Snowball Edge デバイスオプション](https://docs.aws.amazon.com/snowball/latest/developer-guide/device-differences.html)」を参照してください。 Snow ファミリーデバイスの種類については、*Snowcone ユーザーガイド*の[Snow ファミリーのデバイスと容量](https://docs.aws.amazon.com/snowball/latest/snowcone-guide/snow-device-types.html)または*Snowball Edge ユーザーガイド*の[Snow ファミリーのデバイスと容量](https://docs.aws.amazon.com/snowball/latest/developer-guide/snow-device-types.html)を参照してください。 型: 文字列 有効な値: `STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD | V3_5C | V3_5S | RACK_5U_C` 必須：いいえ ** [TaxDocuments](#API_CreateJob_RequestSyntax) ** に必要な税金ドキュメント AWS リージョン。 型: [TaxDocuments](API_TaxDocuments.md) オブジェクト 必須: いいえ ## レスポンスの構文 ``` { "JobId": "string" } ``` ## レスポンス要素 アクションが成功すると、サービスは 200 HTTP レスポンスを送り返します。 次のデータは、 サービスによって JSON 形式で返されます。 ** [JobId](#API_CreateJob_ResponseSyntax) ** ジョブに対して自動生成された ID。たとえば、`JID123e4567-e89b-12d3-a456-426655440000`。 型: 文字列 長さの制限: 固定長は 39 です。 パターン: `(M|J)ID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` ## エラー すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** ClusterLimitExceededException ** ジョブ作成に失敗しました。現在、クラスターは 5 つのノードをサポートしています。クラスターのノードが 5 つ未満で、このクラスター用に作成するノードの数がそれより多い場合は、クラスターのノードがちょうど 5 つになるまでジョブを作成し直してください。 HTTP ステータスコード: 400 ** Ec2RequestFailedException ** ユーザーには、試行されたアクションを実行するために必要な Amazon アクセスEC2許可がありません。 HTTP ステータスコード: 400 ** InvalidInputCombinationException ** ジョブまたはクラスターの作成に失敗しました。1 つ以上の入力が無効です。[CreateCluster：SnowballType](API_CreateCluster.md#Snowball-CreateCluster-request-SnowballType) 値が [CreateJob：JobType](#Snowball-CreateJob-request-JobType) をサポートしていることを確認し、再試行してください。 HTTP ステータスコード: 400 ** InvalidResourceException ** 指定されたリソースが見つかりません。前回のリクエストで入力した情報をチェックし、もう一度お試しください。 HTTP ステータスコード: 400 ** KMSRequestFailedException ** 指定された AWS Key Management Service キーには、指定された [CreateJob](#API_CreateJob) または [UpdateJob](API_UpdateJob.md)アクションを実行するアクセス許可がありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。 + [AWS コマンドラインインターフェイス](https://docs.aws.amazon.com/goto/aws-cli/snowball-2016-06-30/CreateJob) + [AWS SDK の 。NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/snowball-2016-06-30/CreateJob) + [AWS SDK C\$1\$1 用](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/CreateJob) + [AWS SDK Go v2 用](https://docs.aws.amazon.com/goto/SdkForGoV2/snowball-2016-06-30/CreateJob) + [AWS SDK Java V2 用](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/CreateJob) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snowball-2016-06-30/CreateJob) + [AWS SDK PHP V3 用](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/CreateJob) + [AWS SDK Python 用](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/CreateJob) + [AWS SDK Ruby V3 用](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/CreateJob)