应用列表-名称
更新时间：2026-06-26
DescribeServicesNames
查询应用名称列表（两阶段查询的第一阶段），返回应用名称、ID、语言等基本信息。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v1/apm/query?action=DescribeServicesNames HTTP/1.1
2Host: apm.bj.baidubce.com
3Authorization: authorization string
4
5{
6 "beginDatetime": "2024-12-23T01:57:10Z",
7 "endDatetime": "2024-12-23T01:57:10Z",
8 "serviceName": "",
9 "serviceId": "",
10 "language": "",
11 "env": "",
12 "source": "APP_BUILDER",
13 "tag": {
14 "key": "env",
15 "value": "sandbox"
16 },
17 "orderBy": "requests",
18 "order": "desc",
19 "metricFilters": [
20 {"key": "version", "op": "!=", "value": "draft"}
21 ]
22}请求头域
除公共头域外，无其他特殊头域
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为v1 |
| beginDatetime | String | 是 | RequestBody参数 | 开始时间，格式为ISO 8601 |
| endDatetime | String | 是 | RequestBody参数 | 结束时间，格式为ISO 8601 |
| serviceName | String | 否 | RequestBody参数 | 按应用名过滤，若未设置，返回所有应用 |
| serviceId | String | 否 | RequestBody参数 | 按应用ID过滤 |
| language | String | 否 | RequestBody参数 | 按语言过滤，若未设置，返回所有语言 |
| env | String | 否 | RequestBody参数 | 按env过滤，若未设置，返回所有env的应用 |
| source | String | 否 | RequestBody参数 | 按应用来源过滤，可选项：APP_BUILDER（千帆AppBuilder） |
| tag | Tag | 否 | RequestBody参数 | 按tag筛选，单选。key="@@@"表示无标签；key="@@@"且value="@@@"表示全部标签；key="abc"且value="@@@"表示所有key为abc的资源 |
| orderBy | String | 是 | RequestBody参数 | 排序字段，可选项：requests、requestsPerSecond、errors、errorRate、durationSeconds、abSuccessRate、abErrorRate、abRequests、abDurationSeconds、llmErrorRate、llmTokens |
| order | String | 是 | RequestBody参数 | 排序方式，可选项：desc、asc |
| metricFilters | List<MetricFilter> | 否 | RequestBody参数 | 指标过滤条件 |
返回状态码
成功返回200，失败返回见错误码
返回头域
除公共头域外，无其他特殊头域
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 请求是否成功 |
| code | String | 状态码 |
| message | String | 错误信息 |
| services | List<ServiceName> | 应用列表 |
请求示例
Plain Text
1POST /v1/apm/query?action=DescribeServicesNames HTTP/1.1
2HOST apm.bj.baidubce.com
3Authorization bce-auth-v1/...
4
5{
6 "beginDatetime": "2024-12-23T01:57:10Z",
7 "endDatetime": "2024-12-23T01:57:10Z",
8 "serviceName": "",
9 "orderBy": "requests",
10 "order": "desc"
11}响应示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: request-id-example
3Date: Wed, 08 Jan 2025 03:25:48 GMT
4Transfer-Encoding: chunked
5Content-Type: application/json;charset=UTF-8
6Server: BWS
7
8{
9 "success": true,
10 "code": "OK",
11 "message": "",
12 "services": [
13 {
14 "serviceName": "mall-gateway",
15 "serviceId": "s-ddb54dc9e3",
16 "serviceDisplayName": "",
17 "language": "java",
18 "includeLLM": false
19 }
20 ]
21}评价此篇文章