You need to enable JavaScript to run this app.
Application Performance Management Plus

Application Performance Management Plus

Copy page
Download PDF
Battery monitoring
GetAppBatteryFieldValues
Copy page
Download PDF
GetAppBatteryFieldValues
Get the available values for the battery filter criteria.​
Request description​
RUM is deployed across multiple regions worldwide to provide more stable and low-latency access. You can refer to the Service addresses topic to choose the most suitable access point based on your business location.​
  • Request method: POST​
  • Request URL: https://apmplus-openapi.cn-beijing.volcengineapi.com?Action=GetAppBatteryFieldValues&Version=2022-10-12​
Request parameters​
The following table lists only the request parameters specific to this API and some public parameters. For details, see Public parameters.​
​
Parameters​
Type​
Required​
Sample value​
Description​
Action​
String​
Yes​
GetAppBatteryFieldValues​
The API name. The current API name is GetAppBatteryFieldValues.​
Version​
String​
Yes​
2022-10-12​
The API version. The current API version is 2022-10-12.​
start_time​
Integer​
No​
1617225600​
Query start time (Unix timestamp).​
end_time​
Integer​
No​
1617312000​
Query end time (Unix timestamp).​
field​
String​
No​
region​
Name of the field to be aggregated or filtered.​
limit​
Integer​
No​
10​
Limit on the number of records returned.​
filters​
Object of Condition​
No​
-​
The filter condition. You can specify multiple key‑value pairs to filter data.​
metrics​
String​
No​
req_cnt_v2​
Optional metric name.​
keyword​
String​
No​
test​
Fuzzy query keyword​
​
Condition​
​
Parameters​
Type​
Required​
Sample value​
Description​
op​
String​
No​
in​
The operator.​
  • gt: greater than​
  • gte: greater than or equal to​
  • lt: less than​
  • lte: less than or equal to​
  • eq: equal to​
  • neq: not equal to​
  • in: contains​
  • not_in: does not contain​
  • lk: Matches data that fits a specific pattern.​
  • nlk: Excludes data that fits a specific pattern.​
type​
String​
No​
expression​
The type of the filter condition.​
  • expression: The current condition is an expression.​
  • and: The current condition is a compound expression, and multiple sub-conditions are in an AND logical relationship.​
  • or: The current condition is a compound expression, and multiple sub-conditions are in an OR logical relationship.​
  • map: The current condition is of map type.​
value​
String​
No​
123456​
The filter value.​
values​
Array of String​
No​
[123456]​
The filter value. Multiple filter values are supported.​
map_key​
String​
No​
key_1​
The key of the map type. It is required when the type is set to map.​
dimension​
String​
No​
aid​
The name of the condition.​
sub_conditions​
Array of Condition​
No​
-​
The sub-condition.​
​
Sample request​
​
POST https://apmplus-openapi.cn-beijing.volcengineapi.com?Action=GetAppBatteryFieldValues&Version=2022-10-12​
{​
"start_time": 1617225600,​
"end_time": 1617312000,​
"field": "region",​
"limit": 10,​
"filters": {​
"type": "and",​
"sub_conditions": [​
{​
"dimension": "apm_version",​
"type": "expression",​
"op": "in",​
"values": [​
"1.4.5"​
]​
},​
{​
"dimension": "device_model",​
"type": "expression",​
"op": "in",​
"values": [​
"MI 5X"​
]​
}​
]​
},​
"metrics": "req_cnt_v2"​
}
​
Response parameters​
​
Parameters​
Type​
Sample value​
Description​
data​
Array of RangeItem​
-​
Response data.​
error_msg​
String​
-​
Error message.​
error_no​
Integer​
0​
Error code.​
​
RangeItem​
​
Parameters​
Type​
Sample value​
Description​
label​
String​
Label 123​
Tag for filter criteria.​
value​
String​
value123​
Available values for filter criteria.​
​
Sample response​
​
{​
"data": [​
{​
"label": "Label 123",​
"value": "value123"​
}​
],​
"error_msg": "",​
"error_no": 0​
}
​
Error codes​
No error codes are specific to this API. If the API call returns an error code, refer to Public error codes for troubleshooting.​
Last updated: 2026.09.16 17:57:49