# 查询单个RUM实例 - ShowRumInstance #### 功能介绍 根据应用ID查询单个RUM实例详情。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-apm/apm_04_0007.html)。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-apm/apm_04_0021.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | apm：application：getService | Read | - | g：EnterpriseProjectId | apm：apm2Service：get | - | #### URI GET /v2/rum/apps/get-rum-instance/{app_id} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | app_id | 是 | String | **参数解释**： RUM应用ID。 **约束限制**： 不涉及。 **取值范围**： 字符串。 **默认取值**： 不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | get_sdk_configs | 否 | Boolean | **参数解释**： 是否获取SDK配置信息。 **约束限制**： 不涉及。 **取值范围**： - true：获取SDK配置信息。 - false：不获取SDK配置信息。 **默认取值**： false。 | #### 请求参数 表3请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 是 | String | **参数解释**： 从IAM服务获取的用户Token。获取方式请参见：[获取Token](https://support.huaweicloud.com/api-apm/apm_api_0010.html)。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | #### 响应参数 **状态码：200** 表4响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | rum_instance | [RumInstanceInfoParam] object | **参数解释**： RIM实例信息。 | | status | String | **参数解释**： 实例状态。 **取值范围**： 不涉及。 | 表5RumInstanceInfoParam | 参数 | 参数类型 | 描述 | |:---|:---|:---| | app_id | String | **参数解释**： 应用ID。 **取值范围**： 不涉及。 | | app_name | String | **参数解释**： 应用名称。 **取值范围**： 不涉及。 | | enable | Boolean | **参数解释**： 是否启用。 **取值范围**： 不涉及。 | | business_info | Object | **参数解释**： 业务信息。 **取值范围**： 不涉及。 | | sdk_configs | [RumSdkConfigs] object | **参数解释**： RUM实例的SDK配置信息。 | | uv | Integer | **参数解释**： UV数。 **取值范围**： 不涉及。 | | pv | Integer | **参数解释**： PV数。 **取值范围**： 不涉及。 | | avg_load_time | Double | **参数解释**： 平均加载时间。 **取值范围**： 不涉及。 | | js_error_rate | Double | **参数解释**： JS错误率。 **取值范围**： 不涉及。 | | api_success_rate | Double | **参数解释**： API成功率。 **取值范围**： 不涉及。 | | env_id | Long | **参数解释**： 环境ID。 **取值范围**： 不涉及。 | | region | String | **参数解释**： 区域。 **取值范围**： 不涉及。 | | app_type | String | **参数解释**： 应用类型。 **取值范围**： 不涉及。 | | status | String | **参数解释**： 状态。 **取值范围**： 不涉及。 | | rtt_limit | String | **参数解释**： RTT限制。 **取值范围**： 不涉及。 | | transfer_limit | String | **参数解释**： 传输限制。 **取值范围**： 不涉及。 | 表6RumSdkConfigs | 参数 | 参数类型 | 描述 | |:---|:---|:---| | hotspot_auto_report | String | **参数解释**： 热点自动上报。 **取值范围**： 字符串。 | | consistency_auto_report | String | **参数解释**： 一致性自动上报。 **取值范围**： 字符串。 | | api_auto_report | String | **参数解释**： API自动上报。 **取值范围**： 字符串。 | | third_party_api_auto_report | String | **参数解释**： 第三方API自动上报。 **取值范围**： 字符串。 | | hash_mode_auto_parse | String | **参数解释**： Hash模式自动解析。 **取值范围**： 字符串。 | | js_error_trace | String | **参数解释**： JS错误追踪。 **取值范围**： 字符串。 | | js_error_auto_clean | String | **参数解释**： JS错误自动清理。 **取值范围**： 字符串。 | | page_resource_report | String | **参数解释**： 页面资源上报。 **取值范围**： 字符串。 | | user_behavior_trace | String | **参数解释**： 用户行为追踪。 **取值范围**： 字符串。 | | page_long_task_trace | String | **参数解释**： 页面长任务追踪。 **取值范围**： 字符串。 | | trace_report | String | **参数解释**： Trace上报。 **取值范围**： 字符串。 | | rtt_limit | Integer | **参数解释**： RTT限制。 **取值范围**： 大于0的整数。 | | transfer_limit | Integer | **参数解释**： 传输限制。 **取值范围**： 大于0的整数。 | **状态码：400** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。 **取值范围**： 不涉及。 | | error_msg | String | **参数解释**： 错误信息。 **取值范围**： 不涉及。 | **状态码：403** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。 **取值范围**： 不涉及。 | | error_msg | String | **参数解释**： 错误信息。 **取值范围**： 不涉及。 | **状态码：429** 表9响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。 **取值范围**： 不涉及。 | | error_msg | String | **参数解释**： 错误信息。 **取值范围**： 不涉及。 | #### 请求示例 ``` /v2/rum/apps/get-rum-instance?start_timestamp=1783909950386&end_timestamp=1783910550386 ``` #### 响应示例 **状态码：200** 请求响应成功，获取RUM实例信息。 ``` { "status" ： "success", "rum_instance" ： { "app_id" ： "238bf646xxxxxxx665ac85e", "app_name" ： "rum-app", "enable" ： false, "business_info" ： { "default" ： true, "id" ： 108903, "is_default" ： true, "display_name" ： "APM", "inner_domain_id" ： 2, "name" ： "LubanApm", "eps_id" ： "0", "cmdb_datasource_type" ： "APM", "uuid" ： "6797f688xxxxxxxxxe5b54b5db64e" }, "sdk_configs" ： { "hotspot_auto_report" ： "true", "consistency_auto_report" ： "true", "api_auto_report" ： "true", "third_party_api_auto_report" ： "true", "hash_mode_auto_parse" ： "true", "js_error_trace" ： "true", "js_error_auto_clean" ： "true", "page_resource_report" ： "true" } } } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 403 | Forbidden | | 429 | Too Many Requests | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-apm/ErrorCode.html)。