更新时间:2025-08-30 GMT+08:00

查询实例参数的修改历史

功能介绍

查询实例参数的修改历史。

接口约束

该接口支持如下数据库实例:

  • GeminiDB Cassandra
  • GeminiDB Mongo
  • GeminiDB Influx经典部署模式实例
  • GeminiDB Redis经典部署模式实例

该接口仅支持查询7天内的参数修改历史。

GeminiDB Influx 单节点实例暂时不支持查询实例参数的修改历史。

URI

GET https://{Endpoint}/v3/{project_id}/instances/{instance_id}/configuration-histories

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

租户在某一region下的project ID。获取方法请参见获取项目ID

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

instance_id

String

参数解释

实例ID。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

参数解释

索引位置,偏移量。

从第一条数据偏移offset条数据后开始查询,默认为0(偏移0条数据,表示从第一条数据开始查询)。

约束限制

取值必须为数字,不能为负数。

取值范围

非负整数。

默认取值

0

limit

Integer

参数解释

查询个数上限值。

约束限制

不涉及。

取值范围

1~100。

默认取值

100。不传该参数时,默认查询前100条信息。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token。

通过调用IAM服务获取用户Token接口获取。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值

不涉及。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

histories

Array of ConfigurationHistoryRsp objects

参数解释:

实例参数的修改历史列表。

表5 ConfigurationHistoryRsp

参数

参数类型

描述

parameter_name

String

参数解释

参数名称。

取值范围

不涉及。

old_value

String

参数解释

参数旧值。

取值范围

不涉及。

new_value

String

参数解释

参数新值。

取值范围

不涉及。

update_result

String

参数解释

更新结果。

取值范围

  • SUCCESS:成功。
  • FAILED:失败。

applied

Boolean

参数解释

是否生效。

取值范围

  • true:已生效。
  • false:未生效。

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

{
  "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"
  } ]
}

状态码

请参见状态码

错误码

请参见错误码