查询实例参数修改历史
接口约束
- 支持的数据库引擎：MySQL、PostgreSQL、Microsoft SQL Server。
URI
- 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}
- 参数说明
表1 参数说明 名称
是否必选
参数类型
说明
project_id
是
String
参数解释：
租户在某一Region下的项目ID。
获取方法请参见获取项目ID。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
instance_id
是
String
参数解释：
实例ID。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
offset
否
Integer
参数解释：
分页参数。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
0
limit
否
Integer
参数解释：
分页参数。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
10
start_time
否
String
参数解释：
开始时间。
约束限制：
不涉及。
取值范围：
格式为“yyyy-mm-ddThh:mm:ssZ”。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。
默认取值：
默认为当前时间的前7天。
end_time
否
String
参数解释：
结束时间。
约束限制：
不涉及。
取值范围：
格式为“yyyy-mm-ddThh:mm:ssZ”。其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。
默认取值：
默认为当前时间。
param_name
否
String
参数解释：
参数名称。
约束限制：
不涉及。
取值范围：
不涉及。
默认取值：
不涉及。
请求消息
响应消息
- 正常响应要素说明
表2 要素说明 参数
参数类型
描述
total_count
Integer
参数解释：
历史记录总数。
取值范围：
不涉及。
histories
Array of objects
参数解释：
参数修改历史。
详情请参见表3。
表3 histories字段数据结构说明 名称
参数类型
说明
parameter_name
String
参数解释：
参数名称。
取值范围：
不涉及。
old_value
String
参数解释：
旧参数值。
取值范围：
不涉及。
new_value
String
参数解释：
新参数值。
取值范围：
不涉及。
update_result
String
参数解释：
更新结果。
取值范围：
- SUCCESS：成功。
- FAILED：失败。
applied
Boolean
参数解释：
是否已应用。
取值范围：
- true：已应用。
- false：未应用。
update_time
String
参数解释：
参数修改时间。
取值范围：
不涉及。
apply_time
String
参数解释：
参数应用时间。
取值范围：
不涉及。
- 正常响应样例
{ "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" } ] } - 异常响应
请参见异常请求结果。
状态码
- 正常
- 异常
请参见状态码。
错误码
请参见错误码。
