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

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

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 的更多信息,请参阅以下内容: