更新时间:2023-11-21 GMT+08:00
分享

查询实例参数的修改历史

功能介绍

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

接口约束

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

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

状态码

请参见状态码

错误码

请参见错误码

相关文档