DescribeAndroidInstances - 查询实例详细信息

查询云手机实例的详情信息。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

InstanceGroupId

string

实例组 ID。

ag-25nt4kk9whjh****

KeyPairId

string

已绑定的密钥对 ID。

kp-5hh431emkpuoi****

AndroidInstanceIds

array

实例 ID 列表。

string

实例 ID。

acp-25nt4kk9whhok****

AndroidInstanceName

string

实例名称。

name

Status

string

实例状态。

枚举值:
  • BACKUPING :

    文件备份中

  • STARTING :

    开机中

  • RUNNING :

    可用

  • DELETING :

    删除中

  • BACKUP_FAILED :

    文件备份失败

  • DELETED :

    已删除

  • FAILED :

    创建失败

  • STOPPED :

    已关机

  • RECOVERING :

    文件恢复中

  • UNAVAILABLE :

    异常

  • REBOOTING :

    重启中

  • RESETTING :

    重置中

  • STOPPING :

    关机中

  • RECOVER_FAILED :

    文件恢复失败

  • CREATING :

    创建中

RUNNING

SaleMode

string

售卖模式。

枚举值:
  • Instance :

    云手机实例模式

  • Node :

    云手机矩阵模式

Instance

MaxResults

integer

分页查询时每页的最大条目数。取值范围 1~100,默认值为 100。

20

NextToken

string

用来表示当前开始读取的位置。置空表示从头开始。

AAAAAV3MpHK1AP0pfERHZN5pu6kw9dGL5jves2FS9RLq****

InstanceGroupIds

array

实例组 ID 列表。

string

实例组 ID。

ag-25nt4kk9whhdh****

InstanceGroupName

string

实例组名称。

test

ChargeType

string

付费类型。

枚举值:
  • PostPaid :

    后付费

  • PrePaid :

    预付费

PostPaid

Tag

array<object>

资源的标签。

object

资源的标签。

Key

string

标签键。

key

Value

string

标签值。

value

BizRegionId

string

地域 ID。可以通过调用 DescribeRegions 查询云手机不同版本(实例版/矩阵版)支持购买的地域列表。

cn-shanghai

NodeId

string

矩阵 ID。

node_id

NodeName

string

矩阵的名称。

node_name

OfficeSiteIds

array

云手机网络 ID。

string

云手机网络 ID。

cn-hangzhou+dir-744962****

AuthorizedUserId

string

实例分配的用户 ID,即无影便捷账号 ID。

user

QosRuleIds

array

公网限速规则组 ID。基础共享网络中的实例限速规则。

string

公网限速规则组 ID。

qos-g6no280ed8byi****

AppManagePolicyId

string

应用管控规则 ID。

amp-shigvudbyeuib****

PrivateIpAddress

string

实例的私网 IP 地址。

10.0.162.136

返回参数

名称

类型

描述

示例值

object

返回信息。

RequestId

string

请求 ID。

F07A1DA1-E1EB-5CCA-8EED-12F85D32****

TotalCount

integer

总条目数。

10

NextToken

string

用来表示当前调用返回读取到的位置。空代表数据已经读取完毕。

AAAAAV3MpHK1AP0pfERHZN5pu6kmma/xxE9WtwL/ADvZ****

InstanceModel

array<object>

实例信息。

object

实例信息。

AndroidInstanceGroupId

string

实例所属实例组的 ID。

ag-ayyhomlal7po****

AndroidInstanceGroupName

string

实例组名称。

AndroidInstanceGroupName

AndroidInstanceId

string

实例 ID。

acp-8at8h6ejkadjh****

AndroidInstanceName

string

实例名称。

name

AndroidInstanceStatus

string

实例状态。

RUNNING

NetworkInterfaceIp

string

网卡 IP。

192.168.22.48

AuthorizedUserId

string

已分配的用户。

test

BindUserId

string

已绑定的用户。

test

PersistentAppInstanceId

string

持久会话 ID。

p-0btrd5zj8epo****

AppInstanceId

string

