本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
CreateJob
创建作业以在 Amazon S3 和您的本地数据中心之间导入或导出数据。您的 AWS 账户必须具有正确的信任策略和权限，才能为 Snow 设备创建作业。如果要为群集中的节点创建作业，则只需提供clusterId值；其他作业属性将从群集继承。
AWS Snow 系列设备类型及其容量。
-
雪系列设备类型：支持硬盘
-
容量：T8
-
描述：Snowcone
-
-
设备类型：边缘
-
容量：T98
-
描述：Snowball Edge Storage Optimized Ottimized
-
-
设备类型：边-CG
-
容量：T42
-
描述：Snowball Edge Compute Optimized with GPU
-
-
设备类型：边缘 C
-
容量：T42
-
描述：Snowball Edge Compute Optimized
-
-
设备类型：边缘
-
容量：T100
-
描述：Snowball Edge Storage Optimized Octimized
-
-
设备类型：STANDARD
-
容量：T50
-
描述：原装 Snowball 设备
注意 此设备仅适用于宁夏、北京和新加坡 AWS 区域。
-
-
设备类型：STANDARD
-
容量：T80
-
描述：原装 Snowball 设备
注意 此设备仅适用于宁夏、北京和新加坡 AWS 区域。
-
请求语法
{
"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"
},
"Resources": {
"Ec2AmiResources": [
{
"AmiId": "string",
"SnowballAmiId": "string"
}
],
"LambdaResources": [
{
"EventTriggers": [
{
"EventResourceARN": "string"
}
],
"LambdaArn": "string"
}
],
"S3Resources": [
{
"BucketArn": "string",
"KeyRange": {
"BeginMarker": "string",
"EndMarker": "string"
}
}
]
},
"RoleARN": "string",
"ShippingOption": "string",
"SnowballCapacityPreference": "string",
"SnowballType": "string",
"TaxDocuments": {
"IND": {
"GSTIN": "string"
}
}
}请求参数
有关所有操作通用的参数的信息，请参阅常见参数。
请求接受采用 JSON 格式的以下数据。
- AddressId
-
Snowte Snowized Notification Notification 的地址的 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}：必需 否
- 描述
-
定义此特定作业的可选描述，例如
Important Photos 2016-08-11。类型: 字符串
长度约束：最小长度为 1。长度上限为 1024。
：必需 否
- DeviceConfiguration
-
定义 AWS Snowcone 作业的设备配置。
有关 SnowSnow Storage Notification 的信息，请参阅雪系列设备和容量中的Snowcone 用户指南或者雪系列设备和容量中的Snowball Edge 用户指南。
类型：DeviceConfiguration 对象
：必需 否
- 转发地址 d
-
您所在区域内不支持此字段。
类型: 字符串
长度约束：固定长度为 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您希望与此作业关联的对象键。KmsKeyARNs 是使用CreateKeyAWS Key Management Service (KMS) API 操作。类型: 字符串
长度约束：长度上限为 255。
模式：
arn:aws.*:kms:.*:[0-9]{12}:key/.*：必需 否
- 长期价格信息
-
设备的长期定价类型的 ID。
类型: 字符串
长度约束：固定长度为 41。
模式：
LTPID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}：必需 否
- 通知
-
定义此任务的 Amazon Simple Notification Service (Amazon SNS) 通知设置。
类型：Notification 对象
：必需 否
- 资源
-
定义与此任务关联的 Amazon S3 存储桶。
与
IMPORT作业中，您可以指定将传输的数据导入到的一个或多个存储桶。与
EXPORT作业时，您可以指定将传输数据从中导出的一个或多个存储桶。或者，也可以指定KeyRange值。如果您选择导出特定范围的对象键，您可以通过提供包含范围的大小，来定义范围的大小。BeginMarker值，一个包容性EndMarker值，或者两者。范围按 UTF-8 二进制排序。类型：JobResource 对象
：必需 否
- RoleARN
-
这些区域有：
RoleARN您希望与此作业关联的对象键。RoleArns 是使用CreateRoleAWS Identity and Access Management (IAM) API 操作。类型: 字符串
长度约束：长度上限为 255。
模式：
arn:aws.*:iam::[0-9]{12}:role/.*：必需 否
- ShippingOption
-
此作业的配送速度。此速度并不决定您将多久获得 Snow 设备，而是代表 Snow 设备在运输途中移动到目的地的速度。区域配送速度如下所示：
-
在澳大利亚，您可以使用快递运输。通常，SnowEdge Storage Notification 大约需要一天时间。
-
在欧盟 (EU)，您可以使用快递运输。通常，SnowEdge Storage Notification 大约需要一天时间。此外，欧盟的大多数国家/地区还可以使用标准运输，通常单程需要的时间不超过一周。
-
在印度，雪设备在一到七天内交付。
-
在美国，您可以选择一日送达和两日送达。
类型: 字符串
有效值：
SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD：必需 否
-
- SnowballCapacityPreference
-
如果您的作业是在美国某个地区创建的，您可以选择为此作业指定希望使用的 Snow 设备大小。在所有其他地区，雪球都有 80 TB 的存储容量。
有关 SnowSnow Storage Notification 的信息，请参阅雪系列设备和容量中的Snowcone 用户指南或者雪系列设备和容量中的Snowball Edge 用户指南。
类型: 字符串
有效值：
T50 | T80 | T100 | T42 | T98 | T8 | T14 | NoPreference：必需 否
- SnowballType
-
用于此任务的 AWS Snow 系列设备的类型。
注意 对于集群作业，AWS Snow 系列目前仅支持
EDGE设备类型。用于此任务的 AWS Snow 设备的类型。目前，群集作业唯一支持的设备类型是
EDGE。有关更多信息，请参阅 。Snowball Edge 设备选项在 Snowball Edge 开发人员指南中。
有关 SnowSnow Storage Notification 的信息，请参阅雪系列设备和容量中的Snowcone 用户指南或者雪系列设备和容量中的Snowball Edge 用户指南。
类型: 字符串
有效值：
STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD：必需 否
- 税务文件
-
您的 AWS 区域所需的税务文件。
类型：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}
Errors
有关所有操作常见错误的信息，请参阅常见错误。
- 集群限制性贴身感觉
-
创建 Job 失败。目前，群集支持五个节点。如果您的集群有少于五个节点，并且要为此群集创建更多节点，请重试并创建作业，直到您的集群正好有五个节点为止。
HTTP 状态代码：400
- EC2 请求失败操作
-
您的 IAM 用户缺乏执行尝试操作所需的 Amazon EC2 权限。
HTTP 状态代码：400
- 无效的输入组合异常
-
Job 或集群创建失败。一个或多个输入无效。确认创作群集:雪球型值支持您的创建作业:作业类型，然后重试。
HTTP 状态代码：400
- 无效资源异常
-
找不到指定的资源。请检查您在上次请求中提供的信息，然后重试。
HTTP 状态代码：400
- KMS 请求失败程序
-
提供的 AWS Key Management Service 密钥缺乏执行指定CreateJob或者UpdateJobaction.
HTTP 状态代码：400