ListFleets - AWS RoboMaker

AWS RoboMaker 不再提供給新客戶。現有客戶 AWS RoboMaker 可以繼續正常使用該服務。 AWS Batch 現在是執行容器化模擬的首選服務。進一步了解

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

ListFleets

此動作已被取代。

重要

此 API 已不再受支援。如需詳細資訊,請參閱 Sup port 政策頁面中的 2022 年 5 月 2 日更新。

返回艦隊列表。您可以選擇性地提供篩選器以擷取特定叢集。

請求語法

POST /listFleets HTTP/1.1 Content-type: application/json { "filters": [ { "name": "string", "values": [ "string" ] } ], "maxResults": number, "nextToken": "string" }

URI 請求參數

請求不會使用任何 URI 參數。

請求主體

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

filters

可選的過濾器來限制結果。

支援篩選name器名稱。篩選時,您必須使用篩選項目的完整值。您最多可以使用三個篩選器。

類型:Filter 物件陣列

陣列成員:固定項目數為 1。

必要:否

maxResults

使用此參數時,ListFleets只返回maxResults結果與nextToken響應元素一起在單個頁面中。初始請求的剩餘結果可以通過發送帶有返回nextToken值的另一個ListFleets請求來查看。此值可以介於 1 和 200 之間。如果未使用此參數,則會ListFleets傳回最多 200 個結果,並傳回一個nextToken值 (如果適用)。

類型:整數

必要:否

nextToken

如果先前的分頁請求未返回所有剩餘的結果,則響應對象的nextToken參數值被設置為令牌。要檢索下一組結果,請ListFleets再次調用並將該令牌分配給請求對象的nextToken參數。如果沒有剩餘的結果,先前的響應對象的 NextToken 參數設置為 null。

注意

這個令牌應該被視為一個不透明的標識符,僅用於檢索列表中的下一個項目,而不是用於其他編程目的。

類型:字串

長度限制:長度下限為 1。長度上限為 2048。

模式:[a-zA-Z0-9_.\-\/+=]*

必要:否

回應語法

HTTP/1.1 200 Content-type: application/json { "fleetDetails": [ { "arn": "string", "createdAt": number, "lastDeploymentJob": "string", "lastDeploymentStatus": "string", "lastDeploymentTime": number, "name": "string" } ], "nextToken": "string" }

回應元素

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

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

fleetDetails

符合要求條件的叢集詳細資料清單。

類型:Fleet 物件陣列

陣列成員:項目數下限為 0。項目數上限為 200。

nextToken

如果先前的分頁請求未返回所有剩餘的結果,則響應對象的nextToken參數值被設置為令牌。要檢索下一組結果,請ListFleets再次調用並將該令牌分配給請求對象的nextToken參數。如果沒有剩餘的結果,先前的響應對象的 NextToken 參數設置為 null。

類型:字串

長度限制:長度下限為 1。長度上限為 2048。

模式:[a-zA-Z0-9_.\-\/+=]*

錯誤

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

InternalServerException

AWS RoboMaker 遇到服務問題。請再次嘗試呼叫。

HTTP 狀態碼:500

InvalidParameterException

在請求中指定的一個參數無效、未支援或無法使用。傳回之訊息會提供錯誤值的說明。

HTTP 狀態碼:400

ResourceNotFoundException

指定的資源不存在。

HTTP 狀態碼:400

ThrottlingException

AWS 暫 RoboMaker 時無法處理請求。請再次嘗試呼叫。

HTTP 狀態碼:400

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: