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