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 (recomendado)/ 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 /v1/{project_id}/cloudservers/os-server-groups?limit={limit}&marker={marker}

Tabla 1 describe los parámetros en el URI.

**Tabla 1** Parámetros de ruta
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.

**Tabla 2** Parámetros de consulta
Parámetro	Obligatorio	Tipo	Descripción
limit	No	Integer	Especifica el límite superior del número de grupos de servidores devueltos. El valor máximo es 1000.
marker	No	String	Especifica el marcador que apunta al grupo ECS. La consulta comienza a partir de la siguiente pieza de datos indexada por este parámetro. Los parámetros mark y limit deben usarse juntos.

Solicitud

No hay

Respuesta

Tabla 3 describe los parámetros de respuesta.

**Tabla 3** Parámetros de respuesta
Parámetro	Tipo	Descripción
server_groups	Array of objects	Especifica grupos de ECS. Para más detalles, consulte Tabla 4.
page_info	Object	Si la función de paginación está habilitada, se devuelve el UUID del último grupo ECS de la página actual. Para más detalles, consulte Tabla 5.

**Tabla 4** 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 el contenido de ECS en un grupo de ECS.
metadata	Object	Especifica los metadatos del grupo de ECS.
policies	Array of strings	Especifica las políticas asociadas al grupo de ECS. Opciones: anti-affinity: los ECS de este grupo deben desplegarse en diferentes hosts.

**Tabla 5** **page_info** field description
Parámetro	Tipo	Descripción
next_marker	String	Especifica un UUID de grupo ECS.

Ejemplo de la solicitud

GET https://{endpoint}/v1/{project_id}/cloudservers/os-server-groups

Ejemplo de la respuesta

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