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.

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.