查询云服务器详情
功能介绍
查询弹性云服务器的详细信息。
该接口支持查询弹性云服务器的计费方式，以及是否被冻结。
URI
GET /v1/{project_id}/cloudservers/{server_id}
请求消息
无
响应消息
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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_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的类型。
|
|
accessIPv4 |
String |
预留属性。 |
|
accessIPv6 |
String |
预留属性。 |
|
fault |
Object |
弹性云服务器故障原因。
|
|
progress |
Integer |
弹性云服务器进度，范围为0到100。 |
|
OS-EXT-STS:power_state |
Integer |
扩展属性，弹性云服务器电源状态。 取值范围：
|
|
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 |
云服务器所在主机状态。
|
|
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 |
弹性云服务器是否为锁定状态。
|
|
tags |
Array of strings |
弹性云服务器标签列表。 |
|
os:scheduler_hints |
Object |
弹性云服务器调度信息，详情请参见表11 。 |
|
sys_tags |
Array of objects |
弹性云服务器系统标签。 详情请参见表6。 |
请求示例
查询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":"",
"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"
}
]
}
}
返回值
请参考通用请求返回值。
错误码
请参考错误码。
