文档首页/ 云数据库 GeminiDB/ API参考/ API v3（推荐）/ 参数模板管理/ 查询实例参数的修改历史
更新时间：2023-11-21 GMT+08:00
查看PDF
分享

查询实例参数的修改历史

功能介绍

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

接口约束

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

  • GeminiDB Cassandra
  • GeminiDB Mongo
  • GeminiDB Influx

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

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

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

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参数

参数

参数类型

描述

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指时区偏移量，例如北京时间偏移显示为+0800。

applied_at

String

生效时间，格式为"yyyy-MM-ddTHH:mm:ssZ"。

其中，T指某个时间的开始；Z指时区偏移量，例如北京时间偏移显示为+0800。

请求示例

  • URI样例 
    GET https://gaussdb-nosql.cn-north-7.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"
  } ]
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 参数模板管理

相关文档