Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Elastic Cloud Server/ Referencia de la API/ API de OpenStack Nova/ Gestión de grupos de ECS/ Consulta de grupos de ECS

Actualización más reciente 2025-08-25 GMT+08:00

Ver PDF

Consulta de grupos de ECS

Función

Esta API se utiliza para consultar grupos de ECS.

URI

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

Tabla 1 describe los parámetros en el URI.

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Descripción
project_id	Sí	Especifica el ID del proyecto. Para obtener más información sobre cómo obtener el ID, consulte Obtención de un ID de proyecto.

Los parámetros de la siguiente tabla se pueden utilizar como parámetros URI para filtrar los resultados de la consulta.

Usage: /v2/{project_id}/os-server-groups?

Solicitud

No hay

Respuesta

Tabla 2 describe los parámetros de respuesta.

**Tabla 2** Parámetros de respuesta
Parámetro	Tipo	Descripción
server_groups	Array of objects	Especifica la información del grupo de ECS. Para más detalles, consulte Tabla 3.

**Tabla 3** Información del parámetro **server_groups**
Parámetro	Tipo	Descripción
id	String	Especifica el UUID del grupo de ECS.
name	String	Especifica el nombre del grupo de ECS.
members	Array of strings	Especifica los ECS en un grupo de ECS.
metadata	Object	Especifica los metadatos del grupo de ECS.
project_id	String	Especifica el ID de inquilino en formato UUID para el grupo de ECS. Este parámetro está soportado en la microversión 2.13 y posteriores.
policies	Array of strings	Especifica las políticas asociadas al grupo de ECS. Opciones: anti-affinity: los sECS de este grupo deben desplegarse en diferentes hosts.
user_id	String	Especifica el ID de usuario en formato UUID para el grupo de ECS. Este parámetro está soportado en la microversión 2.13 y posteriores.

Ejemplo de la solicitud

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

Ejemplo de la respuesta

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