更新时间：2026-08-19 GMT+08:00

查询UV概览指标 - ShowRumViewMetricOverviewUv

功能介绍

查询指定应用的UV概览指标数据。

调用方法

请参见如何调用API。

授权信息

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

如果使用角色与策略授权，具体权限要求请参见权限和授权项。

如果使用身份策略授权，需具备如下身份策略权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
apm：application：getService	Read	-	g：EnterpriseProjectId	apm：apm2Service：get	-

URI

POST /v2/rum/view/metric/overview/uv/{app_id}

表1 路径参数
参数	是否必选	参数类型	描述
app_id	是	String	参数解释： RUM应用ID。约束限制：不涉及。取值范围：字符串。默认取值：不涉及。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：从IAM服务获取的用户Token。获取方式请参见：获取Token。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

表3 请求Body参数
参数	是否必选	参数类型	描述
start_timestamp	是	String	参数解释：查询开始时间戳。约束限制：不涉及。取值范围：字符串。默认取值：不涉及。
end_timestamp	是	String	参数解释：查询结束时间戳。约束限制：不涉及。取值范围：字符串。默认取值：不涉及。
search_list	是	Array of Map<String,String> objects	参数解释：搜索条件列表，键值对形式。约束限制：不涉及。

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
uv	Integer	参数解释： UV数。取值范围：不涉及。

状态码：400

表5 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：不涉及。
error_msg	String	参数解释：错误信息。取值范围：不涉及。

状态码：403

表6 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：不涉及。
error_msg	String	参数解释：错误信息。取值范围：不涉及。

状态码：429

表7 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码。取值范围：不涉及。
error_msg	String	参数解释：错误信息。取值范围：不涉及。

请求示例

v2/rum/view/metric/overview/uv/f5fc3dd8738342b48000000000024ad8

{
  "start_timestamp" ： "1783517898501",
  "end_timestamp" ： "1783604298501",
  "search_list" ： [ {
    "isp" ： "华为"
  }, {
    "area" ： "宁波市"
  }, {
    "brt" ： "Chrome"
  }, {
    "os" ： "Mac"
  } ]
}

响应示例

状态码：200

获得UV概览指标数据成功。

{
  "uv" ： 10
}

状态码

状态码	描述
200	OK
400	Bad Request
403	Forbidden
429	Too Many Requests

错误码

请参见错误码。

父主题： 前端监控