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

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

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

ListFleets

此操作已弃用。

重要

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

重要

API不再支持此功能。有关更多信息，请参阅 Support 政策页面 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 响应元素。通过发送另一个带有返回 ListFleets 值的 nextToken 请求，可以看到初始请求的其余结果。该值必须在 1 到 200 之间。如果不使用此参数，则 ListFleets 最多返回 200 个结果和一个 nextToken 值（如果适用）。

类型：整数

必需：否

nextToken

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

注意

此令牌应被视为不透明标识符，仅用于检索列表中的下一项，不能用于其他编程目的。

类型：字符串

长度限制：最小长度为 0。最大长度为 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。

类型：字符串

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

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

错误

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

InternalServerException

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

HTTP状态码：500

InvalidParameterException

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

HTTP状态码：400

ResourceNotFoundException

指定的资源不存在。

HTTP状态码：400

ThrottlingException

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

HTTP状态码：400

另请参阅

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