# 查询云服务器详情（废弃） - NovaShowServer #### 功能介绍 根据云服务器ID，查询云服务器的详细信息。 当前API已废弃，请使用[查询云服务器详情 - ShowServer](https://support.huaweicloud.com/api-ecs/ecs_02_0104.html)。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=ECS&api=NovaShowServer)中调试该接口。 #### URI GET /v2.1/{project_id}/servers/{server_id} 参数说明请参见[表1]。 表1参数说明 | 参数 | 是否必选 | 描述 | |:---|:---|:---| | project_id | 是 | 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ecs/ecs_01_0016.html)。 | | server_id | 是 | 云服务器ID。 | #### 请求消息 无 #### 响应消息 响应参数如[表2]所示。 表2响应参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | server | Object | 云服务器信息，详情请参见[表3]。 | 表3server字段数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 云服务器名称。 | | id | String | 云服务器唯一标识。 | | status | String | 云服务器当前状态信息。 取值范围： ACTIVE、BUILD、ERROR、HARD_REBOOT、MIGRATING、REBOOT、REBUILD、RESIZE、REVERT_RESIZE、SHUTOFF、VERIFY_RESIZE、DELETED、SHELVED、SHELVED_OFFLOADED 、UNKNOWN 云服务器状态说明请参考[云服务器状态](https://support.huaweicloud.com/api-ecs/ecs_08_0002.html)。 | | created | String | 云服务器创建时间。时间格式例如：2019-05-22T07:48:19Z | | updated | String | 云服务器最近一次更新时间，例如开机、关机、重启等操作。时间格式例如：2019-05-22T07:48:19Z | | flavor | Object | 云服务器规格信息，详情请参见[表4]。 | | image | Object | 云服务器镜像信息，对镜像创的弹性云服务器该属性通常返回镜像id和链接。 详情请参见[表5]。 | | tenant_id | String | 云服务器所属租户ID。即项目id，和project_id表示的是一个概念。 | | key_name | String | SSH密钥名称。 | | user_id | String | 云服务器所属用户ID。 | | metadata | Object | 云服务器元数据。 | | hostId | String | 云服务器对应的主机ID。 该返回值并不是云服务器所在主机的实际ID。 | | addresses | Object | 云服务器对应的网络地址信息。 属性为Map\结构。 - key为网络名称，如"demo_net"。 - value为网络属性，详情请参见[表7]。 | | security_groups | Array of objects | 云服务器所属安全组列表，详情请参见[表9]。 | | links | Array of objects | 云服务器相关标记快捷链接信息，详情请参见[表6]。 | | tags | Array of strings | 云服务器的标签列表。 微版本2.26及以上版本支持，如果不使用微版本查询，响应中无tags字段。 系统近期对标签功能进行了升级，升级后，返回的tag值遵循如下规则： - key与value使用"="连接，如"key=value"。 - 如果value为空字符串，则仅返回key。 | | os:scheduler_hints | Object | 弹性云服务器调度信息，参见[表11]。裸金属服务器场景不支持。仅在DEH专属主机的场景下存在该字段。 | | OS-DCF:diskConfig | String | 扩展属性，磁盘配置方式。对镜像启动弹性云服务器生效。 取值范围： AUTO: API使用单个分区构建目标磁盘大小的弹性云服务器。 API会自动调整文件系统以适应整个分区。 MANUAL:API使用源映像中的分区方案和文件系统构建服务器。如果目标磁盘较大，则API不分区剩余的磁盘空间。 | | OS-EXT-AZ:availability_zone | String | 扩展属性，可用区编码。 | | OS-EXT-SRV-ATTR:host | 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 , 4 - 0 : pending - 1 : running - 2 : paused - 3 : shutdown - 4 : crashed | | OS-EXT-STS:task_state | String | 扩展属性，云服务器任务状态。 取值范围请参考[云服务器状态](https://support.huaweicloud.com/api-ecs/ecs_08_0002.html)表3。 | | OS-EXT-STS:vm_state | String | 扩展属性，云服务器状态。 取值范围： ACTIVE,BUILDING,STOPPED,RESIZED,PAUSED,SUSPENDED,RESCUED,ERROR,DELETED,SOFT_DELETED,SHELVED,SHELVED_OFFLOADED 云服务器状态说明请参考[云服务器状态](https://support.huaweicloud.com/api-ecs/ecs_08_0002.html)。 | | 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 | 云服务器挂载的云磁盘信息，详情请参见[表8]。 | | fault | Object | 云服务器故障信息。 可选参数，在云服务器状态为ERROR且存在异常的情况下返回。 详情参见 [表10]。 | | description | String | 云服务器的描述信息。 微版本2.19及以上版本支持。 | | host_status | String | nova-compute状态。 - UP：服务正常 - UNKNOWN：状态未知 - DOWN：服务异常 - MAINTENANCE：维护状态 - 空字符串：云服务器无主机信息 微版本2.16及以上版本支持。 | | OS-EXT-SRV-ATTR:hostname | String | 云服务器的主机名。 微版本2.3及以上版本支持。 | | OS-EXT-SRV-ATTR:reservation_id | String | 批量创建场景，云服务器的预留ID。 微版本2.3及以上版本支持。 | | OS-EXT-SRV-ATTR:launch_index | Integer | 批量创建场景，云服务器的启动顺序。 微版本2.3及以上版本支持。 | | OS-EXT-SRV-ATTR:kernel_id | String | 若使用AMI格式的镜像，则表示kernel image的UUID；否则，留空。 微版本2.3及以上版本支持。 | | OS-EXT-SRV-ATTR:ramdisk_id | String | 若使用AMI格式镜像，则表示ramdisk image的UUID；否则，留空。 微版本2.3及以上版本支持。 | | OS-EXT-SRV-ATTR:root_device_name | String | 云服务器系统盘的设备名称。 微版本2.3及以上版本支持。 | | OS-EXT-SRV-ATTR:user_data | String | 创建云服务器时指定的user_data。 微版本2.3及以上版本支持。 | | locked | Boolean | 当云服务器被锁时为True，否则为False。 微版本2.9及以上版本支持。 | | accessIPv4 | String | 预留属性。 | | accessIPv6 | String | 预留属性。 | | config_drive | String | 预留属性。 | | progress | Integer | 预留属性。 | 表4flavor字段数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 云服务器类型ID。 微版本2.47及以上版本不支持。 | | links | Array of objects | 云服务器类型相关标记快捷链接信息。 详情请参见[表6]。 微版本2.47及以上版本不支持。 | | vcpus | Integer | 该云服务器规格对应的CPU核数。 在微版本2.47及以上版本支持。 | | ram | Integer | 该云服务器规格对应的内存大小，单位为MiB。 在微版本2.47及以上版本支持。 | | disk | Integer | 该云服务器规格对应要求系统盘大小，0为不限制。 在微版本2.47及以上版本支持。 | | ephemeral | Integer | 未使用。 在微版本2.47及以上版本支持。 | | swap | Integer | 未使用。 在微版本2.47及以上版本支持。 | | original_name | String | 云服务器规格名称。 在微版本2.47及以上版本支持。 | | extra_specs | Object | flavor扩展字段请参考：[os_extra_specs（flavor）字段数据结构说明](https://support.huaweicloud.com/api-ecs/ecs_05_0003.html) 在微版本2.47及以上版本支持。 | 表5image字段数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 镜像ID。 您可以根据镜像ID查询更多镜像信息，详细内容，请参见[查询镜像列表（OpenStack原生）](https://support.huaweicloud.com/api-ims/ims_03_0702.html)。 | | links | Array of objects | 镜像相关标记快捷链接信息，详情请参见[表6]。 | 表6links字段数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | rel | String | 快捷链接标记名称。 | | href | String | 对应快捷链接。 | 表7弹性云服务器所属网络信息的数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | addr | String | IP地址信息。 | | version | Integer | IP地址类型，值为4或6。 - 4：IP地址类型是IPv4 - 6：IP地址类型是IPv6 | | OS-EXT-IPS-MAC:mac_addr | String | 扩展属性，MAC地址。 | | OS-EXT-IPS:type | String | 扩展属性，分配IP地址方式。 | 表8os-extended-volumes:volumes_attached字段数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 云磁盘ID。 | | delete_on_termination | Boolean | 一个标志，指示在删除服务器时是否删除附加的卷。 默认情况下，这是False 微版本2.3及以上版本支持。 | 表9security_groups字段数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | name | String | 安全组名称或者uuid。 | 表10fault字段数据结构说明 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | code | Integer | 错误码。 | | created | String | 异常出现的时间。 | | message | String | 异常描述信息。 | | details | String | 异常详情信息，可选参数，在非空条件下才返回。 | 表11os:scheduler_hints参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | tenancy | 否 | Array of strings | 在指定的专属主机或者共享主机上创建弹性云服务器。 参数值为shared或者dedicated。 | | dedicated_host_id | 否 | Array of strings | 专属主机ID。 此属性仅在tenancy值为dedicated时有效。 | #### 请求示例 查询指定云服务器的详细信息。 ``` GET https://{endpoint}/v2.1/{project_id}/servers/{server_id} ``` #### 响应示例 ``` { "server": { "addresses": { "68269e6e-4a27-441b-8029-35373ad50bd9": [ { "addr": "192.168.0.3", "version": 4, "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:1b:35:78", "OS-EXT-IPS:type": "fixed" } ] }, "created": "2012-08-20T21:11:09Z", "flavor": { "id": "s3.xlarge.2", "links": [ { "href": "http://openstack.example.com/openstack/flavors/s3.xlarge.2", "rel": "bookmark" } ] }, "hostId": "65201c14a29663e06d0748e561207d998b343e1d164bfa0aafa9c45d", "id": "893c7791-f1df-4c3d-8383-3caae9656c62", "image": "", "links": [ { "href": "http://openstack.example.com/v2/openstack/servers/893c7791-f1df-4c3d-8383-3caae9656c62", "rel": "self" }, { "href": "http://openstack.example.com/openstack/servers/893c7791-f1df-4c3d-8383-3caae9656c62", "rel": "bookmark" } ], "metadata": {}, "name": "new-server-test", "progress": 0, "status": "ACTIVE", "tenant_id": "openstack", "updated": "2012-08-20T21:11:09Z", "user_id": "fake" } } ``` #### 返回值 请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。