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
Compartir

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

Valores devueltos

Consulte Valores devueltos para solicitudes generales

Códigos de error

Consulte Códigos de error

Tema principal: Gestión de grupos de ECS