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}¶m_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
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
- 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.