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
Compartilhar

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

Valores retornados

Consulte Valores retornados para solicitações gerais.

Códigos de erro

Consulte Códigos de erro.

Tópico principal: Gerenciamento de grupo ECS