ListWorlds - AWS RoboMaker
请求语法URI请求参数请求正文响应语法响应元素错误另请参阅

终止支持通知：2025 年 9 月 10 日， AWS 将停止对的支持。 AWS RoboMaker2025 年 9 月 10 日之后，您将无法再访问 AWS RoboMaker 控制台或 AWS RoboMaker 资源。有关过渡 AWS Batch 到以帮助运行容器化仿真的更多信息，请访问此博客文章。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

ListWorlds

重要

终止支持通知：2025 年 9 月 10 日， AWS 将停止对的支持。 AWS RoboMaker2025 年 9 月 10 日之后，您将无法再访问 AWS RoboMaker 控制台或 AWS RoboMaker 资源。有关过渡 AWS Batch 到以帮助运行容器化仿真的更多信息，请访问此博客文章。

列出世界。

请求语法

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

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

URI请求参数

该请求不使用任何URI参数。

请求正文

该请求接受以下JSON格式的数据。

filters

用于限制结果的可选筛选器。您可以使用 status。

类型：Filter 对象数组

数组成员：固定数量为 1 项。

必需：否

maxResults

使用此参数时，ListWorlds 仅在单个页面中返回 maxResults 个结果以及 nextToken 响应元素。通过发送另一个带有返回 ListWorlds 值的 nextToken 请求，可以看到初始请求的其余结果。该值必须在 1 到 100 之间。如果不使用此参数，则 ListWorlds 最多返回 100 个结果和一个 nextToken 值（如果适用）。

类型：整数

必需：否

nextToken

如果之前的分页请求未返回所有剩余结果，则响应对象的 nextToken 参数值将设置为令牌。要检索下一组结果，请再次调用 ListWorlds 并将该令牌分配给请求对象的 nextToken 参数。如果没有剩余的结果，则前一个响应对象的 NextToken 参数设置为 null。

类型：字符串

长度限制：最小长度为 0。最大长度为 2048。

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

必需：否

响应语法

HTTP/1.1 200
Content-type: application/json

{
   "nextToken": "string",
   "worldSummaries": [ 
      { 
         "arn": "string",
         "createdAt": number,
         "generationJob": "string",
         "template": "string"
      }
   ]
}

响应元素

如果操作成功，服务将发回 HTTP 200 响应。

以下数据由服务以JSON格式返回。

nextToken

如果之前的分页请求未返回所有剩余结果，则响应对象的 nextToken 参数值将设置为令牌。要检索下一组结果，请再次调用 ListWorlds 并将该令牌分配给请求对象的 nextToken 参数。如果没有剩余的结果，则前一个响应对象的 NextToken 参数设置为 null。

类型：字符串

长度限制：最小长度为 0。最大长度为 2048。

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

worldSummaries

世界汇总信息。

类型：WorldSummary 对象数组

错误

有关所有操作的常见错误的信息，请参阅常见错误。

InternalServerException

AWS RoboMaker 遇到了服务问题。重新尝试您的调用。

HTTP状态码：500

InvalidParameterException

在请求中指定的参数无效、不受支持，或无法使用。请求的消息解释错误值。

HTTP状态码：400

ThrottlingException

AWS RoboMaker 暂时无法处理请求。重新尝试您的调用。

HTTP状态码：400

另请参阅

有关API在一种特定语言中使用此功能的更多信息 AWS SDKs，请参阅以下内容：