華為云計(jì)算 云知識(shí) 查詢?cè)品?wù)器組列表NovaListServerGroups
查詢?cè)品?wù)器組列表NovaListServerGroups

 

功能介紹

查詢 云服務(wù)器 組列表。

調(diào)試

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

URI

GET /v2.1/{project_id}/os-server-groups

參數(shù)說(shuō)明請(qǐng)參見(jiàn)表1。
表1 參數(shù)說(shuō)明

參數(shù)

是否必選

描述

project_id

項(xiàng)目ID。

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

可以將如下作為URI參數(shù),過(guò)濾查詢結(jié)果。

使用方式:/v2/{project_id}/os-server-groups?

請(qǐng)求消息

無(wú)

響應(yīng)消息

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

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

參數(shù)

參數(shù)類型

描述

server_groups

Array of objects

云服務(wù)器組信息,參考表3。

表3 server_groups參數(shù)信息

參數(shù)

參數(shù)類型

描述

id

String

云服務(wù)器組UUID。

name

String

云服務(wù)器組名稱。

members

Array of strings

云服務(wù)器組中包含的云服務(wù)器列表。

metadata

Object

云服務(wù)器組元數(shù)據(jù)。

project_id

String

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

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

policies

Array of strings

云服務(wù)器組關(guān)聯(lián)的策略名稱列表。包括:
  • anti-affinity:此組中的云服務(wù)器必須安排到不同的主機(jī)。

user_id

String

云服務(wù)器組所屬用戶ID,UUID格式。

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

請(qǐng)求示例

查詢云服務(wù)器組列表。

GET https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/os-server-groups

響應(yīng)示例

{
    "server_groups": [
        {
            "id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
            "name": "test",
            "policies": ["anti-affinity"],
            "members": [],
            "metadata": {},
            "project_id": "9c53a566cb3443ab910cf0daebca90c4"
        }
    ]
}

返回值

請(qǐng)參考通用請(qǐng)求返回值。