ListPersistentAppInstances - 查询持久会话应用实例列表_无影云应用(App Streaming)-阿里云帮助中心

查询交付组内的持久会话应用实例列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
appstreaming:ListPersistentAppInstances	get	全部资源 ``	无	无

请求参数

名称	类型	必填	描述	示例值
ProductType	string	是	产品类型。枚举值： CloudApp：云应用。 CloudBrowser：云浏览器。 AndroidCloud：云手机。	CloudApp
AppInstanceGroupId	string	是	交付组 ID。	aig-0bxls9m9arax6****
AppInstancePersistentIds	array	否	持久会话 ID 列表。
	string	是	持久会话 ID。	p-0cc7s3mw2fg4j****
PageSize	integer	否	每页的查询结果数量，不可超过 100，默认值为 20。	20
PageNumber	integer	否	需展示的查询结果页码，从 1 开始，默认为 1。	1

返回参数

名称	类型	描述	示例值
	object	响应体。
RequestId	string	请求 ID。	1CBAFFAB-B697-4049-A9B1-67E1FC5F****
TotalCount	integer	查询结果的总数。	15
PageSize	integer	每页的查询结果数量。	20
PageNumber	integer	当前展示的查询结果页码。	1
PersistentAppInstanceModels	array<object>	持久会话应用实例信息列表。
data	object	持久会话应用实例信息。
AppInstancePersistentId	string	持久会话 ID。	p-0cc7s3mw2fg4j****
AppInstancePersistentName	string	持久会话应用实例名称。	test-persistent-name
AppInstancePersistentStatus	string	持久会话应用实例状态。枚举值： STARTING：启动中。 RUNNING：运行中。 STOPPED：已停止。 UNAVAILABLE：不可用。 DELETING：删除中。 PENDING：创建中。 STOPPING：停止中。 DELETED：已删除。 REBUILDING：重置中。	RUNNING
AppInstanceGroupId	string	交付组 ID。	aig-0bxls9m9arax6****
AppInstanceId	string	应用实例 ID。	ai-azn3kmwruh1vl****
AppInstanceStatus	string	应用实例状态。枚举值： INIT：初始化。 STARTING：应用启动中。 CLOSING：应用停止中。 CLOSED：应用已关闭。 RUNNING：应用运行中。 IDLE：空闲。 BOUND：已绑定。 UNAVAILABLE：不可用。 DELETED：已删除。	RUNNING
GmtCreate	string	创建时间。	2025-03-13T03:22:18.000+00:00
AuthorizedUsers	array	授权的用户名列表。
authorizedUsers	string	授权的用户名。	user-001

示例

正常返回示例

JSON格式

{
  "RequestId": "1CBAFFAB-B697-4049-A9B1-67E1FC5F****",
  "TotalCount": 15,
  "PageSize": 20,
  "PageNumber": 1,
  "PersistentAppInstanceModels": [
    {
      "AppInstancePersistentId": "p-0cc7s3mw2fg4j****",
      "AppInstancePersistentName": "test-persistent-name",
      "AppInstancePersistentStatus": "RUNNING",
      "AppInstanceGroupId": "aig-0bxls9m9arax6****",
      "AppInstanceId": "ai-azn3kmwruh1vl****",
      "AppInstanceStatus": "RUNNING",
      "GmtCreate": "2025-03-13T03:22:18.000+00:00",
      "AuthorizedUsers": [
        "user-001"
      ]
    }
  ]
}

错误码

访问错误中心查看更多错误码。