# 查询云手机服务器详情 - ShowCloudPhoneServerDetail #### 功能介绍 根据server_id查询云手机服务器的详细信息。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/CPH/doc?api=ShowCloudPhoneServerDetail)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cph/cph_api_06000.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | cph:servers:get | Read | server \* | - g:EnterpriseProjectId - g:ResourceTag/\ | - | - eip:publicIps:list - eip:bandwidths:get - vpc:ports:get | #### 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 | 云手机服务器所在的可用区。如上海一可用区1为cn-east-3a。 | | 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。用于对使用系统定义网络的服务器创建对等连接，并非租户的项目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。 | 表4metadata | 参数 | 参数类型 | 描述 | |:---|:---|:---| | charging_mode | Integer | 计费类型。 - 0：包周期 | | product_id | String | 产品ID，不超过64个字节。 | | order_id | String | 订单ID，不超过64个字节。 | 表5Address | 参数 | 参数类型 | 描述 | |:---|:---|:---| | intranet_ip | String | 云手机服务器的内网IP，过期字段。 | | access_ip | String | 云手机服务器的公网IP，过期字段。 | | server_ip | String | 云手机服务器的内网IP，新增字段。 | | public_ip | String | 云手机服务器的公网IP，新增字段。 | 表6Bandwidth | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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。 | 表7Volume | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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。 | 表8share_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" : "xxxxxx", "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 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-cph/ErrorCode.html)。