本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CreateTask
指示一或多個裝置啟動任務，例如解除鎖定或重新啟動。
請求語法
POST /task HTTP/1.1
Content-type: application/json
{
"clientToken": "string",
"command": { ... },
"description": "string",
"tags": {
"string" : "string"
},
"targets": [ "string" ]
}URI 請求參數
請求不會使用任何URI參數。
請求主體
請求接受下列JSON格式的資料。
- clientToken
-
權杖，可確保僅呼叫具有指定詳細資訊的動作一次。
類型：字串
長度限制：長度下限為 1。長度上限為 64。
模式：
^[!-~]+$必要：否
- command
-
要執行的任務。一次在裝置上執行一個任務。
類型：Command 物件
注意：此物件是 Union。只能指定或傳回此物件的一個成員。
必要：是
- description
-
任務及其目標的說明。
類型：字串
長度限制：長度下限為 1。長度上限為 128。
模式：
^[A-Za-z0-9 _.,!#]*$必要：否
-
您指派給資源的選用中繼資料。您可以使用標籤以不同方式分類資源，例如依用途、擁有者或環境。
類型：字串到字串映射
必要：否
- targets
-
受管裝置 的清單IDs。
類型：字串陣列
陣列成員：項目數下限為 1。項目數上限為 10。
必要：是
回應語法
HTTP/1.1 200
Content-type: application/json
{
"taskArn": "string",
"taskId": "string"
}回應元素
如果動作成功，服務會傳回 200 HTTP 個回應。
服務會以 JSON 格式傳回下列資料。
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- AccessDeniedException
-
您沒有足夠的存取權來執行此動作。
HTTP 狀態碼：403
- InternalServerException
-
處理請求時發生非預期的錯誤。
HTTP 狀態碼：500
- ResourceNotFoundException
-
請求參考不存在的資源。
HTTP 狀態碼：404
- ServiceQuotaExceededException
-
請求會導致超過服務配額。
HTTP 狀態碼：402
- ThrottlingException
-
由於請求調節，因此請求遭到拒絕。
HTTP 狀態碼：429
- ValidationException
-
輸入無法滿足 AWS 服務指定的限制條件。
HTTP 狀態碼：400
另請參閱
如需在其中一種語言特定 API中使用此功能的詳細資訊 AWS SDKs，請參閱下列內容：
