DescribeAndroidInstances - 查询实例详细信息_无影云手机(Cloud Phone)-阿里云帮助中心

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

调试

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

返回参数

名称	类型	描述	示例值
	object	返回信息。
RequestId	string	请求 ID。	F07A1DA1-E1EB-5CCA-8EED-12F85D32****
TotalCount	integer	总条目数。	10
NextToken	string	用来表示当前调用返回读取到的位置。空代表数据已经读取完毕。	AAAAAV3MpHK1AP0pfERHZN5pu6kmma/xxE9WtwL/ADvZ****
InstanceModel	array<object>	实例信息。
data	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****
Memory	integer	内存大小。	1024
Cpu	string	CPU 核数。	4
Disks	array<object>	磁盘信息。
disks	object	磁盘信息。
DiskType	string	磁盘类型。	SYSTEM
DiskSize	integer	磁盘大小。单位：GB。	32
Tags	array<object>	标签列表。
Tag	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

示例

正常返回示例

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****",
      "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": ""
    }
  ]
}

错误码

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

变更历史

变更时间	变更内容概要	操作
2024-09-26	OpenAPI 入参发生变更、OpenAPI 返回结构发生变更	查看变更详情
2024-08-19	OpenAPI 入参发生变更	查看变更详情
2024-07-24	OpenAPI 返回结构发生变更	查看变更详情
2024-06-26	API 内部配置变更，不影响调用	查看变更详情