本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # UpdateJob **注意** AWS Snowball Edge 不再向新客户提供。新客户应探索[AWS DataSync](https://aws.amazon.com/datasync/)在线传输、用于安全物理[传输AWS 的数据传输终端](https://aws.amazon.com/data-transfer-terminal/)或 AWS 合作伙伴解决方案。对于边缘计算，请浏览 [AWS Out](https://aws.amazon.com/outposts/) posts。 虽然作业的 `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" } ``` ## 请求参数 有关所有操作的通用参数的信息，请参阅[常用参数](CommonParameters.md)。 请求接受采用 JSON 格式的以下数据。 ** [AddressId](#API_UpdateJob_RequestSyntax) ** 更新的 [Address](API_Address.md) 对象的 ID。 类型：字符串 长度限制：固定长度为 40。 模式：`ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` 必需：否 ** [Description](#API_UpdateJob_RequestSyntax) ** 此作业的 [JobMetadata](API_JobMetadata.md) 对象的更新描述。 类型：字符串 长度限制：最小长度为 1。长度上限为 1024。 模式：`.*` 必需：否 ** [ForwardingAddressId](#API_UpdateJob_RequestSyntax) ** 您所在的地区不支持此字段。 类型：字符串 长度限制：固定长度为 40。 模式：`ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` 必需：否 ** [JobId](#API_UpdateJob_RequestSyntax) ** 您要更新的作业的作业 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](#API_UpdateJob_RequestSyntax) ** 新的或更新的 [Notification](API_Notification.md) 对象。 类型：[Notification](API_Notification.md) 对象 必需：否 ** [OnDeviceServiceConfiguration](#API_UpdateJob_RequestSyntax) ** 指定 Snow Family 设备上将从中导出或导入您传输的数据的一个或多个服务。 AWS Snowball Edge 支持亚马逊 S3 和 NFS（网络文件系统）。 类型：[OnDeviceServiceConfiguration](API_OnDeviceServiceConfiguration.md) 对象 必需：否 ** [PickupDetails](#API_UpdateJob_RequestSyntax) ** AWS Snowball Edge 不再向新客户提供。新客户应探索[AWS DataSync](https://aws.amazon.com/datasync/)在线传输、用于安全物理[传输AWS 的数据传输终端](https://aws.amazon.com/data-transfer-terminal/)或 AWS 合作伙伴解决方案。对于边缘计算，请浏览 [AWS Out](https://aws.amazon.com/outposts/) posts。 识别设备取货人员的信息。 类型：[PickupDetails](API_PickupDetails.md) 对象 必需：否 ** [Resources](#API_UpdateJob_RequestSyntax) ** 更新的 `JobResource` 对象或更新的 [JobResource](API_JobResource.md) 对象。 类型：[JobResource](API_JobResource.md) 对象 必需：否 ** [RoleARN](#API_UpdateJob_RequestSyntax) ** 要与此作业关联的新角色的 Amazon 资源名称（ARN）。要创建角色 ARN，请使用 [CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html) AWS Identity and Access Management (IAM) API 操作。 类型：字符串 长度限制：长度上限为 255。 模式：`arn:aws.*:iam::[0-9]{12}:role/.*` 必需：否 ** [ShippingOption](#API_UpdateJob_RequestSyntax) ** 此作业的 [ShippingDetails](API_ShippingDetails.md) 对象的更新配送选项值。 类型：字符串 有效值：`SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD` 必需：否 ** [SnowballCapacityPreference](#API_UpdateJob_RequestSyntax) ** 此作业的 [JobMetadata](API_JobMetadata.md) 对象的更新 `SnowballCapacityPreference`。 有关 Snowball Edge 设备类型的信息，请参阅《Snowball Edge 开发者指南》中的[设备硬件信息](https://docs.aws.amazon.com/snowball/latest/developer-guide/device-differences.html)。 类型：字符串 有效值：`T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13` 必需：否 ## 响应元素 如果此操作成功，则该服务会发送回带有空 HTTP 正文的 HTTP 200 响应。 ## 错误 有关所有操作返回的常见错误的信息，请参阅 [常见错误类型](CommonErrors.md)。 ** ClusterLimitExceededException ** 作业创建失败。当前，集群支持五个节点。如果您的集群的节点少于五个，并且要为此集群创建更多节点，请重试并创建作业，直到您的集群恰好有五个节点。 HTTP 状态代码：400 ** Ec2RequestFailedException ** 您的用户缺乏执行尝试操作所必需的 Amazon EC2 权限。 HTTP 状态代码：400 ** InvalidInputCombinationException ** 作业或集群创建失败。一个或多个输入无效。确认[CreateCluster:SnowballType](API_CreateCluster.md#Snowball-CreateCluster-request-SnowballType)值支持您的[CreateJob:JobType](API_CreateJob.md#Snowball-CreateJob-request-JobType)，然后重试。 HTTP 状态代码：400 ** InvalidJobStateException ** 无法执行该操作，因为作业的当前状态不允许执行该操作。 HTTP 状态代码：400 ** InvalidResourceException ** 找不到指定的资源。请查看您在上次请求中提供的信息，然后重试。 ** ResourceType ** 提供的资源值无效。 HTTP 状态代码：400 ** KMSRequestFailedException ** 提供的 AWS Key Management Service 密钥缺少执行指定[CreateJob](API_CreateJob.md)或[UpdateJob](#API_UpdateJob)操作的权限。 HTTP 状态代码：400 ## 另请参阅 有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/snowball-2016-06-30/UpdateJob) + [AWS 适用于.NET 的 SDK V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/snowball-2016-06-30/UpdateJob) + [AWS 适用于 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/UpdateJob) + [AWS 适用于 Go v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/snowball-2016-06-30/UpdateJob) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/UpdateJob) + [AWS JavaScript V3 版软件开发工具包](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snowball-2016-06-30/UpdateJob) + [AWS 适用于 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/snowball-2016-06-30/UpdateJob) + [AWS 适用于 PHP 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/UpdateJob) + [AWS Python 软件开发工具包](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/UpdateJob) + [AWS 适用于 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/UpdateJob)