文档首页/ 应用性能管理 APM/ API参考(2.0)/ API/ APP监控/ 查询App符号文件列表 - ListRumAppSymbolFile
更新时间:2026-11-20 GMT+08:00
分享

查询App符号文件列表 - ListRumAppSymbolFile

功能介绍

查询App应用已上传的符号文件列表,可按上传任务或应用版本过滤。

调用方法

请参见如何调用API。

授权信息

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

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

POST /v2/rum-app/view/stack/file/{app_id}

表1 路径参数

参数

是否必选

参数类型

描述

app_id

是

String

参数解释:

App应用ID。

约束限制:

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释:

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

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表3 请求Body参数

参数

是否必选

参数类型

描述

task_id

否

Long

参数解释:

上传任务ID,用于查询指定上传任务的文件。

约束限制:

不涉及。

取值范围:

大于0的整数。

默认取值:

不涉及。

app_version

否

String

参数解释:

应用版本,获取堆栈相关符号文件时使用。

约束限制:

original_report非空时必填。

取值范围:

字符串。

默认取值:

不涉及。

cpu_arch

否

String

参数解释:

CPU架构,未上传symbols文件名与此相关。

约束限制:

original_report非空时必填。

取值范围:

字符串。

默认取值:

不涉及。

original_report

否

String

参数解释:

原始堆栈报告,获取堆栈相关符号文件时使用。

约束限制:

original_report非空时,app_version与cpu_arch必填。

取值范围:

字符串。

默认取值:

不涉及。

binary_images

否

Array of RumAppiOSBinaryImage objects

参数解释:

映像文件列表,获取iOS堆栈相关符号文件时使用。

约束限制:

不涉及。

表4 RumAppiOSBinaryImage

参数

是否必选

参数类型

描述

uuid

否

String

参数解释:

映像文件唯一标识。

约束限制:

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

name

否

String

参数解释:

映像文件全路径。

约束限制:

不涉及。

取值范围:

字符串。

默认取值:

不涉及。

cpu_type

否

Long

参数解释:

CPU架构类型。

约束限制:

不涉及。

取值范围:

整数。

默认取值:

不涉及。

cpu_subtype

否

Long

参数解释:

CPU架构子类型。

约束限制:

不涉及。

取值范围:

整数。

默认取值:

不涉及。

image_vmaddr

否

Long

参数解释:

文件中的虚拟内存基址。

约束限制:

不涉及。

取值范围:

整数。

默认取值:

不涉及。

image_addr

否

Long

参数解释:

运行时偏移后的内存基址。

约束限制:

不涉及。

取值范围:

整数。

默认取值:

不涉及。

minor_version

否

Long

参数解释:

次版本号。

约束限制:

不涉及。

取值范围:

整数。

默认取值:

不涉及。

major_version

否

Long

参数解释:

主版本号。

约束限制:

不涉及。

取值范围:

整数。

默认取值:

不涉及。

revision_version

否

Long

参数解释:

修订版本号。

约束限制:

不涉及。

取值范围:

整数。

默认取值:

不涉及。

image_size

否

Long

参数解释:

映像大小。

约束限制:

不涉及。

取值范围:

整数。

默认取值:

不涉及。

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

[数组元素]

Array of RumAppUploadFileModel objects

参数解释:

符号文件列表。

表6 RumAppUploadFileModel

参数

参数类型

描述

gmt_modify

String

参数解释:

修改时间。

取值范围:

不涉及。

object_key

String

参数解释:

OBS对象键。

取值范围:

不涉及。

name

String

参数解释:

文件名。

取值范围:

不涉及。

size

Long

参数解释:

文件大小,单位字节。

取值范围:

不涉及。

version

String

参数解释:

文件对应的应用版本。

取值范围:

不涉及。

uuid

String

参数解释:

文件唯一标识。

取值范围:

不涉及。

status

Integer

参数解释:

文件处理状态。

取值范围:

  • 0:待处理

  • 1:处理中

  • 2:处理成功

  • 3:处理失败

error

String

参数解释:

错误信息,处理失败时返回。

取值范围:

不涉及。

last_modified

Long

参数解释:

最后修改时间戳(毫秒)。

取值范围:

不涉及。

状态码:400

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息。

取值范围:

不涉及。

状态码:403

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码。

取值范围:

不涉及。

error_msg

String

参数解释:

错误信息。

取值范围:

不涉及。

请求示例

/v2/rum-app/view/stack/file/app-xxxxxx

{
  "task_id" : 1
}

响应示例

状态码:200

[ {
  "name" : "mapping.txt",
  "size" : 2624,
  "version" : "1.0",
  "status" : 2,
  "gmt_modify" : "2026-10-25T03:04:42.766+00:00",
  "object_key" : "symbol-files/app-xxxxxx/mapping/1.0/mapping.txt",
  "last_modified" : 1792897482766
} ]

状态码: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

查询符号文件列表成功。

400

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

403

请求被拒绝访问。

错误码

请参见错误码。

相关文档