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/ Consulta de grupos de ECS

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

Ver PDF

Consulta de grupos de ECS

Função

Essa API é usada para consultar grupos de ECS.

URI

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

Os parâmetros na tabela a seguir podem ser usados como parâmetros URI para filtrar os resultados da consulta.

Uso: /v2/{project_id}/os-server-groups?

Solicitação

Nenhum

Resposta

Tabela 2 descreve os parâmetros de resposta.

**Tabela 2** Parâmetros de resposta
Parâmetro	Tipo	Descrição
server_groups	Array of objects	Especifica as informações do grupo de ECS. Para mais detalhes, consulte Tabela 3.

**Tabela 3** informações do parâmetro **server_groups**
Parâmetro	Tipo	Descrição
id	String	Especifica o UUID do grupo ECS.
name	String	Especifica o nome do grupo de ECS.
members	Array of strings	Especifica os ECS 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.
policies	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.
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

GET https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/os-server-groups

Exemplo de resposta

{
    "server_groups": [
        {
            "id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
            "name": "test",
            "policies": ["anti-affinity"],
            "members": [],
            "metadata": {},
            "project_id": "9c53a566cb3443ab910cf0daebca90c4"
        }
    ]
}