文档中心 API中心 生命周期管理 查询云服务器详情
在这篇文章中：

    查询云服务器详情

    功能介绍

    根据云服务器ID，查询云服务器的详细信息。

    URI

    GET /v2.1/servers/{server_id}

    参数说明

    参数 是否必选 描述
    server_id 是 云服务器ID。

    响应消息

    响应参数

    参数 参数类型 描述
    server Object 云服务器信息，详情请参见表1。

    表1 server字段数据结构说明

    参数 参数类型 描述
    name String 云服务器名称。
    id String 云服务器唯一标识。
    status String 云服务器当前状态信息。取值范围：ACTIVE、BUILD、DELETED、ERROR、HARD_REBOOT、MIGRATING、PAUSED、REBOOT、REBUILD、RESIZE、REVERT_RESIZE、SHUTOFF、SHELVED、SHELVED_OFFLOADED、SOFT_DELETED、SUSPENDED、VERIFY_RESIZE
    created String 云服务器创建时间。时间格式例如：2019-05-22T07:48:19Z
    updated String 云服务器上一次更新时间。时间格式例如：2019-05-22T07:48:19Z
    flavor Object 云服务器规格信息，详情请参见表2。
    image Object 云服务器镜像信息，对镜像创的云服务器该属性通常返回镜像id和链接。详情请参见表3。
    tenant_id String 云服务器所属租户ID。即项目id，和project_id表示的是一个概念。
    key_name String SSH密钥名称。
    user_id String 云服务器所属用户ID。
    metadata Object 云服务器元数据。
    hostId String 云服务器对应的主机ID。
    addresses Object 云服务器对应的网络地址信息。key为网络名称，如“demo_net”。value为网络详细信息。详情请参见表5。
    security_groups Array of objects 云服务器所属安全组列表，详情请参见表7。
    links Array of objects 云服务器相关标记快捷链接信息，详情请参见表4。
    OS-DCF:diskConfig String 扩展属性，磁盘配置方式。对镜像启动弹性云服务器生效。取值范围：AUTO: API使用单个分区构建目标磁盘大小的云服务器。 API会自动调整文件系统以适应整个分区。MANUAL:API使用源映像中的分区方案和文件系统构建服务器。如果目标磁盘较大，则API不分区剩余的磁盘空间。
    OS-EXT-AZ:availability_zone String 扩展属性，可用区编码。
    OS-EXT-SRV-ATTR:hypervisor_hostname String 扩展属性，hypervisor主机名。
    OS-EXT-SRV-ATTR:instance_name String 扩展属性，云服务器ID。
    OS-EXT-STS:power_state Integer 扩展属性，云服务器电源状态。取值范围：0 , 1 , 2 , 3 , 40 : pending1 : running2 : paused3 : shutdown4 : crashed
    OS-EXT-STS:task_state String 扩展属性，云服务器任务状态。
    OS-EXT-STS:vm_state String 扩展属性，云服务器状态。取值范围：ACTIVE,BUILDING,STOPPED,RESIZED,PAUSED,SUSPENDED,RESCUED,ERROR,DELETED,SOFT_DELETED,SHELVED,SHELVED_OFFLOADED
    OS-SRV-USG:launched_at String 扩展属性，云服务器启动时间。时间格式例如：2019-05-22T07:48:19.000000
    OS-SRV-USG:terminated_at String 扩展属性，云服务器删除时间。时间格式例如：2019-05-22T07:48:19.000000
    os-extended-volumes:volumes_attached Array of objects 云服务器挂载的云磁盘信息，详情请参见表6。
    accessIPv4 String 预留属性。
    accessIPv6 String 预留属性。
    config_drive String 预留属性。
    progress Integer 预留属性。

    表2 flavor字段数据结构说明

    参数 参数类型 描述
    id String 云服务器类型ID。
    links Array of objects 云服务器类型相关标记快捷链接信息。详情请参见表4。

    表3 image字段数据结构说明

    参数 参数类型 描述
    id String 镜像ID。
    links Array of objects 镜像相关标记快捷链接信息，详情请参见表4。

    表4 links字段数据结构说明

    参数 参数类型 描述
    rel String 快捷链接标记名称。
    href String 对应快捷链接。

    表5 云服务器所属网络信息的数据结构说明

    参数 参数类型 描述
    addr String IP地址信息。
    version Integer IP地址类型，值为4或6。4：IP地址类型是IPv46：IP地址类型是IPv6
    OS-EXT-IPS-MAC:mac_addr String 扩展属性，MAC地址。
    OS-EXT-IPS:type String 扩展属性，分配IP地址方式。

    表6 os-extended-volumes:volumes_attached字段数据结构说明

    参数 参数类型 描述
    id String 云磁盘ID。

    表7 security_groups字段数据结构说明

    参数 参数类型 描述
    name String 安全组名称或者uuid。

    请求示例

    1
    GET https://{endpoint}/v2.1/servers/{server_id}

    响应示例

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76
    77
    {
    	"server": {
    		"OS-EXT-STS:task_state": null,
    		"addresses": {
    			"net1": [{
    				"OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:51:64:0a",
    				"version": 4,
    				"addr": "192.168.1.6",
    				"OS-EXT-IPS:type": "fixed"
    			}, {
    				"OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:51:64:0a",
    				"version": 4,
    				"addr": "10.119.0.184",
    				"OS-EXT-IPS:type": "floating"
    			}]
    		},
    		"links": [{
    			"href": "https://home.jcloud.sjtu.edu.cn:8774/v2.1/servers/8c28f0e3-c797-4c91-8802-63aaf13e1049",
    			"rel": "self"
    		}, {
    			"href": "https://home.jcloud.sjtu.edu.cn:8774/servers/8c28f0e3-c797-4c91-8802-63aaf13e1049",
    			"rel": "bookmark"
    		}],
    		"image": {
    			"id": "021de961-0406-4cc8-8323-46d39b6d1f0f",
    			"links": [{
    				"href": "https://home.jcloud.sjtu.edu.cn:8774/images/021de961-0406-4cc8-8323-46d39b6d1f0f",
    				"rel": "bookmark"
    			}]
    		},
    		"OS-EXT-STS:vm_state": "active",
    		"OS-EXT-SRV-ATTR:instance_name": "instance-0005626e",
    		"OS-SRV-USG:launched_at": "2021-03-23T03:23:43.000000",
    		"flavor": {
    			"id": "7766f228-5a09-4713-9f59-b0644d032d59",
    			"links": [{
    				"href": "https://home.jcloud.sjtu.edu.cn:8774/flavors/7766f228-5a09-4713-9f59-b0644d032d59",
    				"rel": "bookmark"
    			}]
    		},
    		"id": "8c28f0e3-c797-4c91-8802-63aaf13e1049",
    		"security_groups": [{
    			"name": "default"
    		}],
    		"user_id": "a906f30458c54f618995de8be92f97b7",
    		"OS-DCF:diskConfig": "AUTO",
    		"accessIPv4": "",
    		"accessIPv6": "",
    		"progress": 0,
    		"OS-EXT-STS:power_state": 1,
    		"OS-EXT-AZ:availability_zone": "nova",
    		"config_drive": "True",
    		"status": "ACTIVE",
    		"updated": "2021-03-23T03:23:43Z",
    		"hostId": "573862645eb5a79f6aa691158a1b6796f1a4e0f616fb3d723b114152",
    		"OS-EXT-SRV-ATTR:host": "D7U12COM139",
    		"OS-SRV-USG:terminated_at": null,
    		"key_name": null,
    		"OS-EXT-SRV-ATTR:hypervisor_hostname": "D7U12COM139",
    		"name": "wscommandu6d4bu8bd5",
    		"created": "2021-03-23T03:23:28Z",
    		"tenant_id": "7a3856dc8df348c1ae22dd58d4197749",
    		"os-extended-volumes:volumes_attached": [{
    			"id": "3a1c1330-c708-4beb-8d4d-1b4036fdffde"
    		}],
    		"metadata": {
    			"image_os_distro": "windows",
    			"max_vcpus": "80",
    			"image_name": "win10_Ch-64.bit",
    			"volume_type": "bbfdc5ea-f9ca-41f7-96b3-e3c473d20903",
    			"image_id": "021de961-0406-4cc8-8323-46d39b6d1f0f",
    			"max_memory": "2097152",
    			"cinder_img_volume_type": "bbfdc5ea-f9ca-41f7-96b3-e3c473d20903",
    			"recoverable": "disabled"
    		}
    	}
    }

    返回值

    请参考通用请求返回值。