Consulta del historial de cambios de parámetros de instancia

Función

Esta API se utiliza para consultar el historial de cambios de parámetros de una instancia de base de datos.

• Antes de invocar a una API, debe entender la API de Autenticación.

Restricciones

• Los siguientes motores de base de datos son compatibles: MySQL, PostgreSQL, y Microsoft SQL Server.

URI

• Formato de URI

  GET /v3/{project_id}/instances/{instance_id}/configuration-histories?offset={offset}&limit={limit}&start_time={start_time}&end_time={end_time}&param_name={param_name}

• Descripción de parámetro

  Tabla 1 Parámetros

  Parámetro	Obligatorio	Tipo	Descripción
  project_id	Sí	String	ID de proyecto de un tenant en una región. Para obtener más información sobre cómo obtener el ID del proyecto, consulte Obtención de un ID de proyecto.
  instance_id	Sí	String	ID de instancia.
  offset	No	Integer	Parámetro de paginación. Valor predeterminado: 0.
  limit	No	Integer	Parámetro de paginación. Valor predeterminado: 10
  start_time	No	String	Hora de inicio en el formato "aaaa-MM-ddTHH:mm:ssZ". El valor predeterminado es siete días antes de la hora actual, por ejemplo, 2020-09-01T18:50:20Z.
  end_time	No	String	Hora de finalización en formato "aaaa-MM-ddTHH:mm:ssZ". El valor predeterminado es la hora actual, por ejemplo, 2020-09-01T18:50:20Z.
  param_name	No	String	Nombre del parámetro.

Solicitud

• Descripción de parámetro

  Ninguna

• Ejemplo de URI

  GET https://{endpoint}/v3/054e292c9880d4992f02c0196d3ea468/instances/1922f9c9144a421d9d1dfcb7377a849ain04/configuration-histories

Respuesta

• Respuesta normal

  Tabla 2 Parámetros

  Parámetro	Tipo	Descripción
  total_count	Integer	Número total de registros históricos.
  histories	Array of objects	Lista de historial de cambios de parámetros. Para obtener más información, consulte Tabla 3.

  Tabla 3 descripción de estructura de datos de historiales

  Parámetro	Tipo	Descripción
  parameter_name	String	Nombre del parámetro.
  old_value	String	Valor de parámetro antiguo.
  new_value	String	Valor de parámetro nuevo.
  update_result	String	Actualizar el resultado. Valores válidos: SUCCESS FAILED
  applied	Boolean	Si el nuevo valor se ha aplicado a la instancia. true: indica que se ha aplicado el nuevo valor. false: indica que no se ha aplicado el nuevo valor.
  update_time	String	Hora en la que se actualiza el valor.
  apply_time	String	Hora en la que se aplica el nuevo valor a la instancia.

• Ejemplo de respuesta normal

  {
     "total_count" : 3, 
     "histories" : [ { 
       "parameter_name" : "fill factor (%)", 
       "old_value" : "0", 
       "new_value" : "2", 
       "update_result" : "SUCCESS", 
       "applied" : true, 
       "update_time" : "2022-10-29T09:39:21+0000", 
       "apply_time" : "2022-10-31T01:46:29+0000" 
     }, { 
       "parameter_name" : "remote login timeout (s)", 
       "old_value" : "10", 
       "new_value" : "20", 
       "update_result" : "SUCCESS", 
       "applied" : true, 
       "update_time" : "2022-10-29T09:38:36+0000", 
       "apply_time" : "2022-10-29T09:38:36+0000" 
     }, { 
       "parameter_name" : "remote query timeout (s)", 
       "old_value" : "600", 
       "new_value" : "601", 
       "update_result" : "SUCCESS", 
       "applied" : true, 
       "update_time" : "2022-10-29T09:40:30+0000", 
       "apply_time" : "2022-10-29T09:40:30+0000" 
     } ] 
   }

• Respuesta anormal

  Para obtener más información, consulte Resultados de solicitud anormales.

Código de estado

• Normal

  200

• Anormal

  Para obtener más información, consulte Códigos de estado.

Código de error

Para obtener más información, consulte Códigos de error.