更新时间:2023-12-25 GMT+08:00

查询LTS日志配置信息

功能介绍

查询实例的LTS配置。

接口约束

  • 只返回GeminiDB Redis数据库实例的慢日志和审计日志配置。

URI

GET https://{Endpoint}/v3/{project_id}/instances/logs/lts-configs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

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

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

索引位置偏移量,表示从第一条数据偏移offset条数据后开始查询。取值必须为数字,不能为负数。默认取0值,表示从第一条数据开始查询。

limit

Integer

返回的最大记录数量。取值范围:1~100,必须为整数。不传该参数时,默认查询100条实例信息。

instance_id

String

根据实例ID精确搜索。

instance_name

String

根据实例名称模糊搜索。

enterprise_project_id

String

根据企业项目ID精确搜索。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

X-Language

String

语言。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

total_count

Integer

实例总记录数。

instance_lts_configs

Array of objects

实例的LTS日志配置信息列表。详情请参考表5

表5 InstanceLogConfig

参数

参数类型

描述

instance

object

实例信息。详情请参考表6

lts_configs

Array of objects

LTS日志配置明细。若未设置LTS日志流,不返回该字段。详情请参考表8

表6 LogInstanceInfo

参数

参数类型

描述

id

String

实例ID。

name

String

实例名称。

status

String

实例状态。取值:

  • normal,表示实例正常。
  • abnormal,表示实例异常。
  • creating,表示实例创建中。
  • frozen,表示实例被冻结。
  • data_disk_full,表示实例磁盘已满。
  • createfail,表示实例创建失败。
  • enlargefail,表示实例扩容节点失败。

mode

String

实例类型。

  • 取值为“Cluster”,表示GeminiDB Redis集群实例类型。

datastore

object

数据库信息。详情请参考表7

actions

Array of strings

实例正在执行的动作。

enterprise_project_id

String

企业项目ID。

supported_log_types

Array of strings

支持的日志类型。取值:

slow_log,表示慢日志。

audit_log,表示审计日志。

表7 InstancesDatastoreResult

参数

参数类型

描述

type

String

数据库接口

version

String

数据库版本号。

表8 InstanceLogConfigDetail

参数

参数类型

描述

log_type

String

日志类型。取值:

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

lts_group_id

String

关联的LTS日志组ID,若enabled为false,表示最近一次关联的LTS日志组ID。

lts_stream_id

String

关联的LTS日志流ID,若enabled为false,表示最近一次关联的LTS日志流ID。

enabled

Boolean

关联的LTS日志流是否启用,true代表已启用,false代表未启用。

请求示例

GET https://{Endpoint}/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/logs/lts-configs?limit=10&offset=0&instance_id=362b42f769ff45d884e1866f8ee00bb4in12&instance_name=c316&enterprise_project_id=0

响应示例

状态码: 200

Success

{ 
  "total_count" : 1, 
  "instance_lts_configs" : [ { 
    "instance" : { 
      "id" : "362b42f769ff45d884e1866f8ee00bb4in12", 
      "name" : "nosql-c316", 
      "mode" : "RedisCluster", 
      "datastore" : { 
        "version" : "5.0", 
        "type" : "redis" 
      }, 
      "status" : "normal", 
      "actions" : [ "GROWING" ], 
      "enterprise_project_id" : "0", 
      "supported_log_types" : [ "slow_log", "audit_log" ]
    }, 
    "lts_configs" : [ { 
      "log_type" : "slow_log", 
      "lts_group_id" : "65442dd4-b8de-4e9f-8a80-b60aa0698354", 
      "lts_stream_id" : "5992dd29-fd11-4228-a852-5f6e578789c5", 
      "enabled" : true 
    } ] 
  } ] 
}

状态码

请参见状态码

错误码

请参见错误码