華為云計(jì)算 云知識 查詢專屬主機(jī)上的云服務(wù)器ListServersDedicatedHost
查詢專屬主機(jī)上的云服務(wù)器ListServersDedicatedHost

 

功能介紹

查詢 專屬主機(jī) 上已部署的 云服務(wù)器 信息。

調(diào)試

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

URI

GET /v1.0/{project_id}/dedicated-hosts/{dedicated_host_id}/servers

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

表1 參數(shù)說明

參數(shù)

參數(shù)類型

是否必選

描述

project_id

String

項(xiàng)目ID。

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

dedicated_host_id

String

專屬主機(jī)ID。

可以從專屬主機(jī)控制臺查詢,或者通過調(diào)用查詢專屬主機(jī)列表API獲取。

請求消息

  • 請求參數(shù)
    表2 請求參數(shù)

    參數(shù)

    位置

    參數(shù)類型

    是否必選

    描述

    limit

    query

    String

    每個頁面上顯示的條目數(shù)。

    marker

    query

    String

    該值是上一頁最后一條記錄的ID。如果“marker”取值無效,將會返回“400”錯誤碼。

  • 請求樣例
    GET https://{Endpoint}/v1.0/9c53a566cb3443ab910cf0daebca90c4/dedicated-hosts/ab910cf0daebca90c4001/servers

響應(yīng)消息

  • 響應(yīng)參數(shù)
    表3 響應(yīng)參數(shù)

    參數(shù)

    位置

    類型

    描述

    servers

    body

    Array of objects

    服務(wù)器對象,詳情請參見表4 servers字段數(shù)據(jù)結(jié)構(gòu)說明。

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

    參數(shù)

    參數(shù)類型

    描述

    addresses

    Map<String, Object>

    云服務(wù)器對應(yīng)的網(wǎng)絡(luò)地址信息。

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

    • key為VPC子網(wǎng)ID。
    • value為網(wǎng)絡(luò)屬性,詳情請參見表5。

    created

    String

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

    flavor

    Object

    彈性云服務(wù)器規(guī)格信息。詳情參見表6。

    id

    String

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

    name

    String

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

    status

    String

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

    取值范圍:

    ACTIVE、BUILD、DELETED、ERROR、HARD_REBOOT、MIGRATING、PASSWORD、PAUSED、REBOOT、REBUILD、RESIZE、REVERT_RESIZE、SHUTOFF、SHELVED、SHELVED_OFFLOADED、SOFT_DELETED、SUSPENDED、VERIFY_RESIZE

    tenant_id

    String

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

    updated

    String

    彈性云服務(wù)器更新時間。

    user_id

    String

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

    task_state

    String

    彈性云服務(wù)器當(dāng)前任務(wù)的狀態(tài)。

    image

    Object

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

    metadata

    Object

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

    表5 彈性云服務(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地址方式。

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

    參數(shù)

    參數(shù)類型

    描述

    id

    String

    規(guī)格id。

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

    參數(shù)

    參數(shù)類型

    描述

    id

    String

    鏡像uuid。

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

    參數(shù)

    參數(shù)類型

    描述

    os_type

    String

    操作系統(tǒng)類型。

  • 響應(yīng)樣例
    {
        "servers": [
            {
              "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-09-07T16:56:37Z", 
                "flavor": {
                    "id": "1"
                },
                "id": "05184ba3-00ba-4fbc-b7a2-03b62b884931",
                "metadata": {
                    "os_type": "Linux"
                }, 
                "name": "new-server-test", 
                "status": "ACTIVE", 
                "tenant_id": "fake_project_id", 
                "updated": "2012-09-07T16:56:37Z", 
                "user_id": "fake",
                "task_state": "",
                "image": {
                    "id": "1ce5800a-e487-4c1b-b264-3353a39e2b4b"
                }
            }
        ]
    }

返回值

請參見狀態(tài)碼。