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 da Nova do OpenStack/ ECS Group Management/ Criação de um grupo de ECS

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

Ver PDF

Criação de um grupo de ECS

Função

Esta API é usada para criar um grupo ECS.

Restrições

Somente grupos de anti-afinidade são suportados.

URI

POST /v2.1/{project_id}/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 de ECS. Para mais detalhes, consulte Tabela 3.

**Tabela 3** descrição do campo **server_group**
Parâmetro	Obrigatório	Tipo	Descrição
name	Sim	String	Especifica o nome do grupo de ECS. O valor contém de 1 a 255 caracteres.
policies	Sim	Array of strings	Especifica as políticas associadas ao grupo de ECS. Opções: anti-affinity: Os ECS neste grupo devem ser implantados em hosts diferentes. NOTA: Sugere-se que você use a política descrita em Criação de um grupo ECS.

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 de ECS. Para mais detalhes, consulte Tabela 5.

**Tabela 5** descrição do campo **server_group**
Parâmetro	Tipo	Descrição
id	String	Especifica o UUID do grupo de ECS.
name	String	Especifica o nome do grupo de 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 os ECS contidos em um grupo de ECS.
metadata	Object	Especifica os metadados do grupo de ECS.
project_id	String	Especifica a ID do locatário no formato UUID para o grupo de ECS. Este parâmetro é suportado na microversão 2.13 e posterior.
user_id	String	Especifica a ID do usuário no formato UUID para o grupo de ECS. Este parâmetro é suportado na microversão 2.13 e posterior.

Exemplo de solicitação

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