本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
UpdateJob
當工作的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 Snow 系列支援 Amazon S3 和 NFS (網路檔案系統)。
類型:OnDeviceServiceConfiguration 物件
必要:否
- PickupDetails
-
識別拿起裝置之人員的資訊。
類型: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
的更新。50 TB 的雪球僅在美國地區提供。如需有關 Snow 系列裝置類型的資訊,請參閱 Snowball 使用指南中的 S now 系列裝置和容量或 Snowball Edge 使用者指南中的 S now 系列裝置和容量。
類型:字串
有效值:
T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13
必要:否
回應元素
如果動作成功,則服務會傳回具空 HTTP 內文的 HTTP 200 回應。
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
- ClusterLimitExceededException
-
Job 建立失敗。目前,叢集支援五個節點。如果叢集的節點少於五個,而且要為此叢集建立更多節點,請再試一次並建立工作,直到叢集剛好有五個節點為止。
HTTP 狀態碼:400
- Ec2RequestFailedException
-
您的使用者缺少必要的 Amazon EC2 許可來執行嘗試的動作。
HTTP 狀態碼:400
- InvalidInputCombinationException
-
Job 或叢集建立失敗。一個或多個輸入無效。請確認CreateCluster:SnowballType值支援您的CreateJob:JobType,然後再試一次。
HTTP 狀態碼:400
- InvalidJobStateException
-
無法執行動作,因為工作的目前狀態不允許執行該動作。
HTTP 狀態碼:400
- InvalidResourceException
-
找不到指定的資源。請檢查您上次要求中提供的資訊,然後再試一次。
HTTP 狀態碼:400
- KMSRequestFailedException
-
提供的 AWS Key Management Service 金鑰缺乏執行指定CreateJob或UpdateJob動作的權限。
HTTP 狀態碼:400
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: