文档首页/ 应用性能管理 APM/ API参考(2.0)/ API/ 服务公共接口/ 查询LTS映射关系 - ListLtsMappings
更新时间:2026-11-20 GMT+08:00
分享

查询LTS映射关系 - ListLtsMappings

功能介绍

根据环境ID查询LTS(云日志服务)与环境的映射关系及监控项采集配置。

调用方法

请参见如何调用API。

授权信息

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

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

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    apm:application:get

    Read

    -

    -

    apm:apm2BusinessBusiness:get

    -

URI

GET /v2/lts-mapping/list-mappings

表1 Query参数

参数

是否必选

参数类型

描述

env_id

是

Long

参数解释:

环境ID。

约束限制:

不涉及。

取值范围:

大于0的整数。

默认取值:

不涉及。

agent_type

否

String

参数解释:

探针类型。

约束限制:

不涉及。

取值范围:

  • JAVAAGENT:表示Java探针。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

从IAM服务获取的用户Token。获取方式请参见:获取Token。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

x-business-id

是

Long

参数解释:

业务ID。

约束限制:

不涉及。

取值范围:

大于0的整数。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

env_id

Long

参数解释:

环境ID。

取值范围:

不涉及。

project_id

String

参数解释:

项目ID。

取值范围:

不涉及。

log_group_id

String

参数解释:

日志组ID。

取值范围:

不涉及。

log_stream_id

String

参数解释:

日志流ID。

取值范围:

不涉及。

monitor_item

SaveMonitorItemParam object

参数解释:

监控项采集配置。

表4 SaveMonitorItemParam

参数

参数类型

描述

interval

Integer

参数解释:

采集间隔。

取值范围:

不涉及。

monitor_item_id

Long

参数解释:

监控项ID。

取值范围:

不涉及。

env_id

Long

参数解释:

环境ID。

取值范围:

不涉及。

config_value_list

Array of ConfigItem objects

参数解释:

采集配置项列表。

表5 ConfigItem

参数

参数类型

描述

config_name

String

参数解释:

配置项名称。

取值范围:

不涉及。

should_override

Boolean

参数解释:

是否覆盖环境标签配置。

取值范围:

  • true:覆盖。

  • false:不覆盖。

config_value

String

参数解释:

配置项值。

取值范围:

不涉及。

状态码:400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息。

取值范围:

不涉及。

状态码:403

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息。

取值范围:

不涉及。

请求示例

/v2/lts-mapping/list-mappings?env_id=1&agent_type=JAVAAGENT

响应示例

状态码:200

{
  "env_id" : 1,
  "project_id" : "037bcxxxxxxxxxa3275da",
  "log_group_id" : "xxxxxx",
  "log_stream_id" : "xxxxxx",
  "monitor_item" : {
    "env_id" : 1,
    "interval" : 10,
    "monitor_item_id" : 10499,
    "config_value_list" : [ {
      "config_name" : "traceId",
      "config_value" : "true",
      "should_override" : true
    } ]
  }
}

状态码:400

"\"\\\"\\\\\\\"{\\\\\\\\n  \\\\\\\\\\\\\\\"error_code\\\\\\\\\\\\\\\": \\\\\\\\\\\\\\\"apm2.00000005\\\\\\\\\\\\\\\",\\\\\\\\n  \\\\\\\\\\\\\\\"error_msg\\\\\\\\\\\\\\\": \\\\\\\\\\\\\\\"invalid parameter\\\\\\\\\\\\\\\"\\\\\\\\n}\\\\\\\"\\\"\""

状态码:403

"\"\\\"\\\\\\\"{\\\\\\\\n  \\\\\\\\\\\\\\\"error_code\\\\\\\\\\\\\\\": \\\\\\\\\\\\\\\"apm2.00000004\\\\\\\\\\\\\\\",\\\\\\\\n  \\\\\\\\\\\\\\\"error_msg\\\\\\\\\\\\\\\": \\\\\\\\\\\\\\\"has no privilege\\\\\\\\\\\\\\\"\\\\\\\\n}\\\\\\\"\\\"\""

状态码

状态码

描述

200

查询LTS映射关系成功。

400

非法请求,建议根据error_msg检查修改该请求。

403

请求被拒绝访问。

错误码

请参见错误码。

相关文档