CreateCluster - Amazon Snowball
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

CreateCluster

创建一个空集群。每个集群支持五个节点。您可以单独使用该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" } } }

请求参数

有关所有操作的通用参数的信息,请参阅通用参数

请求接受采用 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

有关 Snow Family 设备类型的信息,请参阅 Snowc one 用户指南中的 Sno w 系列设备和容量或 Snowball Edge 用户指南中的 S no w 系列设备和容量

类型:字符串

有效值:IMPORT | EXPORT | LOCAL_USE

必需:是

KmsKeyARN

要与此群集关联的KmsKeyARN值。 KmsKeyARN值是通过使用 Amazon Key Management Service (Amazon KMS) 中的 CreateKeyAPI 操作创建的。

类型:字符串

长度限制:最大长度为 255。

模式:arn:aws.*:kms:.*:[0-9]{12}:key/.*

必需:否

LongTermPricingIds

列出长期定价 ID,该定价将用于与为新集群自动创建的任务相关联。

类型:字符串数组

长度限制:固定长度为为为 4。

模式: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 (Ama

类型:Notification 对象

必需:否

OnDeviceServiceConfiguration

在 Snow Family 设备上指定 Snow Family 设备上将传输的数据导出或导入的服务。 AmazonSnow Family 设备集群支持 Amazon S3 和 NFS(网络文件系统)。

类型:OnDeviceServiceConfiguration 对象

必需:否

RemoteManagement

允许您从内部网络外部安全地远程操作和管理集群中的 Snow 设备。如果设置为INSTALLED_AUTOSTART,则当设备到达您的位置时,远程管理将自动可用。否则,你需要使用 Snowball 客户端来管理设备。

类型:字符串

有效值:INSTALLED_ONLY | INSTALLED_AUTOSTART | NOT_INSTALLED

必需:否

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 设备将在一到七天内交付。

  • 在美利坚合众国(美国),您可以享受次日达和隔日达服务。

  • 在澳大利亚,您可以使用特快配送。通常,快递发货的设备大约在一天内交付。

  • 在欧盟 (EU),您可以使用特快配送。通常,快递发货的 Snow 设备大约在一天内送达。此外,欧盟的大多数国家/地区还可以使用标准运输,通常单程需要的时间不超过一周。

  • 在印度,Snow 设备将在一到七天内交付。

  • 在美国,您可以享受次日达和隔日达服务。

类型:字符串

有效值:SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD

必需:是

SnowballCapacityPreference

如果你的工作是在美国某个地区创建的,你可以选择指定你想要什么尺寸的 Snow 设备来完成这项工作。在所有其他地区,Snowball 的存储容量为 80 TB。

有关 Snow Family 设备类型的信息,请参阅 Snowc one 用户指南中的 Sno w 系列设备和容量或 Snowball Edge 用户指南中的 S no w 系列设备和容量

类型:字符串

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

必需:否

SnowballType

用于此集群的 Snow Family 设备类型。

注意

对于集群作业,S Amazon now Family 目前仅支持EDGE设备类型。

有关 Snow Family 设备类型的信息,请参阅 Snowc one 用户指南中的 Sno w 系列设备和容量或 Snowball Edge 用户指南中的 S no w 系列设备和容量

类型:字符串

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

必需:是

TaxDocuments

您所需的税务文件Amazon Web Services 区域.

类型:TaxDocuments 对象

必需:否

响应语法

{ "ClusterId": "string", "JobListEntries": [ { "CreationDate": number, "Description": "string", "IsMaster": boolean, "JobId": "string", "JobState": "string", "JobType": "string", "SnowballType": "string" } ] }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回的以下数据。

ClusterId

为集群自动生成的 ID。

类型:字符串

长度限制:固定长度为为 3。

模式:CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

JobListEntries

为此集群创建的任务列表。有关语法,请参阅本指南JobListEntries中的 ListJobsResult$

类型:JobListEntry 对象数组

错误

有关所有操作常见错误的信息,请参阅常见错误

Ec2RequestFailedException

您的用户缺乏执行尝试操作所必需的 Amazon EC2 权限。

HTTP 状态代码:400

InvalidInputCombinationException

Job 或群集创建失败。一个或多个输入无效。确认CreateCluster:SnowballType值支持您的CreateJob:JobType,然后重试。

HTTP 状态代码:400

InvalidResourceException

找不到指定的资源。请检查您在上次请求中提供的信息,然后重试。

HTTP 状态代码:400

KMSRequestFailedException

提供的Amazon Key Management Service密钥缺乏执行指定CreateJobUpdateJob操作的权限。

HTTP 状态代码:400

另请参阅

有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: