本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateJob
创建作业以在 Amazon S3 和您的本地数据中心之间导入或导出数据。你Amazon Web Services 账户必须有正确的信任策略和权限才能为 Snow 设备创建任务。如果您要为集群中的节点创建任务，则只需提供clusterId值；其他作业属性是从集群继承的。
订购集群任务时仅支持 Snowball; Edge 设备类型。
设备容量是可选的。
设备类型的可用性因而异Amazon Web Services 区域。有关区域可用性的更多信息，请参阅Amazon区域服务
Snow Family 设备及其容量。
-
Snow Family 设备类型：SNC1_SSD
-
容量：T14
-
描述：Snowcone
-
-
Snow Family 设备类型：SNC1_HDD
-
容量：T8
-
描述：Snowcone
-
-
设备类型：EDGE_S
-
容量：T98
-
描述：Snowball Edge 存储仅针对数据传输进行了优化
-
-
设备类型：EDGE_CG
-
容量：T42
-
描述：使用 GPU Snowball Edge Compute Optimized
-
-
设备类型：EDGE_C
-
容量：T42
-
描述：Snowball Edge Compute Optimized 有 GPU
-
-
设备类型：EDGE
-
容量：T100
-
描述：使用 EC2 计算Snowball Edge Storage Optimized
-
-
设备类型：标准
-
容量：T50
-
描述：原装 Snowball 设备
注意 此设备仅在宁夏、北京和新加坡可用Amazon Web Services 区域
-
-
设备类型：标准
-
容量：T80
-
描述：原装 Snowball 设备
注意 此设备仅在宁夏、北京和新加坡可用Amazon Web Services 区域。
-
请求语法
{
"AddressId": "string",
"ClusterId": "string",
"Description": "string",
"DeviceConfiguration": {
"SnowconeDeviceConfiguration": {
"WirelessConnection": {
"IsWifiEnabled": boolean
}
}
},
"ForwardingAddressId": "string",
"JobType": "string",
"KmsKeyARN": "string",
"LongTermPricingId": "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",
"SnowballCapacityPreference": "string",
"SnowballType": "string",
"TaxDocuments": {
"IND": {
"GSTIN": "string"
}
}
}请求参数
有关所有操作的通用参数的信息，请参阅通用参数。
请求接受采用 JSON 格式的以下数据。
- AddressId
-
您要将 Snow 设备配送到的地址的 ID。
类型：字符串
长度限制：固定长度为 40。
模式：
ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}必需：否
- ClusterId
-
集群的 ID。如果您要为集群中的节点创建任务，则只需提供此
clusterId值即可。其他作业属性是从集群继承的。类型：字符串
长度限制：固定长度为 39。
模式：
CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}必需：否
- Description
-
例如，定义此特定工作的可选描述
Important Photos 2016-08-11。类型：字符串
长度限制：最小长度为 1。长度上限为 1024。
模式：
.*必需：否
- DeviceConfiguration
-
定义Amazon Snowcone作业的设备配置。
有关 Snow Family 设备类型的信息，请参阅 Snowcone 用户指南中的 Sno w 系列设备和容量或 Snowb all Edge 用户指南中的 S now 系列设备和容量。
类型：DeviceConfiguration 对象
必需：否
- ForwardingAddressId
-
您所在区域不支持此字段。
类型：字符串
长度限制：固定长度为 40。
模式：
ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}必需：否
- JobType
-
定义要创建的任务类型。
类型：字符串
有效值:
IMPORT | EXPORT | LOCAL_USE必需：否
- KmsKeyARN
-
你
KmsKeyARN想与工作关联的。KmsKeyARN是使用 CreateKeyAmazon Key Management Service(KMS) API 操作创建的。类型：字符串
长度限制：最大长度为 255。
模式：
arn:aws.*:kms:.*:[0-9]{12}:key/.*必需：否
- LongTermPricingId
-
设备长期定价类型的 ID。
类型：字符串
长度限制：固定长度为 41。
模式：
LTPID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}必需：否
- Notification
-
为任务定义Simple Notification Service (Amazon SNS) 通知设置。
类型：Notification 对象
必需：否
- OnDeviceServiceConfiguration
-
指定 Snow Family 设备上的一个或多个服务，您传输的数据将从中导出或导入到这些服务。 AmazonSnow Family 支持 Amazon S3 和 NFS（网络文件系统）以及Amazon Storage Gateway 服务磁带网关类型。
类型：OnDeviceServiceConfiguration 对象
必需：否
- RemoteManagement
-
允许您从内部网络外部安全地远程操作和管理 Snowcone 设备。设置为时
INSTALLED_AUTOSTART，当设备到达您的位置时，远程管理将自动可用。否则，你需要使用 Snowball 客户端来管理设备。类型：字符串
有效值:
INSTALLED_ONLY | INSTALLED_AUTOSTART必需：否
- Resources
-
定义与此任务关联的 Amazon S3 存储桶。
对于
IMPORT任务，您可以指定将传输的数据导入一个或多个存储桶。对于
EXPORT任务，您可以指定要从哪个或多个存储桶中导出传输的数据。您还可以指定KeyRange值。如果您选择导出范围，则可以通过提供包含值、包含BeginMarker值或同时提供两者来定义范围的长度。EndMarker范围按 UTF-8 二进制排序。类型：JobResource 对象
必需：否
- RoleARN
-
你
RoleARN想与工作关联的。RoleArn是使用 CreateRoleAmazon Identity and Access Management(IAM) API 操作创建的。类型：字符串
长度限制：最大长度为 255。
模式：
arn:aws.*:iam::[0-9]{12}:role/.*必需：否
- ShippingOption
-
此任务的运送速度。这个速度并不决定你多久能收到 Snow 设备，而是表示 Snow 设备在运输过程中移动到目的地的速度。区域运输速度如下：
-
在澳大利亚，您可以使用快递运输。通常，快递运送的 Snow 设备大约在一天内送达。
-
在欧盟 (EU)，您可以使用快递。通常，快递运送的 Snow 设备大约在一天内送达。此外，欧盟的大多数国家/地区还可以使用标准运输，通常单程需要的时间不超过一周。
-
在印度，Snow 设备在一到七天内交付。
-
在美国，您可以享受一日送达和两日送达。
类型：字符串
有效值:
SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD必需：否
-
- SnowballCapacityPreference
-
如果你的任务是在美国的一个地区创建的，你可以选择指定你想要什么尺寸的 Snow 设备来完成这项工作。在所有其他地区，Snowballs 的存储容量为 80 TB。
有关 Snow Family 设备类型的信息，请参阅 Snowcone 用户指南中的 Sno w 系列设备和容量或 Snowb all Edge 用户指南中的 S now 系列设备和容量。
类型：字符串
有效值:
T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference必需：否
- SnowballType
-
用于此任务的 Snow Family 设备类型。
注意 对于集群作业，SAmazon now Family 目前仅支持
EDGE设备类型。用于此任务的 SnoAmazon w 设备类型。目前，集群任务唯一支持的设备类型为
EDGE。有关更多信息，请参阅 Snowball NOLL Edge 开发人员指南中的Snowball 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 对象
必需：否
响应语法
{
"JobId": "string"
}响应元素
如果此操作成功，则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回的以下数据。
- JobId
-
例如，为任务自动生成的 ID
JID123e4567-e89b-12d3-a456-426655440000。类型：字符串
长度限制：固定长度为 39。
模式：
(M|J)ID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}
错误
有关所有操作常见错误的信息，请参阅常见错误。
- ClusterLimitExceededException
-
Job 创建失败。目前，集群支持五个节点。如果您的集群节点少于五个，并且要为该集群创建更多节点，请重试创建任务，直到您的集群恰好有五个节点。
HTTP 状态代码：400
- 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 的更多信息，请参阅以下内容：