更新时间:2024-08-09 GMT+08:00

查询云手机服务器详情

功能介绍

根据server_id查询云手机服务器的详细信息。

URI

GET /v1/{project_id}/cloud-phone/servers/{server_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目id。

server_id

String

云手机服务器的唯一标识。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

request_id

String

请求的唯一标识ID。

server_name

String

云手机服务器名称, 不超过65字符,只支持英文字母、数字、汉字、下划线和中划线。

availability_zone

String

云手机服务器所在的可用区。

server_id

String

云手机服务器的唯一标识,不超过32个字节。

server_model_name

String

云手机服务器规格名称,不超过64个字节。

phone_model_name

String

云手机规格名称,不超过64个字节。

keypair_name

String

连接云手机所使用的密钥对的名称,不超过64个字节。

status

Integer

服务器状态。

  • 0、1、3、4:创建中

  • 2:异常

  • 5:正常

  • 8:冻结

  • 10:关机

  • 11:关机中

  • 12:关机失败

  • 13:开机中

vpc_id

String

云手机服务器所属虚拟私有云(简称VPC)的ID。网络版本 network_version 取值为“v1”时,表示云手机服务器所属资源租户的VPC ID;取值为“v2”时,表示租户创建服务器时指定 VPC 的 VPC ID。

cidr

String

云手机服务器所属虚拟私有云(简称VPC)的网段。网络版本 network_version 取值为“v1”时,表示云手机服务器所属资源租户的VPC CIDR;取值为“v2”时,表示租户创建服务器时指定 VPC 的 VPC CIDR。

vpc_cidr

String

云手机服务器所属虚拟私有云(简称VPC)的网段。网络版本 network_version 取值为“v1”时,表示云手机服务器所属资源租户的VPC CIDR;取值为“v2”时,表示租户创建服务器时指定 VPC 的 VPC CIDR。

subnet_id

String

云手机服务器所属子网的ID。仅在网络版本 network_version 取值为“v2”时,该取值表示租户创建服务器时指定子网的 ID;网络版本取值为“v1”时,该字段表示云手机服务器所属资源租户的子网ID。

subnet_cidr

String

云手机服务器所属子网的网段。网络版本 network_version取值为“v2”时,表示租户创建服务器时指定子网的 CIDR;取值为“v1”时,表示云手机服务器所属资源租户的子网CIDR。

resource_project_id

String

云手机服务器的项目ID。

metadata

metadata object

订单以及产品相关信息。

addresses

Array of Address objects

云手机服务器的IP相关信息。

band_widths

Array of Bandwidth objects

云手机服务器带宽信息的结构体数组。

volumes

Array of Volume objects

云手机服务器卷信息的结构体数组。

share_volume_info

share_volume_info object

云手机服务器的共享存储相关信息。

network_version

String

是否为自定义网络的云手机服务器标识。"v1",非自定义网络的云手机服务器。"v2",自定义网络的云手机服务器。支持按照网络版本字段进行筛选。

enterprise_project_id

String

云手机服务器所属企业项目ID。

security_groups

Array of strings

服务器扩展网卡绑定的安全组信息。 系统定义网络的服务器,该字段返回为空列表。

create_time

String

创建时间, 时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。

update_time

String

更新时间, 时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。

表4 metadata

参数

参数类型

描述

charging_mode

Integer

计费类型。

  • 0:包周期

product_id

String

产品ID,不超过64个字节。

order_id

String

订单ID,不超过64个字节。

表5 Address

参数

参数类型

描述

intranet_ip

String

云手机服务器的内网IP,过期字段。

access_ip

String

云手机服务器的公网IP,过期字段。

server_ip

String

云手机服务器的内网IP,新增字段。

public_ip

String

云手机服务器的公网IP,新增字段。

表6 Bandwidth

参数

参数类型

描述

band_width_name

String

云手机服务器的带宽名称。

band_width_id

String

云手机服务器的带宽唯一标识。

band_width_size

Integer

云手机服务器的带宽大小。

band_width_charge_mode

Integer

云手机服务器带宽的计费方式。

  • 0:bandwidth, 按带宽计费

  • 1:traffic, 按流量计费

band_width_share_type

Integer

云手机服务器的带宽类型。

  • 0:per,独享带宽

  • 1:whole,共享带宽

create_time

String

带宽创建时间,

时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。

update_time

String

带宽更新时间,

时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。

表7 Volume

参数

参数类型

描述

volume_name

String

云手机服务器的硬盘名称。

volume_id

String

云手机服务器的硬盘唯一标识。

volume_size

Integer

云手机服务器的硬盘大小,单位G。

volume_type

String

云手机服务器的硬盘类型。

create_time

String

硬盘创建时间,

时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。

update_time

String

硬盘更新时间,

时间格式为UTC,YYYY-MM-DDTHH:MM:SSZ。

表8 share_volume_info

参数

参数类型

描述

volume_type

String

共享存储磁盘类型。

size

Integer

共享存储大小,单位G。

version

Integer

共享存储版本:

  • 0:共享存储1.0

  • 1:共享存储2.0

请求示例

查询服务器详情

GET https://{CPH Endpoint}/v1/{project_id}/cloud-phone/servers/88b8449b896f3a4f0ad57222dd91909

响应示例

状态码: 200

OK

{
  "server_name" : "cph-418540-1620-40-old-1",
  "availability_zone" : "br-iaas-odin1a",
  "addresses" : [ {
    "public_ip" : "10.246.xxx.xxx",
    "server_ip" : "172.31.22.245",
    "intranet_ip" : "172.31.22.245",
    "access_ip" : "10.246.xxx.xxx"
  } ],
  "metadata" : {
    "product_id" : "OFFI451249149551403012",
    "order_id" : "CS2007271727F9XJE"
  },
  "create_time" : "2020-01-01T00:00:00Z",
  "vpc_id" : "12021c68-730f-41fa-9884-11c616f4c9ad",
  "phone_model_name" : "kg1.cg.c40.d30SSD.e1v1.old",
  "subnet_cidr" : "172.31.0.0/16",
  "keypair_name" : "KeyPair-1230",
  "resource_project_id" : "06a5b529fa80d28b2f53c014024bed44",
  "server_id" : "6edb89150bc742aa81fc8ac4ff047297",
  "server_model_name" : "physical.kg1.4xlarge.cg",
  "update_time" : "2020-01-01T00:00:00Z",
  "cidr" : "172.31.0.0/16",
  "vpc_cidr" : "172.31.0.0/16",
  "subnet_id" : "5784d2fe-fefd-42f0-a7f1-e88454d8bc0f",
  "request_id" : "91d5bf46a817466daa25fc5824ab9717",
  "status" : 5,
  "network_version" : "v1",
  "security_groups" : [ ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码