文档首页/ 云数据库 GeminiDB/ API参考（联盟区域）/ API v3/ 参数模板管理/ 查询实例参数的修改历史
更新时间：2026-07-31 GMT+08:00
查看PDF
分享

查询实例参数的修改历史

功能介绍

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

接口约束

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

  • GeminiDB Cassandra
  • GeminiDB Influx

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

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条数据，表示从第一条数据开始查询）。

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

limit

否

Integer

查询个数上限值。

  • 取值范围: 1~100。
  • 不传该参数时，默认查询前100条信息。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。

响应参数

状态码： 200

表4 响应Body参数

参数

参数类型

描述

total_count

Integer

参数修改历史记录总条数。

默认返回参数历史修改记录总条数。若为参数名搜索，返回符合要求的记录总条数。

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

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 参数模板管理