本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CreateCluster
重要
支援結束通知：2024 年 11 月 12 日， AWS 將停止上一代 AWS Snowball 裝置，以及 Snowcone 裝置 (HDD 和 SDD)。我們將持續支援使用這些 end-of-life裝置的現有客戶，直到 2025 年 11 月 12 日為止。最新一代 AWS 的 Snowball 裝置適用於所有客戶。如需詳細資訊，請造訪此部落格文章
建立空的叢集。每個叢集支援五個節點。您可以分別使用 CreateJob動作來為每個節點建立任務。在建立這五個節點任務之前，叢集不會運送。
請求語法
{
"AddressId": "string",
"Description": "string",
"ForceCreateJobs": boolean,
"ForwardingAddressId": "string",
"InitialClusterSize": number,
"JobType": "string",
"KmsKeyARN": "string",
"LongTermPricingIds": [ "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"
}
},
"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
-
您要叢集運送地址的 ID。
類型：字串
長度限制條件：固定長度為 40。
模式：
ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}必要：是
- Description
-
此特定叢集的選用描述，例如
Environmental Data Cluster-01。類型：字串
長度限制：長度下限為 1。長度上限為 1024。
模式：
.*必要：否
- ForceCreateJobs
-
當使用者嘗試過度佈建或佈建不足叢集時，強制建立叢集。如果叢集的初始大小大於 （過度佈建） 或小於 （佈建不足），則叢集會過度佈建或佈建不足，以因應 指定的容量需求
OnDeviceServiceConfiguration。類型：布林值
必要：否
- ForwardingAddressId
-
您的區域不支援此欄位。
類型：字串
長度限制條件：固定長度為 40。
模式：
ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}必要：否
- InitialClusterSize
-
如果提供，系統會自動建立每個任務，並與新叢集建立關聯。如果未提供， 將被視為 0。
類型：整數
有效範圍：最小值為 0。最大值為 16。
必要：否
- JobType
-
此叢集的任務類型。目前，叢集支援的唯一任務類型是
LOCAL_USE。如需 Snowball Edge 裝置類型的資訊，請參閱 Snowball Edge 開發人員指南中的裝置硬體資訊。
類型：字串
有效值:
IMPORT | EXPORT | LOCAL_USE必要：是
- KmsKeyARN
-
您要與此叢集建立關聯的
KmsKeyARN值。KmsKeyARN值是透過在 AWS Key Management Service (AWS KMS) 中使用 CreateKeyAPI動作建立。類型：字串
長度限制：長度上限為 255。
模式：
arn:aws.*:kms:.*:[0-9]{12}:key/.*必要：否
- LongTermPricingIds
-
列出長期定價 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
-
指定 Snowball Edge 裝置上的 服務或 服務，您的傳輸資料將從 或匯入其中。 AWS Snowball Edge 裝置叢集支援 Amazon S3 和 NFS（網路檔案系統）。
類型：OnDeviceServiceConfiguration 物件
必要：否
- RemoteManagement
-
可讓您從內部網路外部安全地操作和管理叢集中的 Snow 裝置。設定為 時
INSTALLED_AUTOSTART，遠端管理會在裝置抵達您的位置時自動可用。否則，您需要使用 Snowball 用戶端來管理裝置。類型：字串
有效值:
INSTALLED_ONLY | INSTALLED_AUTOSTART | NOT_INSTALLED必要：否
- Resources
-
與叢集任務相關聯的資源。這些資源包括 Amazon S3 儲存貯體和以 Python 語言編寫的選用 AWS Lambda 函數。
類型：JobResource 物件
必要：否
- RoleARN
-
RoleARN您要與此叢集建立關聯的 。RoleArn值是使用 AWS Identity and Access Management (IAM) 中的 CreateRoleAPI動作來建立。類型：字串
長度限制：長度上限為 255。
模式：
arn:aws.*:iam::[0-9]{12}:role/.*必要：否
- ShippingOption
-
此叢集中每個節點的運送速度。此速度不會決定您會多快取得每個 Snowball Edge 裝置，而是代表每個裝置在傳輸時移動到目的地的速度。區域運送速度如下所示：
-
在澳洲，您可以存取快遞運送。一般而言，Snow 裝置運送快遞大約會在一天內交付。
-
在歐盟 (EU)，您可以存取快遞運送。一般而言，Snow 裝置運送快遞大約會在一天內交付。此外，歐盟內的大部分國家採用標準運送方式，通常不需一週即可送達。
-
在印度，Snow 裝置會在一到七天內交付。
-
在美國 (US)，您可以存取一日運送和兩天運送。
-
在澳洲，您可以存取快遞運送。一般而言，Express 運送的裝置大約會在一天內交付。
-
在歐盟 (EU)，您可以存取快遞運送。一般而言，Snow 裝置運送快遞大約會在一天內交付。此外，歐盟內的大部分國家採用標準運送方式，通常不需一週即可送達。
-
在印度，Snow 裝置會在一到七天內交付。
-
在美國，您可以存取一天的運送和兩天的運送。
類型：字串
有效值:
SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD必要：是
-
- SnowballCapacityPreference
-
如果您的任務是在其中一個美國區域建立，您可以選擇指定要為此任務使用的 Snow 裝置大小。在所有其他區域中，Snowball 隨附 80 TB 的儲存容量。
如需 Snowball Edge 裝置類型的相關資訊，請參閱 Snowball Edge 開發人員指南中的裝置硬體資訊。
類型：字串
有效值:
T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13必要：否
- SnowballType
-
要用於此叢集的 Snow Family 裝置類型。
注意
對於叢集任務， AWS Snowball Edge 目前僅支援
EDGE裝置類型。如需 Snowball Edge 裝置類型的相關資訊，請參閱 Snowball Edge 開發人員指南中的裝置硬體資訊。
類型：字串
有效值:
STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD | V3_5C | V3_5S | RACK_5U_C必要：是
- TaxDocuments
-
您的 中所需的稅務文件 AWS 區域。
類型：TaxDocuments 物件
必要：否
回應語法
{
"ClusterId": "string",
"JobListEntries": [
{
"CreationDate": number,
"Description": "string",
"IsMaster": boolean,
"JobId": "string",
"JobState": "string",
"JobType": "string",
"SnowballType": "string"
}
]
}回應元素
如果動作成功，服務會傳回 HTTP 200 個回應。
服務會以 JSON 格式傳回下列資料。
- ClusterId
-
叢集自動產生的 ID。
類型：字串
長度限制條件：固定長度為 39。
模式：
CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12} - JobListEntries
-
為此叢集建立的任務清單。如需語法，請參閱本指南中的 ListJobsResult$JobListEntries
。 類型：JobListEntry 物件陣列
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- Ec2RequestFailedException
-
您的使用者缺少執行嘗試動作的必要 Amazon EC2許可。
HTTP 狀態碼：400
- InvalidInputCombinationException
-
任務或叢集建立失敗。一或多個輸入無效。確認 CreateCluster：SnowballType 值支援您的 CreateJob：JobType，然後再試一次。
HTTP 狀態碼：400
- InvalidResourceException
-
找不到指定的資源。請檢查您在上次請求中提供的資訊，然後再試一次。
HTTP 狀態碼：400
- KMSRequestFailedException
-
提供的 AWS Key Management Service 金鑰缺少執行指定 CreateJob或 UpdateJob動作的許可。
HTTP 狀態碼：400
另請參閱
如需在其中一種特定語言API中使用此功能的詳細資訊 AWS SDKs，請參閱以下內容：
