Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Elastic Cloud Server/ Referência de API/ As API (recomendado)/ Gerenciamento de grupo ECS/ Criação de um grupo ECS

Atualizado em 2025-08-25 GMT+08:00

Ver PDF

Criação de um grupo ECS

Função

Esta API é usada para criar um grupo ECS.

Restrições

Apenas políticas de anti-afinidade são suportadas.

URI

POST /v1/{project_id}/cloudservers/os-server-groups

Tabela 1 descreve os parâmetros no URI.

**Tabela 1** Descrição do parâmetro
Parâmetro	Obrigatório	Descrição
project_id	Sim	Especifica a ID do projeto. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto.

Solicitação

Tabela 2 descreve os parâmetros de solicitação.

**Tabela 2** Parâmetros de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
server_group	Sim	Object	Especifica as informações do grupo ECS. Para mais detalhes, consulte Tabela 3.

**Tabela 3** parâmetros **server_group**
Parâmetro	Obrigatório	Tipo	Descrição
name	Sim	String	Especifica o nome do grupo ECS. O valor contém de 1 a 255 caracteres.
policies	Sim	Array of strings	Especifica as políticas associadas ao grupo ECS. Opções: anti-affinity: Os ECS nesse grupo devem ser implantados em hosts diferentes.

Resposta

Tabela 4 descreve os parâmetros de resposta.

**Tabela 4** Parâmetros de resposta
Parâmetro	Tipo	Descrição
server_group	Object	Especifica as informações do grupo ECS. Para mais detalhes, consulte Tabela 5.

**Tabela 5** parâmetros **server_group**
Parâmetro	Tipo	Descrição
id	String	Especifica o UUID do grupo ECS.
name	String	Especifica o nome do grupo ECS.
policies	Array of strings	Especifica as políticas associadas ao grupo ECS. Opções: anti-affinity: Os ECS nesse grupo devem ser implantados em hosts diferentes.
members	Array of strings	Especifica as IDs dos ECS em um grupo de ECS.
metadata	Object	Especifica os metadados do grupo ECS.

Exemplo de solicitação

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

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

Exemplo de resposta

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