功能介绍
查询弹性云服务器的详细信息。

该接口支持查询弹性云服务器的计费方式,以及是否被冻结。
调试
您可以在API Explorer中调试该接口。
URI
GET /v1/{project_id}/cloudservers/{server_id}
参数说明请参见表1。
表1 参数说明
参数
是否必选
描述
project_id
是
项目ID。
获取方法请参见获取项目ID。
server_id
是
云服务器ID。
请求消息
无
响应消息
响应参数如表2所示。
表2 响应参数
参数
参数类型
描述
server
Object
云服务器信息,详情请参见表3。
表3 server字段数据结构说明
参数
参数类型
描述
status
String
弹性云服务器状态。
取值范围:
ACTIVE、BUILD、ERROR、HARD_REBOOT、MIGRATING、REBOOT、REBUILD、RESIZE、REVERT_RESIZE、SHUTOFF、VERIFY_RESIZE、DELETED、SHELVED、SHELVED_OFFLOADED 、UNKNOWN
弹性云服务器状态说明请参考云服务器状态。
updated
String
弹性云服务器最近一次更新时间,例如开机、关机、重启等操作。
时间格式例如:2019-05-22T03:30:52Z
hostId
String
弹性云服务器所在主机的主机ID。
OS-EXT-SRV-ATTR:host
String
弹性云服务器所在主机的主机名称。
addresses
Object
弹性云服务器的网络属性。
属性为Map<String, Object>结构。
key为网络名称,如“demo_net”。
value为网络属性,详情请参见表1。
key_name
String
弹性云服务器使用的密钥对名称。
image
Object
弹性云服务器镜像信息。详情请参见:表7
OS-EXT-STS:task_state
String
扩展属性,弹性云服务器当前任务的状态,请参考云服务器状态。
OS-EXT-STS:vm_state
String
扩展属性,弹性云服务器当前状态,请参考云服务器状态。
OS-EXT-SRV-ATTR:instance_name
String
扩展属性,弹性云服务器别名。
OS-EXT-SRV-ATTR:hypervisor_hostname
String
扩展属性,弹性云服务器所在虚拟化主机名。
flavor
Object
弹性云服务器规格信息。
详情请参见表2。
id
String
弹性云服务器ID,格式为UUID。
security_groups
Array of objects
弹性云服务器所属安全组列表。
详情请参见表3。
OS-EXT-AZ:availability_zone
String
扩展属性,弹性云服务器所在可用区名称。
user_id
String
创建弹性云服务器的用户ID,格式为UUID。
name
String
弹性云服务器名称。
created
String
弹性云服务器创建时间。
时间格式例如:2019-05-22T03:19:19Z
tenant_id
String
弹性云服务器所属租户ID,即项目id,和project_id表示相同的概念,格式为UUID。
OS-DCF:diskConfig
String
扩展属性, diskConfig的类型。
MANUAL,镜像空间不会扩展。
AUTO,系统盘镜像空间会自动扩展为与flavor大小一致。
accessIPv4
String
预留属性。
accessIPv6
String
预留属性。
fault
Object
弹性云服务器故障原因。
当弹性云服务器状态正常时,返回NULL。
当弹性云服务器状态异常时,返回故障描述信息或故障详情:
message:故障信息
code:故障代码
details:故障详情
created:故障时间,ISO8601格式
progress
Integer
弹性云服务器进度,范围为0到100。
OS-EXT-STS:power_state
Integer
扩展属性,弹性云服务器电源状态。
取值范围:
0:NOSTATE
1:RUNNING
4:SHUTDOWN
config_drive
String
config drive信息。
metadata
Map<String,String>
弹性云服务器元数据。详情请参见表5。
说明:
元数据包含系统默认添加字段和用户设置的字段。
OS-SRV-USG:launched_at
String
弹性云服务器启动时间。时间格式例如:2019-05-22T03:23:59.000000
OS-SRV-USG:terminated_at
String
弹性云服务器删除时间。
时间格式例如:2019-05-22T03:23:59.000000
os-extended-volumes:volumes_attached
Array of objects
挂载到弹性云服务器上的磁盘。
详情请参见表4。
description
String
弹性云服务器的描述信息。
host_status
String
云服务器所在主机状态。
UP:服务正常
UNKNOWN:状态未知
DOWN:服务异常
MAINTENANCE:维护状态
空字符串:弹性云服务器无主机信息
OS-EXT-SRV-ATTR:hostname
String
弹性云服务器的主机名。
OS-EXT-SRV-ATTR:reservation_id
String
批量创建场景,弹性云服务器的预留ID,可以根据该id查询出批创的所有虚拟机。
OS-EXT-SRV-ATTR:launch_index
Integer
批量创建场景,批创的所有弹性云服务器的启动顺序,范围为0到批量数量。
OS-EXT-SRV-ATTR:kernel_id
String
若使用AMI格式的镜像,则表示kernel image的UUID;否则,留空。
OS-EXT-SRV-ATTR:ramdisk_id
String
若使用AMI格式镜像,则表示ramdisk image的UUID;否则,留空。
OS-EXT-SRV-ATTR:root_device_name
String
弹性云服务器系统盘的设备名称,例如当系统盘的磁盘模式是VDB,为/dev/vda,磁盘模式是SCSI,为/dev/sda。
OS-EXT-SRV-ATTR:user_data
String
创建弹性云服务器时指定的user_data(编码过后的信息)。
locked
Boolean
弹性云服务器是否为锁定状态。
true:锁定
false:未锁定
tags
Array of strings
弹性云服务器标签列表。
os:scheduler_hints
Object
弹性云服务器调度信息,详情请参见表13 。
enterprise_project_id
String
弹性云服务器所属的企业项目ID。
sys_tags
Array of objects
弹性云服务器系统标签。
详情请参见表6。
auto_terminate_time
String
云服务器定时删除时间。
说明:
包年/包月云服务器的定时删除时间为空。
cpu_options
Object
自定义CPU选项。
详情请参见表4。
hypervisor
Object
扩展属性,虚拟化信息。
详情请参见 表5。
表4 cpu_options数据结构说明
参数
参数类型
描述
hw:cpu_threads
Integer
用于控制CPU是否开启超线程。
取值范围:1,2。
1: 关闭超线程。
2: 打开超线程。
需要同时满足如下条件,才能设置为“关闭超线程”:
只能在实例创建或者resize时指定。
只有目标flavor的extra_specs参数:
存在“hw:cpu_policy”并取值为“dedicated”。
存在“hw:cpu_threads”并取值为“2”。
表5 hypervisor数据结构说明
参数
参数类型
描述
hypervisor_type
String
虚拟化类型。
csd_hypervisor
String
预留属性。
请求示例
查询ID为“4f4b3dfa-eb70-47cf-a60a-998a53bd598a”的云服务器详情。
GET https://{endpoint}/v1/{project_id}/cloudservers/{server_id}
响应示例
{
"server":{
"id":"4f4b3dfa-eb70-47cf-a60a-998a53bd598a",
"name":"ecs-2ecf",
"addresses":{
"0431c5e5-bc94-4a44-8263-15da2a642435":[
{
"version":"4",
"addr":"192.168.1.99",
"OS-EXT-IPS-MAC:mac_addr":"fa:16:3e:df:18:6d",
"OS-EXT-IPS:port_id":"23037c18-027a-44e5-b6b9-f8d8f113fe02",
"OS-EXT-IPS:type":"fixed"
}
]
},
"flavor":{
"disk":"0",
"vcpus":"2",
"ram":"1024",
"id":"s3.large.1",
"name":"s3.large.1"
},
"accessIPv4":"",
"accessIPv6":"",
"status":"ACTIVE",
"progress":0,
"hostId":"c7145889b2e3202cd295ceddb1742ff8941b827b586861fd0acedf64",
"updated":"2018-09-13T07:06:51Z",
"created":"2018-09-13T07:03:44Z",
"image":{
"id":"1ce5800a-e487-4c1b-b264-3353a39e2b4b"
},
"metadata":{
"metering.order_id":"CS1809131459IGC24",
"metering.image_id":"c71b64e7-4767-4406-afde-2c7c7ac2242c",
"metering.imagetype":"gold",
"metering.resourcespeccode":"s3.small.1.linux",
"image_name":"HEC_Public_Cloudinit_Oracle_Linux_7.4_64bit_40G",
"metering.resourcetype":"1",
"metering.product_id":"00301-117024-0--0",
"cascaded.instance_extrainfo":"pcibridge:2",
"os_bit":"64",
"vpc_id":"0431c5e5-bc94-4a44-8263-15da2a642435",
"os_type":"Linux",
"charging_mode":"1"
},
"tags":[
],
"description":"",
"locked":false,
"config_drive":"",
"tenant_id":"ff2eb406effc455aba53174463eb9322",
"user_id":"0bc5e11f91dd48849bb03b7c8a263b2c",
"key_name":"KeyPair-d750",
"os-extended-volumes:volumes_attached":[
{
"device":"/dev/vda",
"bootIndex":"0",
"id":"80c15cff-2473-4982-a816-d760cad6c42c",
"delete_on_termination":"false"
}
],
"OS-EXT-STS:task_state":null,
"OS-EXT-STS:power_state":1,
"OS-EXT-STS:vm_state":"active",
"OS-EXT-SRV-ATTR:host":"az21.dc1",
"OS-EXT-SRV-ATTR:instance_name":"instance-0015147f",
"OS-EXT-SRV-ATTR:hypervisor_hostname":"nova003@74",
"OS-EXT-SRV-ATTR:user_data":null,
"OS-DCF:diskConfig":"MANUAL",
"OS-EXT-AZ:availability_zone":"az1-dc1",
"os:scheduler_hints":{
},
"OS-EXT-SRV-ATTR:root_device_name":"/dev/vda",
"OS-EXT-SRV-ATTR:ramdisk_id":"",
"enterprise_project_id":"0",
"OS-SRV-USG:launched_at":"2018-09-13T07:04:09.197749",
"OS-EXT-SRV-ATTR:kernel_id":"",
"OS-EXT-SRV-ATTR:launch_index":0,
"host_status":"UP",
"OS-EXT-SRV-ATTR:reservation_id":"r-nrd8b5c4",
"OS-EXT-SRV-ATTR:hostname":"ecs-2ecf",
"sys_tags":[
{
"key":"_sys_enterprise_project_id",
"value":"0"
}
],
"security_groups":[
{
"name":"sg-95ec",
"id":"6505b5d1-7837-41eb-8a1c-869d4355baa3"
}
]
}
}
返回值
请参考通用请求返回值。
错误码
请参考错误码。
华为云共建智能世界云底座[52] 华为公有云专属云主机DeH服务[51] 华为云场景化解决方案[49] 华为公有云产品[44] 华为云云主机[43] 华为云产品服务[43] 华为云服务器应用[43] 华为弹性云服务器[39] 华为公有云架构解决方案[38] 华为云提供的服务[37] 华为虚拟私有云vpc[37] 华为公有云介绍[32] 华为公有云提供哪些计算服务[30] 华为云漏洞扫描[27] 华为云软件开发服务[27] 华为公有云和私有云区别[27] 华为云域名注册[26] 华为云官网登陆[26] 华为公有云解决方案[26] 华为私有云产品有哪些[26] 华为私有云服务[25] 华为云数据库[23] 华为云安全[22] 华为公有云官网[22] 华为私有云的搭建方案[22] 华为云弹性云服务器应用[21] 华为公有云平台[20] 华为公有云行业解决方案[20] 华为私有云解决方案服务定制领导者[20] [19] 华为私有云服务器[19] 华为私有云网格结构[19] 华为公有云视讯解决方案[18] 华为云官网[17] 华为云速建站[17] 华为私有云架构[17] 华为云优势[16] 华为云服务器[16] 华为私有云部署架构[16] 华为云企业邮箱服务 (SAAS[15] 华为云邮箱[15] 华为公有云是什么[15] 华为公有云架构[15] 华为云迁移解决方案[14] 华为公有云解决方案服务定制领导者[14] 华为私有云解决方案[14] 云邮箱)[13] 华为云园区解决方案[13] 华为云服务总代理[13] 华为云速智能客服[13] 华为公有云服务[13] 华为私有云搭建方案[13] 云与计算咨询服务[12] 云与计算培训服务[11] 华为云备份[11] 华为云服务器配置[11] 华为云服务服务中心[11] 华为云服务核心分销商[11] 华为公有云[11] 华为私有云搭建[11] 云迁移与运营支撑服务[10] 公有云私有云混合云[10] 华为云服务器ECS[10] 华为云服务器成功案例[10] 华为云解决方案[10] 华为公有云通用解决方案[9] 华为智慧云课堂解决方案[9] 华为云数据解决方案[8] 华为云是什么[8] 华为私有云平台[8] 云与计算客户支持与运维使能服务[7] 华为云官网网站[7] 华为云智慧教育解决方案[7] 华为云智慧校园解决方案[7] 华为云桌面系统集成商[7] 华为云经销商[7] 华为代理公司有哪些[7] 华为私有云方案[7] 智慧教育云平台解决方案[7] 华为云服务器试用[6] 华为云网站建设服务器[6] 华为手机代理加盟[6] 华为私有云[6] 大数据使能服务[6] 智慧教育云计算解决方案[6] 华为云云主机 [5] 华为云智慧***解决方案[5] 华为云桌面总代理商[5] 云与计算客户支持服务[4] 华为云产品介绍[4] 华为云智慧制造解决方案[4] 华为云场景化解决方案[3] 华为公有云官网[3] 华为公有云通用解决方案[3] 华为弹性云服务器[3] 华为公有云产品 [3] 华为云产品服务[2] 华为云域名注册[2] 华为云数据库[2] 华为云智慧校园解决方案[2] 华为云服务器应用[2] 华为云服务器成功案例[2] 华为云软件开发服务[2] 华为公有云产品[2] 华为公有云介绍[2] 华为公有云和私有云区别[2] 华为公有云服务[2] 华为公有云架构[2] 华为公有云架构解决方案[2] 华为公有云视讯解决方案[2] 华为公有云解决方案[2] 华为私有云产品有哪些[2] 华为私有云服务[2] 华为私有云架构[2] 智慧教育云计算解决方案[2] 云规划设计与实施服务[2] 云邮箱[2] 华为云产品报价[2] 华为公有云通用解决方案 [2] 华为云服务器成功案例[1] 华为云桌面系统集成商[1] 云与计算客户支持与运维使能服务[1] 云迁移与运营支撑服务[1] 云迁移与运营支撑服务 [1] 华为云共建智能世界云底座[1] 华为云备份[1] 华为云安全[1] 华为云官网登陆[1] 华为云弹性云服务器应用[1] 华为云提供的服务[1] 华为云数据解决方案[1] 华为云智慧制造解决方案[1] 华为云服务器[1] 华为云服务核心分销商 [1] 华为云漏洞扫描[1] 华为云迁移解决方案 [1] 华为云速智能客服[1] 华为云邮箱[1] 华为公有云专属云主机DeH服务[1] 华为公有云是什么[1] 华为公有云行业解决方案[1] 华为私有云搭建[1] 华为私有云方案[1] 华为私有云服务.华为公有云专属云主机DeH服务.华为云产品报价[1] 华为私有云的搭建方案[1] 华为私有云网格结构[1] 华为私有云解决方案[1] 华为私有云部署架构[1] 为云产品服务[1] 云与计算咨询服务 [1] 云与计算客户支持与运维使能服务 [1] 云与计算客户支持与运维使能服务 云与计算客户支持服务[1] 华为云是什么 [1] 华为云软件开发服[1] 华为云速智能客服 [1] 华为代理加盟[1] 华为公有云架构解决方案 [1] 华为公有云解决方案服务定制领导者 [1] 华为弹性云[1] 华为弹性云服务器 华为云域名注册 华为云服务器应用[1] 华为私有云搭建 [1] 华为私有云搭建方案 [1] 华为私有云部署架构 [1] 大数据使能服务 [1] 撒[1]