華為云計(jì)算 云知識 查詢彈性云服務(wù)器詳情NovaShowServer
查詢彈性云服務(wù)器詳情NovaShowServer

 

功能介紹

根據(jù) 云服務(wù)器 ID,查詢云服務(wù)器的詳細(xì)信息。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

GET /v2.1/{project_id}/servers/{server_id}

參數(shù)說明請參見表1。
表1 參數(shù)說明

參數(shù)

是否必選

描述

project_id

項(xiàng)目ID。

獲取方法請參見獲取項(xiàng)目ID。

server_id

云服務(wù)器ID。

請求消息

響應(yīng)消息

響應(yīng)參數(shù)如表2所示。
表2 響應(yīng)參數(shù)

參數(shù)

參數(shù)類型

描述

server

Object

云服務(wù)器信息,詳情請參見表3。

表3 server字段數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

name

String

id

String

status

String

created

String

updated

String

flavor

Object

image

Object

tenant_id

String

key_name

String

user_id

String

metadata

Object

hostId

String

addresses

Object

security_groups

Array of objects

links

Array of objects

tags

Array of strings

os:scheduler_hints

Object

OS-DCF:diskConfig

String

OS-EXT-AZ:availability_zone

String

OS-EXT-SRV-ATTR:host

String

OS-EXT-SRV-ATTR:hypervisor_hostname

String

OS-EXT-SRV-ATTR:instance_name

String

OS-EXT-STS:power_state

Integer

OS-EXT-STS:task_state

String

OS-EXT-STS:vm_state

String

OS-SRV-USG:launched_at

String

OS-SRV-USG:terminated_at

String

os-extended-volumes:volumes_attached

Array of objects

fault

Object

description

String

host_status

String

OS-EXT-SRV-ATTR:hostname

String

OS-EXT-SRV-ATTR:reservation_id

String

OS-EXT-SRV-ATTR:launch_index

Integer

OS-EXT-SRV-ATTR:kernel_id

String

OS-EXT-SRV-ATTR:ramdisk_id

String

OS-EXT-SRV-ATTR:root_device_name

String

OS-EXT-SRV-ATTR:user_data

String

locked

Boolean

accessIPv4

String

accessIPv6

String

config_drive

String

progress

Integer

表4 flavor字段數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

id

String

云服務(wù)器類型ID。

微版本2.47及以上版本不支持。

links

Array of objects

云服務(wù)器類型相關(guān)標(biāo)記快捷鏈接信息。

詳情請參見表6。

微版本2.47及以上版本不支持。

vcpus

Integer

云服務(wù)器規(guī)格對應(yīng)的CPU核數(shù)。

在微版本2.47及以上版本支持。

ram

Integer

云服務(wù)器規(guī)格對應(yīng)的內(nèi)存大小,單位為MB。

在微版本2.47及以上版本支持。

disk

Integer

云服務(wù)器規(guī)格對應(yīng)要求系統(tǒng)盤大小,0為不限制。

在微版本2.47及以上版本支持。

ephemeral

Integer

未使用。

在微版本2.47及以上版本支持。

swap

Integer

未使用。

在微版本2.47及以上版本支持。

original_name

String

云服務(wù)器規(guī)格名稱。

在微版本2.47及以上版本支持。

extra_specs

Object

flavor擴(kuò)展字段請參考:os_extra_specs(flavor)字段數(shù)據(jù)結(jié)構(gòu)說明

在微版本2.47及以上版本支持。

表5 image字段數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

id

String

鏡像 ID。

您可以根據(jù)鏡像ID查詢更多鏡像信息,詳細(xì)內(nèi)容,請參見查詢鏡像列表(OpenStack原生)。

links

Array of objects

鏡像相關(guān)標(biāo)記快捷鏈接信息,詳情請參見表6。

表6 links字段數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

rel

String

快捷鏈接標(biāo)記名稱。

href

String

對應(yīng)快捷鏈接。

表7 彈性云服務(wù)器所屬網(wǎng)絡(luò)信息的數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

addr

String

IP地址信息。

version

Integer

IP地址類型,值為4或6。

  • 4:IP地址類型是IPv4
  • 6:IP地址類型是IPv6

OS-EXT-IPS-MAC:mac_addr

String

擴(kuò)展屬性,MAC地址。

OS-EXT-IPS:type

String

擴(kuò)展屬性,分配IP地址方式。

表8 os-extended-volumes:volumes_attached字段數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

id

String

云磁盤ID。

delete_on_termination

Boolean

一個標(biāo)志,指示在刪除服務(wù)器時是否刪除附加的卷。

默認(rèn)情況下,這是False

微版本2.3及以上版本支持。

表9 security_groups字段數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

name

String

安全組名稱或者uuid。

表10 fault字段數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

code

Integer

錯誤碼。

created

String

異常出現(xiàn)的時間。

message

String

異常描述信息。

details

String

異常詳情信息,可選參數(shù),在非空條件下才返回。

表11 os:scheduler_hints參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

tenancy

Array of strings

在指定的 專屬主機(jī) 或者共享主機(jī)上創(chuàng)建彈性云服務(wù)器。

參數(shù)值為shared或者dedicated。

dedicated_host_id

Array of strings

專屬主機(jī)ID。

此屬性僅在tenancy值為dedicated時有效。

請求示例

查詢指定云服務(wù)器的詳細(xì)信息。

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

響應(yīng)示例

{
    "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": "1", 
            "links": [
                {
                    "href": "http://openstack.example.com/openstack/flavors/1", 
                    "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"
    }
}

返回值

請參考通用請求返回值