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
Compartir

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"
    }
}

Valores devueltos

Consulte Valores devueltos para solicitudes generales

Códigos de error

Consulte Códigos de error