Consulta de instancias en un grupo AS

Función

Esta API se utiliza para consultar instancias en un grupo AS según criterios de búsqueda. Los resultados se muestran por página.

• Los criterios de búsqueda pueden ser el estado del ciclo de vida de la instancia, el estado de la instancia, el estado de protección de la instancia, el número de línea de inicio y el número de registros en el grupo AS.
• Si no se especifica ningún criterio de búsqueda, se puede consultar un máximo de 20 instancias en un grupo AS de forma predeterminada.

URI

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

Puede escribir el signo de interrogación (?) y ampersand (&) al final del URI para definir varios criterios de búsqueda. Las instancias de un grupo AS se pueden buscar mediante todos los parámetros opcionales de la siguiente tabla. Para obtener más información, consulte la solicitud de ejemplo.

Mensaje de solicitud

• Parámetros de solicitud

  No hay

• Ejemplo de la solicitud
  Este ejemplo muestra cómo consultar instancias sanas y habilitadas en el grupo AS con el 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

Mensaje de la respuesta

• Parámetros de respuesta

  Tabla 2 Parámetros de respuesta

  Parámetro	Tipo	Descripción
  total_number	Integer	Especifica el número total de registros de consulta.
  start_number	Integer	Especifica el número de línea inicial.
  limit	Integer	Especifica el número máximo de recursos que se van a consultar.
  scaling_group_instances	Array of scaling_group_instances objects	Especifica los detalles acerca de las instancias del grupo AS.

  Tabla 3 Descripción del campo scaling_group_instances

  Parámetro	Tipo	Description
  instance_id	String	Especifica el ID de instancia.
  instance_name	String	Especifica el nombre de instancia.
  scaling_group_id	String	Especifica el ID del grupo AS al que pertenece la instancia.
  scaling_group_name	String	Especifica el nombre del grupo AS al que pertenece la instancia. Soporta búsqueda difusa.
  life_cycle_state	String	Especifica el estado del ciclo de vida de la instancia en el grupo AS. INSERVICE: La instancia está habilitada. PENDING: La instancia se está agregando al grupo AS. PENDING_WAIT: La instancia está esperando a ser agregada al grupo AS. REMOVING: La instancia se está eliminando del grupo AS. REMOVING_WAIT: La instancia está esperando a ser eliminada del grupo AS. STANDBY: La instancia está en estado de espera. ENTERING_STANDBY: la instancia está entrando en el estado de espera.
  health_status	String	Especifica el estado del estado de la instancia. INITIALIZING: La instancia se está inicializando. NORMAL: La instancia es funcional. ERROR: La instancia es defectuosa.
  scaling_configuration_name	String	Especifica el nombre de configuración de AS.
  scaling_configuration_id	String	Especifica el ID de configuración de AS. Si el valor devuelto no está vacío, la instancia es un ECS creado automáticamente en una acción de ajuste. Si el valor devuelto está vacío, la instancia es un ECS agregado manualmente al grupo AS.
  create_time	String	Especifica la hora a la que se agrega la instancia al grupo AS. El formato de tiempo cumple con UTC.
  protect_from_scaling_down	Boolean	Especifica el estado de protección de instancia.

• Ejemplo de la respuesta

  {
      "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 devueltos

• Normal

  200

• Anormal

  Valor devuelto	Descripción
  400 Bad Request	Se produjo un error en el servidor al procesar la solicitud.
  401 Unauthorized	Debe introducir el nombre de usuario y la contraseña para acceder a la página solicitada.
  403 Forbidden	Está prohibido el acceso a la página solicitada.
  404 Not Found	No se pudo encontrar la página solicitada.
  405 Method Not Allowed	No se le permite utilizar el método especificado en la solicitud.
  406 Not Acceptable	El cliente no pudo aceptar la respuesta generada por el servidor.
  407 Proxy Authentication Required	Debe utilizar el servidor proxy para la autenticación para que la solicitud pueda procesarse.
  408 Request Timeout	Se agotó el tiempo de espera de la solicitud.
  409 Conflict	La solicitud no se pudo procesar debido a un conflicto.
  500 Internal Server Error	Se produjo un error al completar la solicitud debido a un problema de servicio interno.
  501 Not Implemented	Error al completar la solicitud porque el servidor no admite la función solicitada.
  502 Bad Gateway	Error al completar la solicitud porque la solicitud no es válida.
  503 Service Unavailable	Error al completar la solicitud porque el sistema no está disponible.
  504 Gateway Timeout	Se ha producido un error de tiempo de espera de la puerta de enlace.

Códigos de error

Consulte Códigos de error