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
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.
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. |
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:
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.
Parámetro |
Tipo |
Descripción |
---|---|---|
server_group |
Object |
Especifica la información del grupo de ECS. Para más detalles, consulte Tabla 5. |
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": {} } }