CreateJob

Amazon S3 とオンプレミスデータセンターとの間でデータをインポートまたはエクスポートするためのジョブを作成します。Snow デバイスのジョブを作成するには、 AWS アカウント に適切な信頼ポリシーとアクセス許可が必要です。クラスター内のノードのジョブを作成する場合は、clusterId 値を指定するだけです。その他のジョブ属性は、クラスターから継承されます。

注記

クラスター化されたジョブを注文する場合は、Snowball; Edge デバイスタイプのみがサポートされます。

デバイスの容量は任意です。

デバイスタイプの可用性は、 AWS リージョンによって異なります。各リージョンでご利用いただけるサービスの詳細については、AWS リージョン別のサービスを参照してください。

Snow ファミリーのデバイスとその容量。

• デバイスタイプ: SNC1_SSD

  • 容量: T14

  • 説明: Snowcone

• デバイスタイプ: SNC1_HDD

  • 容量: T8

  • 説明: Snowcone

• デバイスタイプ: EDGE_S

  • 容量: T98

  • 説明: Snowball Edge Storage Optimized (データ転送用)

• デバイスタイプ: EDGE_CG

  • 容量: T42

  • 説明: Snowball Edge Compute Optimized GPU

• デバイスタイプ: EDGE_C

  • 容量: T42

  • 説明: Snowball Edge Compute Optimized without GPU

• デバイスタイプ: EDGE

  • 容量: T100

  • 説明: EC2 コンピューティングで最適化された Snowball Edge ストレージ

  注記

  このデバイスは T98 に置き換えられました。

• デバイスタイプ: STANDARD

  • 容量: T50

  • 説明: 元の Snowball デバイス

    注記

    このデバイスは、寧夏、北京、シンガポールでのみ使用できます。 AWS リージョン

• デバイスタイプ: STANDARD

  • 容量: T80

  • 説明: 元の Snowball デバイス

    注記

    このデバイスは、寧夏回族自治区、北京、シンガポールでのみご利用いただけます AWS リージョン。

• Snow Family デバイスタイプ: RACK_5U_C

  • 容量: T13

  • 説明: Snowblade。

• デバイスタイプ: V3_5S

  • 容量: 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"
      }
   }
}

リクエストパラメータ

すべてのアクションに共通のパラメータの詳細については、「共通パラメータ」を参照してください。

リクエストは、次のJSON形式のデータを受け入れます。

AddressId

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

クラスターの 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

この特定のジョブの説明を任意で定義します。たとえば、Important Photos 2016-08-11 など。

型: 文字列

長さの制限: 最小長は 1 です。最大長は 1,024 です。

パターン: ^[a-zA-Z0-9\s\-\_\.\:]+$

必須: いいえ

DeviceConfiguration

AWS Snowball Edge ジョブのデバイス設定を定義します。

Snow ファミリーデバイスの種類については、Snowcone ユーザーガイドのSnow ファミリーのデバイスと容量またはSnowball Edge ユーザーガイドのSnow ファミリーのデバイスと容量を参照してください。

型: DeviceConfiguration オブジェクト

必須：いいえ

ForwardingAddressId

このフィールドは、お住まいのリージョンではサポートされていません。

型: 文字列

長さの制限: 固定長は 40 です。

パターン: ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

必須: いいえ

ImpactLevel

ジョブの作成時に提供される、デバイスで保存または処理されるデータの最も大きい影響レベル。

型: 文字列

有効な値: IL2 | IL4 | IL5 | IL6 | IL99

必須：いいえ

JobType

作成するジョブのタイプを定義します。

型: 文字列

有効な値: IMPORT | EXPORT | LOCAL_USE

必須：いいえ

KmsKeyARN

このジョブKmsKeyARNに関連付ける 。 KmsKeyARNは CreateKey AWS Key Management Service （KMS) APIアクションを使用して作成されます。

型: 文字列

長さの制限：最大長は 255 です。

パターン: arn:aws.*:kms:.*:[0-9]{12}:key/.*

必須: いいえ

LongTermPricingId

デバイスの長期価格タイプの ID。

型: 文字列

長さの制限: 固定長は 41 です。

パターン: LTPID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

必須: いいえ

Notification

このジョブの Amazon Simple Notification Service (Amazon SNS) 通知設定を定義します。

型: Notification オブジェクト

必須：いいえ

OnDeviceServiceConfiguration

