ListDiscoveryJobs - AWS DataSync

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

ListDiscoveryJobs

提供「探索」中AWS 區域和AWS 帳戶您正在使用「探索」的現有DataSync探查工作清單。

請求語法

{ "MaxResults": number, "NextToken": "string", "StorageSystemArn": "string" }

請求參數

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

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

MaxResults

指定您要在回應中的結果數目。

類型:整數

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

必要:否

NextToken

指定不透明的字串,指出在回應中下一個結果清單開始的位置。

類型:字串

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

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

必要:否

StorageSystemArn

指定現存資源位置的 Amazon Resource Name (ARN)。如果您只想列出與特定儲存系統相關聯的探查工作,請使用此參數。

類型:字串

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

模式:^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$

必要:否

回應語法

{ "DiscoveryJobs": [ { "DiscoveryJobArn": "string", "Status": "string" } ], "NextToken": "string" }

回應元素

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

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

DiscoveryJobs

您執行的探查工作。

類型:DiscoveryJobListEntry 物件陣列

NextToken

不透明的字串,指出在回應中下一個結果清單開始的位置。

類型:字串

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

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

錯誤

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

InternalException

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

HTTP 狀態碼:500

InvalidRequestException

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

HTTP 狀態碼:400

另請參閱

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