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
Compartilhar

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

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