ListWorldGenerationJobs - AWS RoboMaker
請求語法URI 請求參數請求主體回應語法回應元素錯誤另請參閱

支援終止通知：2025 年 9 月 10 日， AWS 將停止對 的支援 AWS RoboMaker。2025 年 9 月 10 日後，您將無法再存取 AWS RoboMaker 主控台或 AWS RoboMaker 資源。如需有關轉換至 AWS Batch 以協助執行容器化模擬的詳細資訊，請造訪此部落格文章 。

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

ListWorldGenerationJobs

重要

支援終止通知：2025 年 9 月 10 日， AWS 將停止對 的支援 AWS RoboMaker。2025 年 9 月 10 日後，您將無法再存取 AWS RoboMaker 主控台或 AWS RoboMaker 資源。如需有關轉換至 AWS Batch 以協助執行容器化模擬的詳細資訊，請造訪此部落格文章 。

列出世界產生器任務。

請求語法

POST /listWorldGenerationJobs HTTP/1.1
Content-type: application/json

{
   "filters": [ 
      { 
         "name": "string",
         "values": [ "string" ]
      }
   ],
   "maxResults": number,
   "nextToken": "string"
}

URI 請求參數

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

請求主體

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

filters

限制結果的選用篩選條件。您可以使用 status 與 templateId。

類型：Filter 物件陣列

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

必要：否

maxResults

使用此參數時，ListWorldGeneratorJobs只會傳回單一頁面maxResults的結果以及nextToken回應元素。傳送另一個具有傳回nextToken值的ListWorldGeneratorJobs請求，即可查看初始請求的其餘結果。此值可以介於 1 到 100 之間。如果未使用此參數，則 最多ListWorldGeneratorJobs傳回 100 個結果和一個nextToken值，如果適用。

類型：整數

必要：否

nextToken

如果先前的分頁請求未傳回所有剩餘的結果，回應物件的nextToken參數值會設定為權杖。若要擷取下一組結果，請ListWorldGenerationJobsRequest再次呼叫 ，並將該權杖指派給請求物件的 nextToken 參數。如果沒有剩餘的結果，則先前的回應物件 NextToken 參數會設定為 null。

類型：字串

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

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

必要：否

回應語法

HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "worldGenerationJobSummaries": [ 
      { 
         "arn": "string",
         "createdAt": number,
         "failedWorldCount": number,
         "status": "string",
         "succeededWorldCount": number,
         "template": "string",
         "worldCount": { 
            "floorplanCount": number,
            "interiorCountPerFloorplan": number
         }
      }
   ]
}

回應元素

如果動作成功，服務會傳回 200 HTTP 個回應。

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

nextToken

如果先前的分頁請求未傳回所有剩餘的結果，回應物件的nextToken參數值會設定為權杖。若要擷取下一組結果，請ListWorldGeneratorJobsRequest再次呼叫 ，並將該權杖指派給請求物件的 nextToken 參數。如果沒有剩餘的結果，則先前的回應物件 NextToken 參數會設定為 null。

類型：字串

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

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

worldGenerationJobSummaries

世界發電機任務的摘要資訊。

類型：WorldGenerationJobSummary 物件陣列

陣列成員：項目數下限為 0。項目數上限為 100。

錯誤

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

InternalServerException

AWS RoboMaker 發生服務問題。請再次嘗試呼叫。

HTTP 狀態碼：500

InvalidParameterException

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

HTTP 狀態碼：400

ThrottlingException

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

HTTP 狀態碼：400

另請參閱

如需在其中一種語言特定的 API中使用此功能的詳細資訊 AWS SDKs，請參閱下列內容：