# 查询LTS日志配置信息-QueryingLTSLogConfigurations #### 接口说明 查询LTS日志配置信息。 #### 约束说明 当前只支持审计日志。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/DDS/doc?api=ListLtsConfigs)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dds/dds_api_permission.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | dds:instance:listAll | list | - | - | dds:instance:list | - | #### URI - URI格式 GET /v3/{project_id}/instances/logs/lts-configs - URI样例 https://dds.ap-southeast-1.myhuaweicloud.com/v3/619d3e78f61b4be68bc5aa0b59edcf7b/instances/logs/lts-configs?offset=0\&limit=10 表1请求参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释：** 从IAM服务获取的用户Token。请参考[认证鉴权](https://support.huaweicloud.com/api-dds/dds_api_0010.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | project_id | 是 | String | **参数解释：** 租户在某一Region下的项目ID。请参考[获取项目ID](https://support.huaweicloud.com/api-dds/dds_projectid.html)章节获取项目编号。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | offset | 否 | Integer | **参数解释：** 索引位置，偏移量。 **约束限制：** 必须为整数数字。 **取值范围：** \>=0。 **默认取值：** 0。偏移0条数据，表示从第一条数据开始查询。 | | limit | 否 | Integer | **参数解释：** 查询记录数。 **约束限制：** 正整数。 **取值范围：** 1\~50。 **默认取值：** 50。 | #### 请求消息 - 参数说明 无。 - 请求示例 无。 #### 响应消息 - 参数说明 表3响应Body参数 | 参数 | 参数类型 | 说明 | |:---|:---|:---| | instance_lts_configs | Array of [表4] objects | **参数解释：** 每个实例的LTS日志配置信息和实例简要信息。 **取值范围：** 不涉及。 | | total_count | Integer | **参数解释：** 全部可查询的云服务日志配置结果个数，等于所有DDS实例的个数。 **取值范围：** \>=0。 | 表4instance_lts_configs | 参数 | 参数类型 | 说明 | |:---|:---|:---| | instance | [表5] object | **参数解释：** 实例的简要信息。 **取值范围：** 不涉及。 | | lts_configs | Array of [表 lts_configs] objects | **参数解释：** LTS日志配置明细。从未设置LTS日志流，不返回该字段。 **取值范围：** 不涉及。 | 表5instance | 参数 | 参数类型 | 说明 | |:---|:---|:---| | id | String | **参数解释：** 实例ID。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 实例名字。 **取值范围：** 不涉及。 | | mode | String | **参数解释：** 实例类型，对应单节点，副本集，集群三种。 **取值范围：** - Single - Replica - Sharding | | datastore | [表6] object | **参数解释：** 实例的数据库引擎和版本。 **取值范围：** 不涉及。 | | status | String | **参数解释：** 实例状态。 **取值范围：** 不涉及。 | | enterprise_project_id | String | **参数解释：** 实例归属的企业项目ID。 **取值范围：** 如果是default企业项目，值为0，如果是其他企业项目，请参考企业项目相关内容。 | | actions | Array of strings | **参数解释：** 实例所有正在执行的动作。 **取值范围：** 不涉及。 | 表6datastore | 参数 | 参数类型 | 说明 | |:---|:---|:---| | type | String | **参数解释：** 数据库引擎。 **取值范围：** - mongodb | | version | String | **参数解释：** 数据库大版本。 **取值范围：** 不涉及。 | 表7lts_configs | 参数 | 参数类型 | 说明 | |:---|:---|:---| | log_type | String | **参数解释：** LTS日志类型，不能为空。 **取值范围：** - audit_log | | lts_group_id | String | **参数解释：** 云日志服务LTS日志组ID。 **取值范围：** 不涉及。 | | lts_stream_id | String | **参数解释：** 云日志服务LTS日志流ID。 **取值范围：** 不涉及。 | | enabled | Boolean | **参数解释：** 是否上传。 **取值范围：** - true - false | - 响应示例 ``` { "total_count" : 1, "instance_lts_configs" : [ { "instance" : { "id" : "520c58ba00a3497e97ce0b9604874dd6in02", "name" : "dds-1f84", "mode" : "Single", "datastore" : { "type" : "mongodb", "version" : 4.0 }, "status" : "normal", "enterprise_project_id" : "0", "actions" : [ "OPS_AUDIT_LOG" ] }, "lts_configs" : [ { "log_type" : "audit_log", "lts_group_id" : "ec6dc499-1a63-4229-a0c2-a2afa8bcfc95", "lts_stream_id" : "cae69d2e-378b-41dd-b3c9-3ca1cd5335bc", "enabled" : true } ] } ] } ``` #### 状态码 详情请参见[状态码](https://support.huaweicloud.com/api-dds/dds_status_code.html)。 #### 错误码 详情请参见[错误码](https://support.huaweicloud.com/api-dds/dds_error_code.html)。