ListTasks - AWS DataSync

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

ListTasks

傳回您建立的AWS DataSync任務清單。

請求語法

{ "Filters": [ { "Name": "string", "Operator": "string", "Values": [ "string" ] } ], "MaxResults": number, "NextToken": "string" }

請求參數

如需所有動作共用參數的相關資訊,請參閱一般參數

請求接受採用 JSON 格式的下列資料。

Filters

您可以使用 API 篩選器,以縮小傳回的資源清單ListTasks。例如,若要擷取特定來源位置上的所有工作,您可以使ListTasks用篩選器名稱LocationIdOperator Equals位置的 ARN。

類型:TaskFilter 物件陣列

必要:否

MaxResults

要傳回的任務數上限。

類型:整數

有效範圍:最小值為 0。最大值為 100。

必要:否

NextToken

不透明字串,指出下一個工作清單的開始位置。

類型:字串

長度限制:長度限制:長度上限為 65535。

模式:[a-zA-Z0-9=_-]+

必要:否

回應語法

{ "NextToken": "string", "Tasks": [ { "Name": "string", "Status": "string", "TaskArn": "string" } ] }

回應元素

如果動作成功,則服務傳回 HTTP 200 回應。

服務會傳回下列 JSON 格式的資料。

NextToken

不透明字串,指出要開始傳回下一個工作清單的位置。

類型:字串

長度限制:長度限制:長度上限為 65535。

模式:[a-zA-Z0-9=_-]+

Tasks

返回的所有任務的列表。

類型:TaskListEntry 物件陣列

錯誤

如需所有動作常見的錯誤相關資訊,請參閱常見錯誤

InternalException

當在AWS DataSync服務中發生錯誤時,拋出此異常。

HTTP 狀態碼:500

InvalidRequestException

當客戶端提交格式錯誤的請求時,拋出此異常。

HTTP 狀態碼:400

另請參閱

如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊,請參閱下列說明: