本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
UpdateJob
重要
支援結束通知：2024 年 11 月 12 日， AWS 將停止上一代 AWS Snowball 裝置，以及 Snowcone 裝置 (HDD 和 SDD)。我們將持續支援使用這些 end-of-life裝置的現有客戶，直到 2025 年 11 月 12 日為止。最新一代 AWS 的 Snowball 裝置適用於所有客戶。如需詳細資訊，請造訪此部落格文章
雖然任務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》。
請求接受以下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 支援 Amazon S3 和 NFS（網路檔案系統）。
類型：OnDeviceServiceConfiguration 物件
必要：否
- PickupDetails
-
重要
支援結束通知：2024 年 11 月 12 日， AWS 將停止上一代 AWS Snowball 裝置，以及 Snowcone 裝置 (HDD 和 SDD)。我們將持續支援使用這些 end-of-life裝置的現有客戶，直到 2025 年 11 月 12 日為止。最新一代 AWS 的 Snowball 裝置適用於所有客戶。如需詳細資訊，請造訪此部落格文章
。 識別提取裝置人員的資訊。
類型：PickupDetails 物件
必要：否
- Resources
-
更新的
JobResource物件或更新的JobResource物件。類型：JobResource 物件
必要：否
- RoleARN
-
您要與此任務建立關聯的新角色 Amazon Resource Name (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必要：否
回應元素
如果動作成功，服務會傳回 200 HTTP 回應，且內HTTP文為空白。
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- ClusterLimitExceededException
-
任務建立失敗。目前，叢集支援五個節點。如果您的叢集有少於五個節點，而且要為此叢集建立更多節點，請再試一次並建立任務，直到叢集只有五個節點。
HTTP 狀態碼：400
- Ec2RequestFailedException
-
您的使用者缺少執行嘗試動作所需的 Amazon EC2許可。
HTTP 狀態碼：400
- InvalidInputCombinationException
-
任務或叢集建立失敗。一或多個輸入無效。確認 CreateCluster：SnowballType 值支援您的 CreateJob：JobType，然後再試一次。
HTTP 狀態碼：400
- InvalidJobStateException
-
無法執行動作，因為任務的目前狀態不允許執行該動作。
HTTP 狀態碼：400
- InvalidResourceException
-
找不到指定的資源。請檢查您在上次請求中提供的資訊，然後再試一次。
HTTP 狀態碼：400
- KMSRequestFailedException
-
提供的 AWS Key Management Service 金鑰缺少執行指定 CreateJob或 UpdateJob動作的許可。
HTTP 狀態碼：400
另請參閱
如需在其中一種特定語言API中使用此功能的詳細資訊 AWS SDKs，請參閱以下內容：
