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> Auto Scaling> Referência de API> APIs> Instâncias> Consulta de instâncias em um grupo de AS
Atualizado em 2023-07-04 GMT+08:00

Consulta de instâncias em um grupo de AS

Função

Essa API é usada para consultar instâncias em um grupo de AS com base em critérios de pesquisa. Os resultados são exibidos por página.

  • Os critérios de pesquisa podem ser o status do ciclo de vida da instância, o status de integridade da instância, o status de proteção da instância, o número da linha inicial e o número de registros no grupo de AS.
  • Se nenhum critério de pesquisa for especificado, um máximo de 20 instâncias em um grupo de AS poderão ser consultadas por padrão.

URI

GET /autoscaling-api/v1/{project_id}/scaling_group_instance/{scaling_group_id}/list

Você pode digitar o ponto de interrogação (?) e o e comercial (&) no final do URI para definir vários critérios de pesquisa. As instâncias em um grupo de AS podem ser pesquisadas por todos os parâmetros opcionais na tabela a seguir. Para obter detalhes, consulte a solicitação de exemplo.

Tabela 1 Descrição do parâmetro

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

Especifica o ID do projeto.

scaling_group_id

Sim

String

Especifica o ID do grupo de AS.

life_cycle_state

Não

String

Especifica o status do ciclo de vida da instância no grupo de AS.

  • INSERVICE: a instância está ativada.
  • PENDING: a instância está sendo adicionada ao grupo de AS.
  • PENDING_WAIT: a instância está aguardando para ser adicionada ao grupo de AS.
  • REMOVING: a instância está sendo removida do grupo de AS.
  • REMOVING_WAIT: a instância está aguardando para ser removida do grupo de AS.
  • STANDBY: a instância está em estado de espera.
  • ENTERING_STANDBY: a instância está entrando no estado de espera.

health_status

Não

String

Especifica o status de integridade da instância.

  • INITIALIZING: a instância está inicializando.
  • NORMAL: a instância é normal.
  • ERROR: a instância é anormal.

protect_from_scaling_down

Não

String

Especifica o status de proteção da instância.

  • true: a proteção de instância está ativada.
  • false: a proteção da instância está desativada.

start_number

Não

Integer

Especifica o número da linha de partida. O valor padrão é 0. O valor mínimo do parâmetro é 0.

limit

Não

Integer

Especifica o número de registros de consulta. O valor padrão é 20. O valor varia de 0 a 100.

Mensagem de solicitação

  • Parâmetros de solicitação

    Nenhum

  • Exemplo de solicitação
    Este exemplo mostra como consultar instâncias íntegras e ativadas no grupo de AS com ID e5d27f5c-dd76-4a61-b4bc-a67c5686719a.
    GET https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group_instance/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/list?life_cycle_state=INSERVICE&health_status=NORMAL

Mensagem de resposta

  • Parâmetros de resposta
    Tabela 2 Parâmetros de resposta

    Parâmetro

    Tipo

    Descrição

    total_number

    Integer

    Especifica o número total de registros de consulta.

    start_number

    Integer

    Especifica o número da linha inicial.

    limit

    Integer

    Especifica o número máximo de recursos a serem consultados.

    scaling_group_instances

    Array of scaling_group_instances objects

    Especifica detalhes sobre as instâncias no grupo de AS.

    Tabela 3 Descrição do campo scaling_group_instances

    Parâmetro

    Tipo

    Descrição

    instance_id

    String

    Especifica o ID da instância.

    instance_name

    String

    Especifica o nome da instância.

    scaling_group_id

    String

    Especifica o ID do grupo de AS ao qual a instância pertence.

    scaling_group_name

    String

    Especifica o nome do grupo de AS ao qual a instância pertence.

    Suporta pesquisa difusa.

    life_cycle_state

    String

    Especifica o status do ciclo de vida da instância no grupo de AS.

    • INSERVICE: a instância está ativada.
    • PENDING: a instância está sendo adicionada ao grupo de AS.
    • PENDING_WAIT: a instância está aguardando para ser adicionada ao grupo de AS.
    • REMOVING: a instância está sendo removida do grupo de AS.
    • REMOVING_WAIT: a instância está aguardando para ser removida do grupo de AS.
    • STANDBY: a instância está em estado de espera.
    • ENTERING_STANDBY: a instância está entrando no estado de espera.

    health_status

    String

    Especifica o status de integridade da instância.

    • INITIALIZING: a instância está sendo inicializada.
    • NORMAL: a instância é funcional.
    • ERROR: a instância é defeituosa.

    scaling_configuration_name

    String

    Especifica o nome da configuração de AS.

    scaling_configuration_id

    String

    Especifica o ID de configuração de AS.

    Se o valor retornado não estiver vazio, a instância é um ECS criado automaticamente em uma ação de dimensionamento.

    Se o valor retornado estiver vazio, a instância é um ECS adicionado manualmente ao grupo de AS.

    create_time

    String

    Especifica a hora em que a instância é adicionada ao grupo de AS. O formato de tempo está em conformidade com o UTC.

    protect_from_scaling_down

    Boolean

    Especifica o status de proteção da instância.

  • Exemplo de resposta
    {
        "limit": 10,
        "total_number": 1,
        "start_number": 0,
        "scaling_group_instances": [
            {
                "instance_id": "b25c1589-c96c-465b-9fef-d06540d1945c",
                "scaling_group_id": "e5d27f5c-dd76-4a61-b4bc-a67c5686719a",
                "scaling_group_name": "discuz",
                "life_cycle_state": "INSERVICE",
                "health_status": "NORMAL",
                "scaling_configuration_name": "discuz",
                "scaling_configuration_id": "ca3dcd84-d197-4c4f-af2a-cf8ba39696ac",
                "create_time": "2015-07-23T06:47:33Z",
                "instance_name": "discuz_3D210808",
                "protect_from_scaling_down": false
            }
        ]
    }

Valores retornados

  • Normal

    200

  • Anormal

    Valores retornados

    Descrição

    400 Bad Request

    O servidor falhou ao processar a solicitação.

    401 Unauthorized

    Você deve digitar o nome de usuário e a senha para acessar a página solicitada.

    403 Forbidden

    Você está proibido de acessar a página solicitada.

    404 Not Found

    O servidor não conseguiu encontrar a página solicitada.

    405 Method Not Allowed

    Você não tem permissão para usar o método especificado na solicitação.

    406 Not Acceptable

    A resposta gerada pelo servidor não poderia ser aceita pelo cliente.

    407 Proxy Authentication Required

    Você deve usar o servidor proxy para autenticação para que a solicitação possa ser processada.

    408 Request Timeout

    A solicitação expirou o tempo limite.

    409 Conflict

    A solicitação não pôde ser processada devido a um conflito.

    500 Internal Server Error

    Falhou ao concluir a solicitação porque ocorre um erro de serviço interno.

    501 Not Implemented

    Falhou ao concluir a solicitação porque o servidor não suporta a função solicitada.

    502 Bad Gateway

    Falhou ao concluir a solicitação porque a solicitação é inválida.

    503 Service Unavailable

    Falhou ao concluir a solicitação porque o sistema não está disponível.

    504 Gateway Timeout

    Ocorreu um erro de tempo limite de gateway.

Códigos de erro

Consulte Códigos de erro.