ListInstances分页
查询云手机列表接口
服务地址：
华东1（杭州）
输入参数
只看必填
RegionId云手机实例所在的地域
InstanceId云手机实例ID
0云手机实例ID
添加
InstanceName云手机实例名称
Status实例状态
KeyPairName密钥对名称
ZoneId云手机所在可用区
Resolution云手机使用的分辨率
ChargeType付费类型
InstanceType实例规格
ImageId镜像ID
ShowWebRtcToken查询结果中是否返回webRtcToken
请选择布尔值
Tag根据指定的标签筛选实例
0标签列表
Key实例的标签键
Value实例的标签值
添加
Filter查询资源时的筛选条件列表
0过滤条件列表
Key查询实例时的筛选键
Value查询实例时的筛选值
添加
分页参数
NextToken查询凭证（Token）
MaxResults返回的最大数
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

  • 此接口只支持 NextToken 查询方式
  • 返回结果按照云手机创建时间顺序正序返回
  • 通过 NextToken 设置查询凭证（Token），其取值是上一次调用 ListInstances 返回的 NextToken 参数值，再通过 MaxResults 设置单页查询的最大条目数。

请求参数

字段名称字段详情
RegionIdstring

云手机实例所在的地域。

示例值:cn-hangzhou参考取值来源:
    ListRegions
InstanceIdarray<string>

云手机实例 ID，N 的取值范围：1~100。

示例值:cp-xxxxxxxxxx子级条数 <= 101
InstanceNamestring

云手机实例名称。

示例值:phone
Statusstring

实例状态。取值范围：展开详情

示例值:Running
KeyPairNamestring

密钥对名称。必须保持名称唯一性。 长度为 2~128 个英文或中文字符。必须以大小字母或中文开头，不能以 http:// 和 https:// 开头。可以包含数字、半角冒号（:）、下划线（_）或者连字符（-）。

示例值:testKeyPairName参考取值来源:
    ImportKeyPair
    ListKeyPairs
NextTokenstring

查询凭证（Token），取值为上一次 API 调用返回的 NextToken 参数值，初次调用无需配置。

示例值:ADBAAdDWBF2****
MaxResultsinteger<int32>

返回的最大数，取值范围：1~100。

示例值:50
ZoneIdstring

云手机所在可用区。

示例值:cn-hangzhou-i参考取值来源:
    ListZones
Resolutionstring

云手机使用的分辨率。

示例值:1920*1080
ChargeTypestring

付费类型，支持预付费和后付费，可选值：展开详情

示例值:PostPaid
InstanceTypestring

实例规格。

示例值:ecp.ce.large参考取值来源:
    ListInstanceTypes
ImageIdstring

镜像 ID。

示例值:cpm-xxxxxxxxx参考取值来源:
    ImportImage
    CopyImage
    ListImages
    CreateImage
ShowWebRtcTokenboolean

查询结果中是否返回 webRtcToken。

示例值:false
Tagarray<object>

根据指定的标签筛选实例。

子级条数 <= 21
Filterarray<object>

查询资源时的筛选条件列表。

子级条数 <= 10

返回参数

字段名称字段详情
NextTokenstring

返回下一页的查询凭证。

示例值:ADBAAdDWBF2****
RequestIdstring

请求 ID。

示例值:473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
TotalCountinteger<int32>

实例总数。

示例值:3
MaxResultsinteger<int32>

返回的最大数，取值范围：1~100。

示例值:50
Instancesobject
变更历史
变更时间变更内容概要操作
2023-11-08
新增请求参数Filter
2022-02-18
新增请求参数Tag
变更返回参数
2021-09-22
新增请求参数ZoneId
新增请求参数Resolution
新增请求参数ChargeType
新增请求参数InstanceType
新增请求参数ImageId
变更返回参数