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/ 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 grupos antiafinidad.

URI

POST /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.

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** Descripción del campo **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. NOTA: Se sugiere que utilice la política descrita en Creación de un grupo de ECS.

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 de ECS. Para más detalles, consulte Tabla 5.

**Tabla 5** Descripción del campo **server_group**
Parámetro	Tipo	Descripción
id	String	Especifica el UUID del grupo de ECS.
name	String	Especifica el nombre 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.
members	Array of strings	Especifica el contenido de 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.
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

POST https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/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": {}
    }
}