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

 

功能介紹

查詢彈性 云服務(wù)器 的詳細信息。

該接口支持查詢彈性云服務(wù)器的計費方式,以及是否被凍結(jié)。

調(diào)試

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

URI

GET /v1/{project_id}/cloudservers/{server_id}

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

參數(shù)

是否必選

描述

project_id

項目ID。

獲取方法請參見獲取項目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ù)類型

描述

status

String

彈性云服務(wù)器狀態(tài)。

取值范圍:

ACTIVE、BUILD、ERROR、HARD_REBOOT、MIGRATING、REBOOT、REBUILD、RESIZE、REVERT_RESIZE、SHUTOFF、VERIFY_RESIZE、DELETED、SHELVED、SHELVED_OFFLOADED 、UNKNOWN

彈性云服務(wù)器狀態(tài)說明請參考云服務(wù)器狀態(tài)。

updated

String

彈性云服務(wù)器最近一次更新時間,例如開機、關(guān)機、重啟等操作。

時間格式例如:2019-05-22T03:30:52Z

hostId

String

彈性云服務(wù)器所在主機的主機ID。

OS-EXT-SRV-ATTR:host

String

彈性云服務(wù)器所在主機的主機名稱。

addresses

Object

彈性云服務(wù)器的網(wǎng)絡(luò)屬性。

屬性為Map<String, Object>結(jié)構(gòu)。

  • key為網(wǎng)絡(luò)名稱,如“demo_net”。
  • value為網(wǎng)絡(luò)屬性,詳情請參見表1。

key_name

String

彈性云服務(wù)器使用的密鑰對名稱。

image

Object

彈性云服務(wù)器 鏡像 信息。詳情請參見:表8

OS-EXT-STS:task_state

String

擴展屬性,彈性云服務(wù)器當前任務(wù)的狀態(tài),請參考云服務(wù)器狀態(tài)。

OS-EXT-STS:vm_state

String

擴展屬性,彈性云服務(wù)器當前狀態(tài),請參考云服務(wù)器狀態(tài)。

OS-EXT-SRV-ATTR:instance_name

String

擴展屬性,彈性云服務(wù)器別名。

OS-EXT-SRV-ATTR:hypervisor_hostname

String

擴展屬性,彈性云服務(wù)器所在虛擬化主機名。

flavor

Object

彈性云服務(wù)器規(guī)格信息。

詳情請參見表2。

id

String

彈性云服務(wù)器ID,格式為UUID。

security_groups

Array of objects

彈性云服務(wù)器所屬安全組列表。

詳情請參見表3。

OS-EXT-AZ:availability_zone

String

擴展屬性,彈性云服務(wù)器所在可用區(qū)名稱。

user_id

String

創(chuàng)建彈性云服務(wù)器的用戶ID,格式為UUID。

name

String

彈性云服務(wù)器名稱。

created

String

彈性云服務(wù)器創(chuàng)建時間。

時間格式例如:2019-05-22T03:19:19Z

tenant_id

String

彈性云服務(wù)器所屬租戶ID,即項目id,和project_id表示相同的概念,格式為UUID。

OS-DCF:diskConfig

String

擴展屬性, diskConfig的類型。

  • MANUAL,鏡像空間不會擴展。
  • AUTO,系統(tǒng)盤鏡像空間會自動擴展為與flavor大小一致。

accessIPv4

String

預(yù)留屬性。

accessIPv6

String

預(yù)留屬性。

fault

Object

彈性云服務(wù)器故障原因,詳情參見表4。

progress

Integer

彈性云服務(wù)器進度,范圍為0到100。

OS-EXT-STS:power_state

Integer

擴展屬性,彈性云服務(wù)器電源狀態(tài)。

取值范圍:

  • 0:NOSTATE
  • 1:RUNNING
  • 4:SHUTDOWN

config_drive

String

config drive信息。

metadata

Map<String,String>

