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/ 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 /v1/{project_id}/cloudservers/os-server-groups?limit={limit}&marker={marker}

Tabela 1 descreve os parâmetros no URI.

**Tabela 1** Parâmetros de caminho
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.

**Tabela 2** Parâmetros de consulta
Parâmetro	Obrigatório	Tipo	Descrição
limit	Não	Integer	Especifica o limite superior do número de grupos de servidores retornados. O valor máximo é 1000.
marker	Não	String	Especifica o marcador que aponta para o grupo ECS. A consulta começa a partir da próxima parte dos dados indexados por esse parâmetro. Os parâmetros marcador e limite devem ser usados juntos.

Solicitação

Nenhum

Resposta

Tabela 3 descreve os parâmetros de resposta.

**Tabela 3** Parâmetros de resposta
Parâmetro	Tipo	Descrição
server_groups	Array of objects	Especifica grupos de ECS. Para mais detalhes, consulte Tabela 4.
page_info	Object	Se a função de paginação estiver ativada, o UUID do último grupo ECS na página atual será retornado. Para mais detalhes, consulte Tabela 5.

**Tabela 4** 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 contidos em um grupo de ECS.
metadata	Object	Especifica os metadados do grupo de ECS.
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.

**Tabela 5** descrição do campo **page_info**
Parâmetro	Tipo	Descrição
next_marker	String	Especifica um UUID de grupo ECS.

Exemplo de solicitação

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

Exemplo de resposta

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