查询实例参数的修改历史
功能介绍
查询实例参数的修改历史。
接口约束
该接口支持如下数据库实例:
- GeminiDB Cassandra
- GeminiDB Mongo
- GeminiDB Influx
- GeminiDB Redis
该接口仅支持查询7天内的参数修改历史。
GeminiDB Influx 单节点实例暂时不支持查询实例参数的修改历史。
URI
GET /v3/{project_id}/instances/{instance_id}/configuration-histories
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 租户在某一region下的project ID。获取方法请参见获取项目ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
instance_id |
是 |
String |
参数解释: 实例ID。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
parameter_name |
否 |
String |
参数解释: 参数名称,支持模糊查询。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
offset |
否 |
Integer |
参数解释: 索引位置,偏移量。 从第一条数据偏移offset条数据后开始查询,默认为0(偏移0条数据,表示从第一条数据开始查询)。 约束限制: 取值必须为数字,不能为负数。 取值范围: 非负整数。 默认取值: 0 |
|
limit |
否 |
Integer |
参数解释: 查询个数上限值。 约束限制: 不涉及。 取值范围: 1~100。 默认取值: 100。不传该参数时,默认查询前100条信息。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
参数解释: 用户Token。 通过调用IAM服务获取用户Token接口获取。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码: 200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
histories |
Array of ConfigurationHistoryRsp objects |
参数解释: 实例参数的修改历史列表。 |
|
total_count |
Integer |
参数解释: 参数修改历史记录总条数。 约束限制: 默认返回参数历史修改记录总条数。若为参数名搜索,返回符合要求的记录总条数。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
parameter_name |
String |
参数解释: 参数名称。 取值范围: 不涉及。 |
|
old_value |
String |
参数解释: 参数旧值。 取值范围: 不涉及。 |
|
new_value |
String |
参数解释: 参数新值。 取值范围: 不涉及。 |
|
update_result |
String |
参数解释: 更新结果。 取值范围:
|
|
applied |
Boolean |
参数解释: 是否生效。 取值范围:
|
|
updated_at |
String |
参数解释: 更新时间。 取值范围: 格式为"yyyy-MM-ddTHH:mm:ssZ"。 其中,T指某个时间的开始;Z指时区偏移量。 |
|
applied_at |
String |
参数解释: 生效时间。 取值范围: 格式为"yyyy-MM-ddTHH:mm:ssZ"。 其中,T指某个时间的开始;Z指时区偏移量。 |
请求示例
- URI样例
GET https://gaussdb-nosql.ap-southeast-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/c4e095105bc64797bc3be633ae7201eein10/configuration-histories?offset=0&limit=10
响应示例
状态码: 200
Success
{
"total_count" : 1,
"histories" : [ {
"parameter_name" : "mongos.connPoolMaxShardedConnsPerHost",
"old_value" : "600",
"new_value" : "500",
"update_result" : "FAILED",
"applied" : true,
"updated_at" : "2022-09-20T11:17:04+0000",
"applied_at" : "2022-09-20T11:17:04+0000"
} ]
}
状态码
请参见状态码。
错误码
请参见错误码。