文档首页/ 云数据库 RDS/ API参考/ API v3(推荐)/ 获取日志信息/ 批量添加实例日志上传LTS配置(MySQL)
更新时间:2025-09-01 GMT+08:00
分享

批量添加实例日志上传LTS配置(MySQL)

功能介绍

批量添加实例日志上传LTS配置。

调试

您可以在API Explorer中调试该接口。

接口约束

  • 单次设置LTS日志流时配置项不能超过20个,其中审计日志不能超过10个。
  • 单次请求中无法重复对某个实例的同类日志重复配置LTS日志流。
  • 每个日志流只支持绑定一种日志类型,例如日志流已经配置实例的审计日志,则该日志流不能再配置实例的慢日志或错误日志。同一请求内的单个日志流也无法指定配置多种日志类型。
  • 配置审计日志的LTS日志流时,对于RDS for MySQL实例有内核版本要求:
    • 5.6:云盘实例要求5.6.43及以上版本,本地盘实例要求5.6.47.3及以上版本。
    • 5.7:云盘实例要求5.7.23及以上版本,本地盘实例要求5.7.29.3及以上版本。
    • 8.0:全部内核版本。

URI

  • URI格式

    POST /v3/{project_id}/{engine}/instances/logs/lts-configs

  • 参数说明
    表1 参数说明

    名称

    是否必选

    说明

    project_id

    参数解释:

    租户在某一region下的project ID。

    获取方法请参见获取项目ID

    约束限制:

    不涉及。

    取值范围:

    不涉及。

    默认取值:

    不涉及。

    engine

    参数解释:

    要查询的实例引擎。

    约束限制:

    只支持MySQL引擎。

    取值范围:

    mysql

    默认取值:

    不涉及。

请求参数

表2 参数说明

名称

是否必选

参数类型

说明

log_configs

Array of objects

参数解释:

实例日志配置信息,详情请参见表3

约束限制:

不涉及。

表3 log_configs字段数据结构说明

名称

是否必选

参数类型

说明

instance_id

String

参数解释:

实例ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

log_type

String

参数解释:

日志类型。

约束限制:

不涉及。

取值范围:

  • error_log:错误日志。
  • slow_log:慢日志。
  • audit_log:审计日志。

默认取值:

不涉及。

lts_group_id

String

参数解释:

LTS日志组ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

lts_stream_id

String

参数解释:

LTS日志流ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

请求示例

批量添加MySQL实例的日志上传LTS。

POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/mysql/instances/logs/lts-configs

{
 "log_configs": [
  {
   "instance_id": "2b1d07d2c9c04d62a95d627c607dbbfein01",
   "log_type": "audit_log",
   "lts_group_id": "8aa6cc4e-847b-48a0-ab26-d0c07c95c7ee",
   "lts_stream_id": "c0be9298-95c5-48d7-af99-b5b2aeebb433"
  }
 ]
}

响应消息

状态码

错误码

请参见错误码

相关文档