転送されたデータをエクスポートまたはインポートする Snow Family デバイスのサービスを指定します。 AWS Snow Family は Amazon S3 と NFS (ネットワークファイルシステム）、および AWS Storage Gateway サービステープゲートウェイタイプをサポートしています。

型: OnDeviceServiceConfiguration オブジェクト

必須：いいえ

PickupDetails

デバイスを受け取る人を識別する情報。

型: PickupDetails オブジェクト

必須：いいえ

RemoteManagement

Snowcone デバイスを内部ネットワークの外部からリモートで安全に操作および管理できます。INSTALLED_AUTOSTART に設定した場合では、デバイスがお客様の場所に到着すると、リモート管理が自動的に利用できるようになります。それ以外の場合は、Snowball Edge クライアントを使用してデバイスを管理する必要があります。NOT_INSTALLED に設定すると、デバイスのリモート管理はできなくなります。

型: 文字列

有効な値: INSTALLED_ONLY | INSTALLED_AUTOSTART | NOT_INSTALLED

必須：いいえ

Resources

このジョブに関連付けられた Amazon S3 バケットを定義します。

IMPORT ジョブでは、転送されたデータのインポート先となるバケットを指定します。

EXPORT ジョブでは、転送されたデータのエクスポート元となるバケットを指定します。また、任意で KeyRange 値も指定できます。範囲をエクスポートする場合は、BeginMarker 値か EndMarker 値を包括する値、または両方を指定して、範囲の長さを定義します。範囲は UTF-8 バイナリソートされます。

型: JobResource オブジェクト

必須：いいえ

RoleARN

このジョブRoleARNに関連付ける 。 RoleArnは CreateRole AWS Identity and Access Management （IAM) APIアクションを使用して作成されます。

型: 文字列

長さの制限：最大長は 255 です。

パターン: arn:aws.*:iam::[0-9]{12}:role/.*

必須: いいえ

ShippingOption

このジョブの配送速度。この速度は、Snow デバイスをどれくらい早く入手できるかではなく、転送中にSnowデバイスが目的地に移動する速さを表します。リージョンの配送速度は次のとおりです。

• オーストラリアでは、至急便を利用できます。通常、至急便で発送された Snow デバイスは約 1 日で配送されます。

• 欧州連合 (EU) では、至急便を利用できます。通常、至急便で発送された Snow デバイスは約 1 日で配送されます。また、EU のほとんどの国で通常便も利用できます。こちらは通常片道 1 週間以内です。

• インドでは、Snow デバイスが 1～7 日で配送されます。

• 米国では、翌日配送と 翌々日配送を利用できます。

型: 文字列

有効な値: SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD

必須：いいえ

SnowballCapacityPreference

米国リージョンのいずれかでジョブを作成する場合は、このジョブに必要な Snow デバイスのサイズを指定できます。他のすべての地域では、Snowball のストレージ容量は 80 TB です。

Snow ファミリーデバイスの種類については、Snowcone ユーザーガイドのSnow ファミリーのデバイスと容量またはSnowball Edge ユーザーガイドのSnow ファミリーのデバイスと容量を参照してください。

型: 文字列

有効な値: T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13

必須：いいえ

SnowballType

このジョブに使用する Snow ファミリーデバイスのタイプ。

注記

クラスタージョブの場合、 AWS Snow Family は現在EDGEデバイスタイプのみをサポートしています。

このジョブに使用する AWS Snow デバイスのタイプ。現在、クラスタージョブでサポートされているデバイスタイプは EDGE のみです。

詳細については、Snowball Edge デベロッパーガイドの「Snowball Edge デバイスオプション」を参照してください。

Snow ファミリーデバイスの種類については、Snowcone ユーザーガイドのSnow ファミリーのデバイスと容量またはSnowball Edge ユーザーガイドのSnow ファミリーのデバイスと容量を参照してください。

型: 文字列

有効な値: STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD | V3_5C | V3_5S | RACK_5U_C

必須：いいえ

TaxDocuments

に必要な税金ドキュメント AWS リージョン。

型: TaxDocuments オブジェクト

必須: いいえ

レスポンスの構文

{
   "JobId": "string"
}

レスポンス要素

アクションが成功すると、サービスは 200 HTTP レスポンスを送り返します。

次のデータは、 サービスによって JSON 形式で返されます。

JobId

ジョブに対して自動生成された 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}

エラー

すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。

ClusterLimitExceededException

ジョブ作成に失敗しました。現在、クラスターは 5 つのノードをサポートしています。クラスターのノードが 5 つ未満で、このクラスター用に作成するノードの数がそれより多い場合は、クラスターのノードがちょうど 5 つになるまでジョブを作成し直してください。

HTTP ステータスコード: 400

Ec2RequestFailedException

ユーザーには、試行されたアクションを実行するために必要な Amazon アクセスEC2許可がありません。

HTTP ステータスコード: 400

InvalidInputCombinationException

ジョブまたはクラスターの作成に失敗しました。1 つ以上の入力が無効です。CreateCluster：SnowballType 値が CreateJob：JobType をサポートしていることを確認し、再試行してください。

HTTP ステータスコード: 400

InvalidResourceException

指定されたリソースが見つかりません。前回のリクエストで入力した情報をチェックし、もう一度お試しください。

HTTP ステータスコード: 400

KMSRequestFailedException

指定された AWS Key Management Service キーには、指定された CreateJob または UpdateJobアクションを実行するアクセス許可がありません。

HTTP ステータスコード: 400

以下の資料も参照してください。

言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。

• AWS コマンドラインインターフェイス

• AWS SDK の 。NET

• AWS SDK C++ 用

• AWS SDK Go v2 用

• AWS SDK Java V2 用

• AWS SDK for JavaScript V3

• AWS SDK PHP V3 用

• AWS SDK Python 用

• AWS SDK Ruby V3 用