本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
UpdateJob
注意
自 2025 年 11 月 7 日 AWS Snowball Edge 起，将仅向现有客户开放。如果您想使用 AWS Snowball Edge，请在该日期之前注册。新客户应探索AWS DataSync
虽然作业的 JobState 值为 New，您可以更新与作业关联的一些信息。一旦该作业变为另一作业状态（通常在作业创建后的 60 分钟内），此操作将不再可用。
请求语法
{
"AddressId": "string",
"Description": "string",
"ForwardingAddressId": "string",
"JobId": "string",
"Notification": {
"DevicePickupSnsTopicARN": "string",
"JobStatesToNotify": [ "string" ],
"NotifyAll": boolean,
"SnsTopicARN": "string"
},
"OnDeviceServiceConfiguration": {
"EKSOnDeviceService": {
"EKSAnywhereVersion": "string",
"KubernetesVersion": "string"
},
"NFSOnDeviceService": {
"StorageLimit": number,
"StorageUnit": "string"
},
"S3OnDeviceService": {
"FaultTolerance": number,
"ServiceSize": number,
"StorageLimit": number,
"StorageUnit": "string"
},
"TGWOnDeviceService": {
"StorageLimit": number,
"StorageUnit": "string"
}
},
"PickupDetails": {
"DevicePickupId": "string",
"Email": "string",
"IdentificationExpirationDate": number,
"IdentificationIssuingOrg": "string",
"IdentificationNumber": "string",
"Name": "string",
"PhoneNumber": "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
-
更新的 Address 对象的 ID。
类型：字符串
长度限制：固定长度为 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 设备上将从中导出或导入您传输的数据的一个或多个服务。 AWS Snowball Edge 支持亚马逊 S3 和 NFS（网络文件系统）。
类型：OnDeviceServiceConfiguration 对象
必需：否
- PickupDetails
-
注意
自 2025 年 11 月 7 日 AWS Snowball Edge 起，将仅向现有客户开放。如果您想使用 AWS Snowball Edge，请在该日期之前注册。新客户应探索AWS DataSync
在线传输、用于安全物理传输AWS 的数据传输终端 或 AWS 合作伙伴解决方案。对于边缘计算，请浏览 AWS Out posts。 识别设备取货人员的信息。
类型：PickupDetails 对象
必需：否
- Resources
-
更新的
JobResource对象或更新的 JobResource 对象。类型：JobResource 对象
必需：否
- RoleARN
-
要与此作业关联的新角色的 Amazon 资源名称（ARN）。要创建角色 ARN，请使用 CreateRole AWS Identity and Access Management (IAM) API 操作。
类型：字符串
长度限制：长度上限为 255。
模式：
arn:aws.*:iam::[0-9]{12}:role/.*必需：否
- ShippingOption
-
此作业的 ShippingDetails 对象的更新配送选项值。
类型：字符串
有效值：
SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD必需：否
- SnowballCapacityPreference
-
此作业的 JobMetadata 对象的更新
SnowballCapacityPreference。有关 Snowball Edge 设备类型的信息，请参阅《Snowball Edge 开发者指南》中的设备硬件信息。
类型：字符串
有效值：
T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13必需：否
响应元素
如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。
错误
有关所有操作返回的常见错误的信息，请参阅 常见错误。
- ClusterLimitExceededException
-
作业创建失败。当前，集群支持五个节点。如果您的集群的节点少于五个，并且要为此集群创建更多节点，请重试并创建作业，直到您的集群恰好有五个节点。
HTTP 状态代码：400
- Ec2RequestFailedException
-
您的用户缺乏执行尝试操作所必需的 Amazon EC2 权限。
HTTP 状态代码：400
- InvalidInputCombinationException
-
作业或集群创建失败。一个或多个输入无效。确认CreateCluster:SnowballType值支持您的CreateJob:JobType，然后重试。
HTTP 状态代码：400
- InvalidJobStateException
-
无法执行该操作，因为作业的当前状态不允许执行该操作。
HTTP 状态代码：400
- InvalidResourceException
-
找不到指定的资源。请查看您在上次请求中提供的信息，然后重试。
- ResourceType
-
提供的资源值无效。
HTTP 状态代码：400
- KMSRequestFailedException
-
提供的 AWS Key Management Service 密钥缺少执行指定CreateJob或UpdateJob操作的权限。
HTTP 状态代码：400
另请参阅
有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容：
