Querying BCS Alarm Statistics
Function
This API is used to query the alarm statistics of a specified metric of a BCS service.
URI
POST /v2/{project_id}/blockchains/{blockchain_id}/events/statistic
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
project_id |
Yes |
String |
Project ID obtained from IAM. Generally, a project ID contains 32 characters. |
blockchain_id |
Yes |
String |
BCS service ID. |
Request Parameters
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
X-Auth-Token |
Yes |
String |
User token. You can obtain the token by calling the IAM API used to obtain a user token. |
Parameter |
Mandatory |
Type |
Description |
---|---|---|---|
time_range |
No |
String |
Value range of metrics. |
metric_names |
No |
Array of strings |
Metrics. Value range: cpuUsage: CPU usage** diskUsedRate**: disk usage memUsedRate: physical memory usage sendBytesRate: uplink rate (byte/s) recvBytesRate: downlink rate (byte/s) cpuCoreLimit: total CPU cores cpuCoreUsed: used CPU cores totalMem: total physical memory freeMem: available physical memory diskCapacity: disk capacity diskAvailableCapacity: available disk space Default value: the first five metrics. |
Response Parameters
Status code: 200
Parameter |
Type |
Description |
---|---|---|
metrics |
Array of MetricItemResultAPI objects |
Request result. |
Parameter |
Type |
Description |
---|---|---|
metric |
MetricDemision object |
Operation record ID. |
dataPoints |
Array of MetricDataPoints objects |
Basic information of the monitoring data. |
Parameter |
Type |
Description |
---|---|---|
namespace |
String |
Namespace. |
metricName |
String |
Metric name. |
dimensions |
Array of Dimension objects |
Dimension list. |
Parameter |
Type |
Description |
---|---|---|
name |
String |
Dimension name. |
value |
String |
Dimension value. |
Parameter |
Type |
Description |
---|---|---|
timestamp |
Long |
Timestamp. |
unit |
String |
Metric unit. |
statistics |
Array of StatisticValue objects |
Statistical method. |
Parameter |
Type |
Description |
---|---|---|
statistic |
String |
Statistical method. |
value |
Double |
Statistics. |
Status code: 400
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Error code. Minimum: 8 Maximum: 36 |
error_msg |
String |
Error message. Minimum: 2 Maximum: 512 |
Status code: 401
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Error code. Minimum: 8 Maximum: 36 |
error_msg |
String |
Error message. Minimum: 2 Maximum: 512 |
Status code: 403
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Error code. Minimum: 8 Maximum: 36 |
error_msg |
String |
Error message. Minimum: 2 Maximum: 512 |
Status code: 404
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Error code. Minimum: 8 Maximum: 36 |
error_msg |
String |
Error message. Minimum: 2 Maximum: 512 |
Status code: 500
Parameter |
Type |
Description |
---|---|---|
error_code |
String |
Error code. Minimum: 8 Maximum: 36 |
error_msg |
String |
Error message. Minimum: 2 Maximum: 512 |
Example Requests
{ "metric_names" : [ "cpuUsage", "diskUsedRate" ] }
Example Responses
Status code: 200
Ok
{ "metrics" : [ { "metric" : { "namespace" : "abc", "metricName" : "def", "dimensions" : [ { "name" : "ghi", "value" : "lmn" } ] }, "dataPoints" : [ { "timestamp" : "1467892800000", "unit" : "Percent", "statistics" : [ { "statistic" : "maximum", "value" : "23" } ] } ] } ] }
Status code: 400
Bad Request
{ "error_code" : "BCS.4001108", "error_msg" : "metric names is wrong" }
Status code: 401
Unauthorized
{ "error_code" : "BCS.4010401", "error_msg" : "Incorrect token or token resolution failed" }
Status code: 403
Forbidden
{ "error_code" : "BCS.4030403", "error_msg" : "No permissions to request this method" }
Status code: 404
Not Found
{ "error_code" : "BCS.4040404", "error_msg" : "Not Found:the url is not found" }
Status code: 500
InternalServerError
{ "error_code" : "BCS.5000500", "error_msg" : "Internal Server Error" }
Status Codes
Status Code |
Description |
---|---|
200 |
Ok |
400 |
Bad Request |
401 |
Unauthorized |
403 |
Forbidden |
404 |
Not Found |
500 |
InternalServerError |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot