本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
CreateJob
创建作业以在 Amazon S3 和您的本地数据中心之间导入或导出数据。您的Amazon Web Services 账户必须具备正确的信任策略和权限才能为 Snow 设备创建作业。如果要为群集中的节点创建作业,则只需提供clusterId
value;其他作业属性从群集继承。
订购群集作业时,仅支持 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 Storage Storage Storage Optimized
-
-
设备类型:EDGE_CG
-
容量:T42
-
描述:Snowball Edge Compute Optimized with GPU
-
-
设备类型:EDGE_C
-
容量:T42
-
描述:无需 GPU Snowball Edge Compute Optimized
-
-
设备类型:边缘
-
容量:T100
-
描述:借助 EC2 计算 Snowball Edge Storage Optimized S
-
-
设备类型:标准
-
容量: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": {
"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 设备类型的信息,请参阅Snow 系列设备和容量中的Snowcone 用户指南要么Snow 系列设备和容量中的Snowball Edge 用户指南.
类型: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
s 是使用CreateKey Amazon 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
-
为此任务定义 Amazon Simple Notification Service (Amazon SNS) 通知设置。
类型:Notification 对象
:必需 否
- OnDeviceServiceConfiguration
-
指定 Snow Family 设备上将传输的数据导出或导入到的服务。AmazonSnow Family 支持 Amazon S3 和 NFS(网络文件系统)和AmazonStorage 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
s 是使用CreateRole Amazon Identity and Access Management(IAM) API 操作。类型: 字符串
长度约束:长度上限为 255。
模式:
arn:aws.*:iam::[0-9]{12}:role/.*
:必需 否
- ShippingOption
-
这项工作的运输速度。这种速度并不决定您多久将获得 Snow 设备,而是代表 Snow 设备在运输过程中移动到目的地的速度。区域运输速度如下所示:
-
在澳大利亚,您可以使用快递。通常,快递运输的 Snowball 设备大约需要一天时间。
-
在欧盟(EU),您可以使用快递。通常,快递运输的 Snowball 设备大约需要一天时间。此外,欧盟的大多数国家/地区还可以使用标准运输,通常单程需要的时间不超过一周。
-
在印度,Snow 设备在一到七天内交付。
-
在美国,您可以选择一日送达和两日送达。
类型: 字符串
有效值:
SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD
:必需 否
-
- SnowballCapacityPreference
-
如果您的作业是在其中一个美国地区创建的,那么您可以选择为此作业指定想要的 Snow 设备的尺寸。在所有其他地区,Snowball 的存储容量为 80 TB。
有关 Snow Family 设备类型的信息,请参阅Snow 系列设备和容量中的Snowcone 用户指南要么Snow 系列设备和容量中的Snowball Edge 用户指南.
类型: 字符串
有效值:
T50 | T80 | T100 | T42 | T98 | T8 | T14 | NoPreference
:必需 否
- SnowballType
-
用于此作业的 Snow Family 设备的类型。
注意 对于群集作业,AmazonSnowball Family 目前仅支持
EDGE
设备类型。类型Amazon用于此工作的 Snow 设备。目前群集作业唯一支持的设备类型为
EDGE
.有关更多信息,请参阅 。Snowball Edge 设备选项在 Snowball 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 对象
:必需 否
响应语法
{
"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
-
您的 IAM 用户缺乏执行尝试操作所需的 Amazon EC2 权限。
HTTP 状态代码:400
- InvalidInputCombinationException
-
创建 Job 或群集失败。一个或多个输入无效。确认创建群集:雪球类型值支持创建职位:职位类型,然后重试。
HTTP 状态代码:400
- InvalidResourceException
-
找不到指定的资源。检查您在上次请求中提供的信息,然后重试。
HTTP 状态代码:400
- KMSRequestFailedException
-
提供的Amazon Key Management Servicekey 缺乏执行指定的权限CreateJob要么UpdateJobaction.
HTTP 状态代码:400
另请参阅
有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: