调试
您可以在API Explorer中调试该接口。
请求消息
无
响应消息
参数 |
参数类型 |
描述 |
---|---|---|
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 |
|
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 |
弹性云服务器故障原因,详情参见表4。 |
progress |
Integer |
弹性云服务器进度,范围为0到100。 |
OS-EXT-STS:power_state |
Integer |
扩展属性,弹性云服务器电源状态。 取值范围:
|
config_drive |
String |
config drive信息。 |
metadata |
Map<String,String> |
弹性云服务器元数据。详情请参见表6。 说明:
元数据包含系统默认添加字段和用户设置的字段。 |
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 |
挂载到弹性云服务器上的磁盘。 详情请参见表5。 |
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 |
弹性云服务器调度信息,详情请参见表13 。 |
ent erp rise_project_id |
String |
弹性云服务器所属的企业项目ID。 |
sys_tags |
Array of objects |
弹性云服务器系统标签。 详情请参见表7。 |
auto_terminate_time |
String |
云服务器自动释放时间。 说明:
包年/包月云服务器的自动释放时间为空。 |
cpu_options |
Object |
自定义CPU选项。 |
hypervisor |
Object |
扩展属性,虚拟化信息。 |
请求示例
查询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":"1", "ram":"1024", "id":"s3.small.1", "name":"s3.small.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", "cas cad ed.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" } ] } }
返回值
请参考通用请求返回值。
错误码
请参考错误码。