物理实例 ID。

ai-9ey6io0q58rcd****

KeyPairId

string

密钥对 ID。

kp-5hh431emkpucs****

GmtCreate

string

创建时间。

2023-05-06 10:42:10

GmtModified

string

修改时间。

2023-05-06 10:42:10

AppInstanceGroupId

string

交付组 ID。

aig-i7yv6tkn7kh8dv****

RegionId

string

地域 ID。

cn-hangzhou

Rate

integer

实例数据备份中和恢复中的进度。

100

ErrorCode

string

实例数据备份失败和恢复失败的错误原因。

FilePathNotFound

RenderingType

string

渲染类型。

local

InstanceType

string

实例类型。

acp.basic.small

ChargeType

string

实例的计费类型。

PrePaid

GmtExpired

string

包年包月实例组的过期时间。

2024-07-15T02:03:33Z

PolicyGroupId

string

策略组 ID。

pg-0bszojpu0seql****

OfficeSiteId

string

网络 ID。对应控制台上创建时所选择的网络(基础共享网络,高级共享网络)

cn-shenzhen+dir-211620****

VSwitchId

string

专有网络中的交换机 ID。

vsw-2zepmau2hsbhos42****

Memory

integer

内存大小。

1024

Cpu

string

CPU 核数。

4

Disks

array<object>

磁盘信息。

object

磁盘信息。

DiskType

string

磁盘类型。

SYSTEM

DiskSize

integer

磁盘大小。单位:GB。

32

Tags

array<object>

标签列表。

object

标签信息。

Key

string

标签键。

key

Value

string

标签值。

value

ImageVersion

string

镜像版本。

3.5.3.867

PublicIpAddress

string

公网 IP。

10.32.1.41

SessionStatus

string

会话连接状态。

枚举值:
  • disConnect :

    未连接

  • connect :

    连接

connect

NetworkInterfaceIpv6Address

string

说明

该参数暂未对外开放使用。

null

PublicIpv6Address

string

说明

该参数暂未对外开放使用。

null

ImageId

string

镜像 ID。

imgc-075cllfeuazh0****

DisplayConfig

object

显示设置。

ResolutionHeight

integer

分辨率的高。单位:像素。

1280

ResolutionWidth

integer

分辨率的宽。单位:像素。

720

Dpi

integer

DPI。

240

Fps

integer

帧率。

30

LockResolution

string

锁定分辨率。

枚举值:
  • off :

    关闭

  • on :

    开启

off

QosRuleId

string

公网限速规则 ID(仅作用于精品带宽)

qos-5605u0gelk200****

AppManagePolicy

object

应用管控规则信息。对应管制台的应用管控规则的黑白名单管理。

AppManagePolicyId

string

应用管控规则 ID。

amp-dgiavcvibfdds****

AppManagePolicyName

string

应用管控规则名称。

应用组1

ZoneId

string

实例所属的可用区 ID。

cn-hangzhou-h

PhoneDataInfo

object

云手机矩阵版实例的独立机身存储信息。

PhoneDataId

string

独立机身存储 ID。

pd-sbcudgidbhb****

PhoneDataVolume

integer

独立机身存储的容量大小。单位:GiB。

20

StreamMode

integer

云手机矩阵下实例的串流模式。

1

NetworkType

string

实例的网络类型。

network_pro_ecd

BandwidthPackageType

string

带宽类型。

cbwp_ecd

BandwidthPackageId

string

带宽包的 ID。

np-0q6ixs7vpxcizp***

UpBandwidthLimit

integer

上行带宽限速,单位 Mbps

5

DownBandwidthLimit

integer

下行带宽限速,单位 Mbps

30

ServerType

string

云手机矩阵规格。

cpm.gx7.10xlarge

BizTags

array<object>

标签数组

object

标签对象

Key

string

标签键。

releaseFlag

Value

string

标签值。

on

ServerStatus

string

矩阵状态。

