文档首页/ 弹性云服务器 ECS/ API参考/ API/ 生命周期管理/ 查询云服务器详情

更新时间：2024-10-09 GMT+08:00

查看PDF

查询云服务器详情

功能介绍

查询弹性云服务器的详细信息。

该接口支持查询弹性云服务器的计费方式，以及是否被冻结。

调试

您可以在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	Map<String, Array of objects>	弹性云服务器的网络属性。 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",
            "gpus": [],
            "asic_accelerators": [] 
        },
        "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"
            }
        ]
    }
}

返回值

请参考通用请求返回值。

错误码

请参考错误码。

父主题： 生命周期管理

上一篇：删除云服务器

下一篇：查询云服务器详情列表

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

查询云服务器详情

功能介绍

调试

URI

请求消息

响应消息

请求示例

响应示例

返回值

错误码

相关文档

意见反馈

文档内容是否对您有帮助？

7*24

备案

专业服务

退订

建议反馈

售前咨询热线