CreateJob - AWS Snowball
請求語法請求參數回應語法回應元素錯誤另請參閱

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

CreateJob

建立可在 Amazon S3 和現場部署資料中心之間匯入或匯出資料的任務。您 AWS 帳戶 必須擁有適當的信任原則和權限，才能為 Snow 裝置建立工作。如果您要為叢集中的節點建立工作，您只需要提供clusterId值；其他工作屬性會從叢集繼承。

注意

訂購叢集工作時，僅支援 Snowball; Edge 裝置類型。

設備容量是可選的。

裝置類型的可用性會因不同而異 AWS 區域。如需區域可用性的詳細資訊，請參閱區AWS 域服務。

雪家族設備及其能力。

  • 裝置類型:固態硬碟

    • 容量:

    • 說明:Snowcone

  • 設備類型：硬盤

    • 容量:

    • 說明:Snowcone

  • 設備類型：邊緣 _ S

    • 容量：

    • 說明：Snowball 邊緣儲存裝置僅針對資料傳輸最佳化

  • 設備類型：邊緣

    • 容量：

    • 說明：使用 GPU 最佳化的雪球邊緣運算

  • 設備類型：邊緣 _ C

    • 容量：

    • 說明：不含 GPU 的 Snowball Edge Compute Optimized

  • 設備類型：邊緣

    • 容量：

    • 說明：使用 EC2 運算最佳化的雪球邊緣儲存

    注意

    該設備被替換為 T98。

  • 設備類型：標準

    • 容量：

    • 簡介：原裝 Snowball 裝置

      注意

      此裝置僅適用於寧夏、北京和新加坡 AWS 區域

  • 設備類型：標準

    • 容量：

    • 簡介：原裝 Snowball 裝置

      注意

      此裝置僅適用於寧夏、北京和新加坡 AWS 區域。

  • 雪系列設備類型：機架 _5U_C

    • 容量：

    • 說明：雪地。

  • 設備類型：5

    • 容量：

    • 說明：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"
      }
   }
}

請求參數

如需所有動作的一般參數資訊，請參閱《Common Parameters》。

請求接受採用 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

叢集的識別碼。如果要為叢集中的節點建立作業，則只需提供此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。長度上限為 1024。

模式：.*

必要：否

DeviceConfiguration

定義工 AWS Snowcone 作的裝置組態。

如需有關 Snow 系列裝置類型的資訊，請參閱 Snowball 使用指南中的 S now 系列裝置和容量或 Snowball Edge 使用者指南中的 S now 系列裝置和容量。

類型：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 簡易通知服務 (Amazon SNS) 通知設定。

類型：Notification 物件

必要：否

OnDeviceServiceConfiguration

指定 Snow Family 裝置上傳輸的資料將從中匯出或匯入的一個或多個服務。 AWS Snow 系列支援 Amazon S3 和 NFS (網路檔案系統)。

類型：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 設備大約在一天內交付。

  • 在歐盟（EU），您可以使用快遞運輸。通常情況下，運送快遞的 Snow 設備大約在一天內交付。此外，歐盟內的大部分國家採用標準運送方式，通常不需一週即可送達。

  • 在印度，Snow 設備在一到七天內交付。

  • 在美國，您可以享受一天運輸和兩天運輸。

類型：字串

有效值:SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD

必要：否

SnowballCapacityPreference

如果您的工作正在美國其中一個地區建立，您可以選擇指定要用於此工作的 Snow 裝置大小。在所有其他地區，雪球都有 80 TB 的儲存容量。

如需有關 Snow 系列裝置類型的資訊，請參閱 Snowball 使用指南中的 S now 系列裝置和容量或 Snowball Edge 使用者指南中的 S now 系列裝置和容量。

類型：字串

有效值:T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13

必要：否

SnowballType

用於此工作的 Snow 系列裝置類型。

注意

對於叢集工作，S AWS now 系列目前僅支援EDGE裝置類型。

用於此工作的 S AWS now 裝置類型。目前，叢集工作唯一支援的裝置類型為EDGE。

如需詳細資訊，請參閱 Snowball Edge 開發人員指南中的 Snowball 邊緣裝置選項。

如需有關 Snow 系列裝置類型的資訊，請參閱 Snowball 使用指南中的 S now 系列裝置和容量或 Snowball Edge 使用者指南中的 S now 系列裝置和容量。

類型：字串

有效值:STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD | V3_5C | V3_5S | RACK_5U_C

必要：否

TaxDocuments

您需要的稅務文件 AWS 區域。

類型：TaxDocuments 物件

必要：否

回應語法

{
   "JobId": "string"
}

回應元素

如果動作成功，則服務傳回 HTTP 200 回應。

服務會傳回下列 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

Job 建立失敗。目前，叢集支援五個節點。如果叢集的節點少於五個，而且要為此叢集建立更多節點，請再試一次並建立工作，直到叢集剛好有五個節點為止。

HTTP 狀態碼：400

Ec2RequestFailedException

您的使用者缺少必要的 Amazon EC2 許可來執行嘗試的動作。

HTTP 狀態碼：400

InvalidInputCombinationException

Job 或叢集建立失敗。一個或多個輸入無效。請確認CreateCluster:SnowballType值支援您的CreateJob:JobType，然後再試一次。

HTTP 狀態碼：400

InvalidResourceException

找不到指定的資源。請檢查您上次要求中提供的資訊，然後再試一次。

HTTP 狀態碼：400

KMSRequestFailedException

提供的 AWS Key Management Service 金鑰缺乏執行指定CreateJob或UpdateJob動作的權限。

HTTP 狀態碼：400

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：