彈性云服務(wù)器元數(shù)據(jù)。詳情請參見表6。

說明:

元數(shù)據(jù)包含系統(tǒng)默認添加字段和用戶設(shè)置的字段。

OS-SRV-USG:launched_at

String

彈性云服務(wù)器啟動時間。時間格式例如:2019-05-22T03:23:59.000000

OS-SRV-USG:terminated_at

String

彈性云服務(wù)器刪除時間。

時間格式例如:2019-05-22T03:23:59.000000

os-extended-volumes:volumes_attached

Array of objects

掛載到彈性云服務(wù)器上的磁盤。

詳情請參見表5。

description

String

彈性云服務(wù)器的描述信息。

host_status

String

云服務(wù)器所在主機狀態(tài)。

  • UP:服務(wù)正常
  • UNKNOWN:狀態(tài)未知
  • DOWN:服務(wù)異常
  • MAINTENANCE:維護狀態(tài)
  • 空字符串:彈性云服務(wù)器無主機信息

OS-EXT-SRV-ATTR:hostname

String

彈性云服務(wù)器的主機名。

OS-EXT-SRV-ATTR:reservation_id

String

批量創(chuàng)建場景,彈性云服務(wù)器的預(yù)留ID,可以根據(jù)該id查詢出批創(chuàng)的所有虛擬機。

OS-EXT-SRV-ATTR:launch_index

Integer

批量創(chuàng)建場景,批創(chuàng)的所有彈性云服務(wù)器的啟動順序,范圍為0到批量數(shù)量。

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

彈性云服務(wù)器系統(tǒng)盤的設(shè)備名稱,例如當系統(tǒng)盤的磁盤模式是VDB,為/dev/vda,磁盤模式是SCSI,為/dev/sda。

OS-EXT-SRV-ATTR:user_data

String

創(chuàng)建彈性云服務(wù)器時指定的user_data(編碼過后的信息)。

locked

Boolean

彈性云服務(wù)器是否為鎖定狀態(tài)。

  • true:鎖定
  • false:未鎖定

tags

Array of strings

彈性云服務(wù)器標簽列表。

os:scheduler_hints

Object

彈性云服務(wù)器調(diào)度信息,詳情請參見表13 。

enterprise_project_id

String

彈性云服務(wù)器所屬的企業(yè)項目ID。

sys_tags

Array of objects

彈性云服務(wù)器系統(tǒng)標簽。

詳情請參見表7。

auto_terminate_time

String

云服務(wù)器自動釋放時間。

說明:

包年/包月云服務(wù)器的自動釋放時間為空。

cpu_options

Object

自定義CPU選項。

詳情請參見表4。

hypervisor

Object

擴展屬性,虛擬化信息。

詳情請參見 表5。

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

參數(shù)

參數(shù)類型

描述

hw:cpu_threads

Integer

CPU超線程數(shù), 決定CPU是否開啟超線程。

取值范圍:1,2。

  • 1: 關(guān)閉超線程。
  • 2: 打開超線程。

需要同時滿足如下條件,才能設(shè)置為“關(guān)閉超線程”:

  • 只能在實例創(chuàng)建或者resize時指定。
  • 只有目標flavor的extra_specs參數(shù):
    • 存在“hw:cpu_policy”并取值為“dedicated”。
    • 存在“hw:cpu_threads”并取值為“2”。
表5 hypervisor數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

參數(shù)類型

描述

hypervisor_type

String

虛擬化類型。

csd_hypervisor

String

預(yù)留屬性。

請求示例

查詢ID為“4f4b3dfa-eb70-47cf-a60a-998a53bd598a”的云服務(wù)器詳情。

GET https://{endpoint}/v1/{project_id}/cloudservers/{server_id}

響應(yīng)示例

{
    "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"
            }
        ]
    }
}

返回值

請參考通用請求返回值。

錯誤碼

請參考錯誤碼