華為云計算 云知識 查詢云服務器組列表NovaListServerGroups
查詢云服務器組列表NovaListServerGroups

 

功能介紹

查詢 云服務器 組列表。

調試

您可以在API Explorer中調試該接口。

URI

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

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

參數(shù)

是否必選

描述

project_id

項目ID。

獲取方法請參見獲取項目ID。

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

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

請求消息

響應消息

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

表2 響應參數(shù)

參數(shù)

參數(shù)類型

描述

server_groups

Array of objects

云服務器組信息,參考表3。

表3 server_groups參數(shù)信息

參數(shù)

參數(shù)類型

描述

id

String

云服務器組UUID。

name

String

云服務器組名稱。

members

Array of strings

云服務器組中包含的云服務器列表。

metadata

Object

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

project_id

String

云服務器組所屬租戶ID,UUID格式。

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

policies

Array of strings

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

user_id

String

云服務器組所屬用戶ID,UUID格式。

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

請求示例

查詢云服務器組列表。

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

響應示例

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

返回值

請參考通用請求返回值。