枚举值:
  • FAILED :

    创建失败

  • RUNNING :

    可用

  • EXPIRED :

    过期

  • DELETING :

    删除中

  • NODE_READY :

    矩阵 ready,实例创建中

  • CHANGING :

    矩阵变配中

  • CEASED :

    欠费

  • UPDATING :

    变更镜像中

  • CREATING :

    创建中

  • DATA_EXPANDING :

    存储扩容中

RUNNING

SystemVersion

string

android 系统版本。

Android 11

InternetStatus

string

示例

正常返回示例

JSON格式

{
  "RequestId": "F07A1DA1-E1EB-5CCA-8EED-12F85D32****",
  "TotalCount": 10,
  "NextToken": "AAAAAV3MpHK1AP0pfERHZN5pu6kmma/xxE9WtwL/ADvZ****",
  "InstanceModel": [
    {
      "AndroidInstanceGroupId": "ag-ayyhomlal7po****",
      "AndroidInstanceGroupName": "AndroidInstanceGroupName",
      "AndroidInstanceId": "acp-8at8h6ejkadjh****",
      "AndroidInstanceName": "name",
      "AndroidInstanceStatus": "RUNNING",
      "NetworkInterfaceIp": "192.168.22.48",
      "AuthorizedUserId": "test",
      "BindUserId": "test",
      "PersistentAppInstanceId": "p-0btrd5zj8epo****",
      "AppInstanceId": "ai-9ey6io0q58rcd****",
      "KeyPairId": "kp-5hh431emkpucs****",
      "GmtCreate": "2023-05-06 10:42:10",
      "GmtModified": "2023-05-06 10:42:10",
      "AppInstanceGroupId": "aig-i7yv6tkn7kh8dv****",
      "RegionId": "cn-hangzhou",
      "Rate": 100,
      "ErrorCode": "FilePathNotFound",
      "RenderingType": "local",
      "InstanceType": "acp.basic.small",
      "ChargeType": "PrePaid",
      "GmtExpired": "2024-07-15T02:03:33Z",
      "PolicyGroupId": "pg-0bszojpu0seql****",
      "OfficeSiteId": "cn-shenzhen+dir-211620****",
      "VSwitchId": "vsw-2zepmau2hsbhos42****",
      "Memory": 1024,
      "Cpu": "4",
      "Disks": [
        {
          "DiskType": "SYSTEM",
          "DiskSize": 32
        }
      ],
      "Tags": [
        {
          "Key": "key",
          "Value": "value"
        }
      ],
      "ImageVersion": "3.5.3.867",
      "PublicIpAddress": "10.32.1.41",
      "SessionStatus": "connect",
      "NetworkInterfaceIpv6Address": "null",
      "PublicIpv6Address": "null",
      "ImageId": "imgc-075cllfeuazh0****",
      "DisplayConfig": {
        "ResolutionHeight": 1280,
        "ResolutionWidth": 720,
        "Dpi": 240,
        "Fps": 30,
        "LockResolution": "off"
      },
      "QosRuleId": "qos-5605u0gelk200****",
      "AppManagePolicy": {
        "AppManagePolicyId": "amp-dgiavcvibfdds****",
        "AppManagePolicyName": "应用组1"
      },
      "ZoneId": "cn-hangzhou-h",
      "PhoneDataInfo": {
        "PhoneDataId": "pd-sbcudgidbhb****",
        "PhoneDataVolume": 20
      },
      "StreamMode": 1,
      "NetworkType": "network_pro_ecd",
      "BandwidthPackageType": "cbwp_ecd",
      "BandwidthPackageId": "np-0q6ixs7vpxcizp***",
      "UpBandwidthLimit": 5,
      "DownBandwidthLimit": 30,
      "ServerType": "cpm.gx7.10xlarge",
      "BizTags": [
        {
          "Key": "releaseFlag",
          "Value": "on"
        }
      ],
      "ServerStatus": "RUNNING",
      "SystemVersion": "Android 11",
      "InternetStatus": ""
    }
  ]
}

错误码

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

变更历史

更多信息,参考变更详情