DocsICP FilingConsole
Documentation

ListPersistentAppInstances - 查询持久会话应用实例列表

Updated at:
Copy as MD
Product
My Favorites

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

调试

您可以在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>

持久会话应用实例信息列表。

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

授权的用户名列表。

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"
      ]
    }
  ]
}

错误码

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

变更历史

更多信息，参考变更详情。