本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # UpdateJob **注意** AWS Snowball 邊緣 不再提供給新客戶。新客戶應探索[AWS DataSync](https://aws.amazon.com/datasync/)線上傳輸、用於安全實體傳輸的[AWS 資料傳輸終端機](https://aws.amazon.com/data-transfer-terminal/)，或 AWS 合作夥伴解決方案。對於邊緣運算，請探索 [AWS Outposts](https://aws.amazon.com/outposts/)。 雖然任務`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" } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](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 支援 Amazon S3 和 NFS （網路檔案系統）。 類型：[OnDeviceServiceConfiguration](API_OnDeviceServiceConfiguration.md) 物件 必要：否 ** [PickupDetails](#API_UpdateJob_RequestSyntax) ** AWS Snowball 邊緣 不再提供給新客戶。新客戶應探索[AWS DataSync](https://aws.amazon.com/datasync/)線上傳輸、用於安全實體傳輸的[AWS 資料傳輸終端機](https://aws.amazon.com/data-transfer-terminal/)，或 AWS 合作夥伴解決方案。對於邊緣運算，請探索 [AWS Outposts](https://aws.amazon.com/outposts/)。 識別收取裝置之人員的資訊。 類型：[PickupDetails](API_PickupDetails.md) 物件 必要：否 ** [Resources](#API_UpdateJob_RequestSyntax) ** 更新的`JobResource`物件或更新的[JobResource](API_JobResource.md)物件。 類型：[JobResource](API_JobResource.md) 物件 必要：否 ** [RoleARN](#API_UpdateJob_RequestSyntax) ** 您要與此任務建立關聯的新角色 Amazon Resource Name (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 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/snowball-2016-06-30/UpdateJob) + [AWS 適用於 .NET V4 的 SDK](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 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/snowball-2016-06-30/UpdateJob) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/UpdateJob) + [AWS 適用於 JavaScript V3 的 SDK](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 V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/UpdateJob) + [AWS 適用於 Python 的 SDK](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)