本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
UpdateJob
虽然一份工作JobState
值是New
,您可以更新与任务关联的一些信息。一旦作业变为不同的作业状态(通常在作业创建后 60 分钟内),此操作将不再可用。
请求语法
{
"AddressId": "string
",
"Description": "string
",
"ForwardingAddressId": "string
",
"JobId": "string
",
"Notification": {
"JobStatesToNotify": [ "string
" ],
"NotifyAll": boolean
,
"SnsTopicARN": "string
"
},
"OnDeviceServiceConfiguration": {
"NFSOnDeviceService": {
"StorageLimit": number
,
"StorageUnit": "string
"
},
"TGWOnDeviceService": {
"StorageLimit": number
,
"StorageUnit": "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
"
}
请求参数
有关所有操作通用的参数的信息,请参阅常见参数.
请求接受采用 JSON 格式的以下数据。
- AddressId
-
更新后的 IDAddress对象。
类型: 字符串
长度约束:固定长度为 40。
模式:
ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}
:必需 否
- Description
-
此职位的更新说明JobMetadata对象。
类型: 字符串
长度约束:最小长度为 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}
:必需 否
- 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}
:必需 是
- Notification
-
更新的或更新的Notification对象。
类型:Notification 对象
:必需 否
- OnDeviceServiceConfiguration
-
指定 Snow Family 设备上将传输的数据导出或导入到的服务。AmazonSnow Family 支持 Amazon S3 和 NFS(网络文件系统)和AmazonStorage Gateway 服务磁带网关类型。
类型:OnDeviceServiceConfiguration 对象
:必需 否
- Resources
-
更新后的
JobResource
对象,或者更新的JobResource对象。类型:JobResource 对象
:必需 否
- RoleARN
-
要与此任务关联的新角色 Amazon 资源名称 (ARN)。要创建角色 ARN,请使用CreateRole Amazon Identity and Access Management(IAM) API 操作。
类型: 字符串
长度约束:长度上限为 255。
模式:
arn:aws.*:iam::[0-9]{12}:role/.*
:必需 否
- ShippingOption
-
此作业的更新配送选项值ShippingDetails对象。
类型: 字符串
有效值:
SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD
:必需 否
- SnowballCapacityPreference
-
更新后的
SnowballCapacityPreference
这份工作的JobMetadata对象。50 TB 的 Snowball 仅在美国地区提供。有关 Snow Family 设备类型的信息,请参阅Snow 系列设备和容量中的Snowcone 用户指南要么Snow 系列设备和容量中的Snowball Edge 用户指南.
类型: 字符串
有效值:
T50 | T80 | T100 | T42 | T98 | T8 | T14 | NoPreference
:必需 否
响应元素
如果此操作成功,则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。
错误
有关所有操作常见错误的信息,请参阅常见错误.
- ClusterLimitExceededException
-
创 Job 失败。目前,群集支持五个节点。如果您的集群的节点少于五个,并且需要为此群集创建更多节点,请重试并创建作业,直到集群只有五个节点为止。
HTTP 状态代码:400
- Ec2RequestFailedException
-
您的 IAM 用户缺乏执行尝试操作所需的 Amazon EC2 权限。
HTTP 状态代码:400
- InvalidInputCombinationException
-
创建 Job 或群集失败。一个或多个输入无效。确认创建群集:雪球类型值支持你的创建职位:职位类型,然后重试。
HTTP 状态代码:400
- InvalidJobStateException
-
无法执行该操作,因为作业的当前状态不允许执行该操作。
HTTP 状态代码:400
- InvalidResourceException
-
找不到指定的资源。检查您在上次请求中提供的信息,然后重试。
HTTP 状态代码:400
- KMSRequestFailedException
-
提供的Amazon Key Management Servicekey 缺乏执行指定的权限CreateJob要么UpdateJobaction.
HTTP 状态代码:400
另请参阅
有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: