本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
CreateCluster
创建一个空集群。每个集群支持五个节点。您可以单独使用该CreateJob操作为每个节点创建任务。只有创建了这五个节点任务,集群才会发货。
请求语法
{
"AddressId": "string
",
"Description": "string
",
"ForwardingAddressId": "string
",
"JobType": "string
",
"KmsKeyARN": "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
",
"SnowballType": "string
",
"TaxDocuments": {
"IND": {
"GSTIN": "string
"
}
}
}
请求参数
有关所有操作的通用参数的信息,请参阅通用参数。
请求接受采用 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。
模式:
.*
必需:否
- ForwardingAddressId
-
您所在的地区不支持字段。
类型:字符串
长度限制:固定长度为 40。
模式:
ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}
必需:否
- JobType
-
此群任务的类型。目前,集群支持的唯一任务类型是
LOCAL_USE
。有关 Snow Family 设备类型的信息,请参阅 Snowcone 用户指南中的 Sno w 系列设备和容量或 Snowb all Edge 用户指南中的 S now 系列设备和容量。
类型:字符串
有效值:
IMPORT | EXPORT | LOCAL_USE
必需:是
- KmsKeyARN
-
要与此群关联的
KmsKeyARN
值。KmsKeyARN
值是使用Amazon Key Management Service (Amazon KMS) 中的 CreateKeyAPI 操作创建的。类型:字符串
长度限制:最大长度为 255。
模式:
arn:aws.*:kms:.*:[0-9]{12}:key/.*
必需:否
- Notification
-
此群的 Amazon Simple Notification Service (Amazon SNS
类型:Notification 对象
必需:否
- OnDeviceServiceConfiguration
-
指定 Snow Family 设备上的一个或多个服务,您传输的数据将从中导出或导入到这些服务。 AmazonSnow Family 设备集群支持 Amazon S3 和 NFS(网络文件系统)。
类型:OnDeviceServiceConfiguration 对象
必需:否
- RemoteManagement
-
允许您从内部网络外部安全地远程操作和管理集群中的 Snow 设备。设置为时
INSTALLED_AUTOSTART
,当设备到达您的位置时,远程管理将自动可用。否则,你需要使用 Snowball 客户端来管理设备。类型:字符串
有效值:
INSTALLED_ONLY | INSTALLED_AUTOSTART
必需:否
- Resources
-
与集群任务相关的资源。这些资源包括 Amazon S3 存储桶和用 Python 语言编写的可选Amazon Lambda函数。
类型:JobResource 对象
必需:是
- RoleARN
-
RoleARN
要与此群关联的。RoleArn
值是使用Amazon Identity and Access Management (IAM) 中的 CreateRoleAPI 操作创建的。类型:字符串
长度限制:最大长度为 255。
模式:
arn:aws.*:iam::[0-9]{12}:role/.*
必需:是
- ShippingOption
-
此集群中每个节点的传输速度。这个速度并不决定你多久能收到每台 Snowball Edge 设备,而是表示每台设备在运输过程中移动到目的地的速度。区域运输速度如下:
-
在澳大利亚,您可以使用快递运输。通常,快递运送的 Snow 设备大约在一天内送达。
-
在欧盟 (EU),您可以使用快递。通常,快递运送的 Snow 设备大约在一天内送达。此外,欧盟的大多数国家/地区还可以使用标准运输,通常单程需要的时间不超过一周。
-
在印度,Snow 设备在一到七天内交付。
-
在美利坚合众国 (US),您可以享受一日送达和两日送达。
-
在澳大利亚,您可以使用快递运输。通常,快递发货的设备大约在一天内送达。
-
在欧盟 (EU),您可以使用快递。通常,快递运送的 Snow 设备大约在一天内送达。此外,欧盟的大多数国家/地区还可以使用标准运输,通常单程需要的时间不超过一周。
-
在印度,Snow 设备在一到七天内交付。
-
在美国,您可以享受一日送达和两日送达。
类型:字符串
有效值:
SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD
必需:是
-
- SnowballType
-
用于此集群的 Snow 系列设备类型。
注意 对于集群作业,SAmazon now Family 目前仅支持
EDGE
设备类型。有关 Snow Family 设备类型的信息,请参阅 Snowcone 用户指南中的 Sno w 系列设备和容量或 Snowb all Edge 用户指南中的 S now 系列设备和容量。
类型:字符串
有效值:
STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD | V3_5C
必需:是
- TaxDocuments
-
您所需的税务文件Amazon Web Services 区域.
类型:TaxDocuments 对象
必需:否
响应语法
{
"ClusterId": "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}
错误
有关所有操作常见错误的信息,请参阅常见错误。
- Ec2RequestFailedException
-
您的用户缺少执行尝试操作所必需的 Amazon EC2 权限。
HTTP 状态代码:400
- InvalidInputCombinationException
-
Job 或群集创建失败。一个或多个输入无效。确认CreateCluster:SnowballType值支持你的CreateJob:JobType,然后重试。
HTTP 状态代码:400
- InvalidResourceException
-
找不到指定的资源。检查您在上次请求中提供的信息,然后重试。
HTTP 状态代码:400
- KMSRequestFailedException
-
提供的Amazon Key Management Service密钥缺少执行指定CreateJob或UpdateJob操作的权限。
HTTP 状态代码:400
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: