文档首页/ 云数据库 GeminiDB/ API参考/ API v3（推荐）/ 日志管理/ 关联LTS日志流 - AssociatingInstanceswithanLTSLogStream
更新时间：2026-04-25 GMT+08:00
查看PDF
分享

关联LTS日志流 - AssociatingInstanceswithanLTSLogStream

功能介绍

  • 将实例日志与LTS日志流关联，后台将自动上传实例日志到关联的LTS日志流里。
  • 关联成功后，会产生一定费用，具体计费可参考云日志服务（LTS）的定价详情。
  • 系统会为当前选择的日志流创建对应日志类型的结构化配置，若该日志流已存在其他日志类型的结构化配置，系统会进行覆盖。

接口约束

  • 该接口支持如下数据库实例的慢日志配置：

    • GeminiDB Redis。
  • 该接口支持如下数据库实例的审计日志配置：
    • GeminiDB Redis经典部署模式Proxy集群版
    • GeminiDB Redis经典部署模式主备版
    • GeminiDB Redis云原生部署模式
    • GeminiDB兼容DynamoDB
    • GeminiDB Mongo
  • 部分低版本的实例需要升级内核小版本以支持审计日志配置功能。
  • 创建中、已删除、冻结状态的实例不支持该操作。
  • 单批最多支持100个实例关联LTS日志流。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    gaussdbfornosql:instance:setLogConfigs

    Write

    -

    -

    nosql:instances:saveLtsStreams

    -

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

X-Language

否

String

参数解释：

语言。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表3 请求Body参数

参数

是否必选

参数类型

描述

instance_ids

是

Array of strings

参数解释：

需要建立关联的实例ID列表。

约束限制：

实例ID列表中所有实例的数据库类型应保持一致。

取值范围：

不涉及。

默认取值：

不涉及。

log_type

是

String

参数解释：

日志类型。

约束限制：

不涉及。

取值范围：

  • slow_log：表示慢日志。
  • audit_log：表示审计日志。

默认取值：

不涉及。

lts_group_id

是

String

参数解释：

LTS日志组ID。可通过云日志服务-“查询账号下所有日志组”API接口获取。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

lts_stream_id

是

String

参数解释：

LTS日志流ID。可通过云日志服务-“查询指定日志组下的所有日志流”API接口获取。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：200

无响应参数。

请求示例

  • URI样例 
    POST https://{Endpoint}/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/logs/lts-configs
  • 慢日志关联LTS日志流 
    { 
  "instance_ids" : [ "fe45815ce8a6413ab7fa290da1db1614in12", "362b42f769ff45d884e1866f8ee00bb4in12" ], 
  "log_type" : "slow_log", 
  "lts_group_id" : "65442dd4-b8de-4e9f-8a80-b60aa0698354", 
  "lts_stream_id" : "5992dd29-fd11-4228-a852-5f6e578789c5" 
}
  • 审计日志关联LTS日志流 
    { 
  "instance_ids" : [ "fe45815ce8a6413ab7fa290da1db1614in12", "362b42f769ff45d884e1866f8ee00bb4in12" ], 
  "log_type" : "audit_log", 
  "lts_group_id" : "65442dd4-b8de-4e9f-8a80-b60aa0698354", 
  "lts_stream_id" : "5992dd29-fd11-4228-a852-5f6e578789c5" 
}

响应示例

状态码： 200

Success

{}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 日志管理

相关文档