错误码
4.1.4 查询云服务器详情
"id": "616fb98f-46ca-475e-917e-2563e5a8cd19"
} ],
"delete_publicip": false, "delete_volume": false }
响应示例
{ "job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}
或
{ "error": {
"message": "request body is illegal.", "code": "Ecs.0005"
} }
返回值
请参考通用请求返回值。
错误码
请参考错误码。
4.1.4 查询云服务器详情
功能介绍
查询弹性云服务器的详细信息。
该接口支持查询弹性云服务器的计费方式，以及是否被冻结。
调试
您可以在API Explorer中调试该接口。
URI
GET /v1/{project_id}/cloudservers/{server_id}
参数说明请参见表4-16。
表4-16 参数说明
参数 是否必选 描述
project_id 是 项目ID。
获取方法请参见获取项目ID。
参数 是否必选 描述
server_id 是 云服务器ID。
请求消息
无
响应消息
响应参数如表4-17所示。
表4-17 响应参数
参数 参数类型 描述
server Object 云服务器信息，详情请参见表4-18。
表4-18 server 字段数据结构说明
参数 参数类型 描述
status String 弹性云服务器状态。
取值范围：
ACTIVE、BUILD、ERROR、
HARD_REBOOT、MIGRATING、REBOOT、
REBUILD、RESIZE、REVERT_RESIZE、
SHUTOFF、VERIFY_RESIZE、DELETED 弹性云服务器状态说明请参考云服务器状 态。
updated String 弹性云服务器更新时间。
时间格式例如：2019-05-22T03:30:52Z hostId String 弹性云服务器所在主机的主机ID。
OS-EXT-SRV-ATTR:host String 弹性云服务器所在主机的主机名称。
addresses Object 弹性云服务器的网络属性。
详情请参见表7-15。
key_name String 弹性云服务器使用的密钥对名称。
image Object 弹性云服务器镜像信息。详情请参见：表 7-22
OS-EXT-STS:task_state String 扩展属性，弹性云服务器当前任务的状态，
请参考云服务器状态。
参数 参数类型 描述
OS-EXT-STS:vm_state String 扩展属性，弹性云服务器当前状态，请参考 云服务器状态。
OS-EXT-SRV-ATTR:instance_name String 扩展属性，弹性云服务器别名。
OS-EXT-SRV-ATTR:hypervisor_hos tname
String 扩展属性，弹性云服务器所在虚拟化主机 名。
flavor Object 弹性云服务器规格信息。
详情请参见表7-16。
id String 弹性云服务器ID，格式为UUID。
security_groups Array of
objects 弹性云服务器所属安全组列表。
详情请参见表7-17。
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 弹性云服务器故障原因，详情参见表7-18。
progress Integer 弹性云服务器进度，范围为0到100。
OS-EXT-STS:power_state Integer 扩展属性，弹性云服务器电源状态。
取值范围：
● 0：NOSTATE
● 1：RUNNING
● 4：SHUTDOWN config_drive String config drive信息。
参数 参数类型 描述
OS-SRV-USG:launched_at String 弹性云服务器启动时间。时间格式例如：
2019-05-22T03:23:59.000000
OS-SRV-USG:terminated_at String 弹性云服务器删除时间。
时间格式例如：
description String 弹性云服务器的描述信息。
host_status String 云服务器所在主机状态。
● UP：服务正常
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_na me
String 弹性云服务器系统盘的设备名称，例如 /dev/
vda。
OS-EXT-SRV-ATTR:user_data String 创建弹性云服务器时指定的user_data（编码 过后的信息）。
locked Boolean 弹性云服务器是否为锁定状态。
● true：锁定
● false：未锁定 tags Array of
strings 弹性云服务器标签列表。
参数 参数类型 描述
os:scheduler_hints Object 弹性云服务器调度信息，详情请参见表 7-13 。
enterprise_project_id String 弹性云服务器所属的企业项目ID。
sys_tags Array of
objects 弹性云服务器系统标签。
详情请参见表7-21。
auto_terminate_time String 云服务器自动释放时间。
说明
包周期云服务器的自动释放时间为空。
cpu_options Object 自定义CPU选项。
详情请参见表4-19。
hypervisor Object 扩展属性，虚拟化信息。
详情请参见 表4-20。
表4-19 cpu_options 数据结构说明
参数 参数类
型
描述
hw:cpu_threads Integer CPU超线程数， 决定CPU是否开启超线程。
取值范围：1，2。
● 1: 关闭超线程。
● 2: 打开超线程。
取值为flavor的extra_specs中
“hw:cpu_threads”的值， 并且目标flavor的 extra_specs中存在“hw:cpu_policy”并取值为
“dedicated“，同时需要存在
“hw:cpu_threads"并取值为”2“。
表4-20 hypervisor 数据结构说明
参数 参数类
型
描述
hypervisor_type String 虚拟化类型。
csd_hypervisor String 预留属性。
请求示例
GET https://{endpoint}/v1/{project_id}/cloudservers/{server_id}
响应示例
{ "server": {
"id": "4f4b3dfa-eb70-47cf-a60a-998a53bd598a", "name": "ecs-2ecf",
"OS-EXT-IPS:port_id": "23037c18-027a-44e5-b6b9-f8d8f113fe02", "OS-EXT-IPS:type": "fixed"
"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",
"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"
}]
} }
返回值
请参考通用请求返回值。
错误码
请参考错误码。