支援終止通知:在 2025 年 9 月 10 日, AWS 將停止對 的支援 AWS RoboMaker。2025 年 9 月 10 日後,您將無法再存取 AWS RoboMaker 主控台或 AWS RoboMaker 資源。如需有關轉換至 AWS Batch 以協助執行容器化模擬的詳細資訊,請造訪此部落格文章
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
ListSimulationJobs
重要
支援終止通知:2025 年 9 月 10 日, AWS 將停止對 的支援 AWS RoboMaker。2025 年 9 月 10 日後,您將無法再存取 AWS RoboMaker 主控台或 AWS RoboMaker 資源。如需轉換至 AWS Batch 以協助執行容器化模擬的詳細資訊,請造訪此部落格文章
傳回模擬任務的清單。您可以選擇性地提供篩選條件來擷取特定模擬任務。
請求語法
POST /listSimulationJobs HTTP/1.1
Content-type: application/json
{
"filters": [
{
"name": "string
",
"values": [ "string
" ]
}
],
"maxResults": number
,
"nextToken": "string
"
}
URI 請求參數
請求不會使用任何URI參數。
請求主體
請求接受下列JSON格式的資料。
- filters
-
限制結果的選用篩選條件。
robotApplicationName
支援篩選條件名稱status
和simulationApplicationName
和 。篩選時,您必須使用已篩選項目的完整值。您最多可以使用三個篩選條件,但它們必須用於相同的具名項目。例如,如果您正在尋找狀態為Preparing
或狀態為 的項目Running
。類型:Filter 物件陣列
陣列成員:固定項目數為 1。
必要:否
- maxResults
-
使用此參數時,
ListSimulationJobs
只會傳回單一頁面maxResults
的結果以及nextToken
回應元素。傳送另一個具有傳回nextToken
值的ListSimulationJobs
請求,即可查看初始請求的其餘結果。此值可以介於 1 到 1000 之間。如果未使用此參數,則最多ListSimulationJobs
會傳回 1000 個結果和一個nextToken
值,如果適用的話。類型:整數
必要:否
- nextToken
-
如果先前的分頁請求未傳回所有剩餘的結果,回應物件的
nextToken
參數值會設定為權杖。若要擷取下一組結果,請ListSimulationJobs
再次呼叫 ,並將該權杖指派給請求物件的nextToken
參數。如果沒有剩餘的結果,則先前的回應物件 NextToken 參數會設定為 null。類型:字串
長度限制:長度下限為 1。長度上限為 2048。
模式:
[a-zA-Z0-9_.\-\/+=]*
必要:否
回應語法
HTTP/1.1 200
Content-type: application/json
{
"nextToken": "string",
"simulationJobSummaries": [
{
"arn": "string",
"computeType": "string",
"dataSourceNames": [ "string" ],
"lastUpdatedAt": number,
"name": "string",
"robotApplicationNames": [ "string" ],
"simulationApplicationNames": [ "string" ],
"status": "string"
}
]
}
回應元素
如果動作成功,服務會傳回 200 HTTP 個回應。
服務會以 JSON 格式傳回下列資料。
- nextToken
-
如果先前的分頁請求未傳回所有剩餘的結果,回應物件的
nextToken
參數值會設定為權杖。若要擷取下一組結果,請ListSimulationJobs
再次呼叫 ,並將該權杖指派給請求物件的nextToken
參數。如果沒有剩餘的結果,則先前的回應物件 NextToken 參數會設定為 null。類型:字串
長度限制:長度下限為 1。長度上限為 2048。
模式:
[a-zA-Z0-9_.\-\/+=]*
- simulationJobSummaries
-
符合請求條件的模擬任務摘要清單。
類型:SimulationJobSummary 物件陣列
陣列成員:項目數下限為 0。項目數上限為 100。
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
- InternalServerException
-
AWS RoboMaker 發生服務問題。請再次嘗試呼叫。
HTTP 狀態碼:500
- InvalidParameterException
-
在請求中指定的一個參數無效、未支援或無法使用。傳回之訊息會提供錯誤值的說明。
HTTP 狀態碼:400
- ThrottlingException
-
AWS RoboMaker 暫時無法處理請求。請再次嘗試呼叫。
HTTP 狀態碼:400
另請參閱
如需在其中一種語言特定 API中使用此功能的詳細資訊 AWS SDKs,請參閱下列內容: