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/ Creación de un grupo de ECS

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

Ver PDF

Creación de un grupo de ECS

Función

Esta API se utiliza para crear un grupo de ECS.

Restricciones

Solo se admiten las políticas antiafinidad.

URI

POST /v1/{project_id}/cloudservers/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.

Solicitud

Tabla 2 describe los parámetros de solicitud.

**Tabla 2** Parámetros de solicitud
Parámetro	Obligatorio	Tipo	Descripción
server_group	Sí	Object	Especifica la información del grupo de ECS. Para más detalles, consulte Tabla 3.

**Tabla 3** Parámetros **server_group**
Parámetro	Obligatorio	Tipo	Descripción
name	Sí	String	Especifica el nombre del grupo de ECS. El valor contiene de 1 a 255 caracteres.
policies	Sí	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.

Respuesta

Tabla 4 describe los parámetros de respuesta.

**Tabla 4** Parámetros de respuesta
Parámetro	Tipo	Descripción
server_group	Object	Especifica la información del grupo ECS. Para más detalles, consulte Tabla 5.

**Tabla 5** Parámetros **server_group**
Parámetro	Tipo	Descripción
id	String	Especifica el UUID del grupo de ECS.
name	String	Especifica el nombre del grupo 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.
members	Array of strings	Especifica los identificadores de los ECS de un grupo ECS.
metadata	Object	Especifica los metadatos del grupo ECS.

Ejemplo de la solicitud

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

{
    "server_group": {
        "name": "test",
        "policies": ["anti-affinity"]
    }
}

Ejemplo de la respuesta

{
    "server_group": {
        "id": "5bbcc3c4-1da2-4437-a48a-66f15b1b13f9",
        "name": "test",
        "policies": [
            "anti-affinity"
        ],
        "members": [],
        "metadata": {}
    }
}