Querying a Threshold Rule

Function

This API is used to query a threshold rule.

Calling Method

For details, see Calling APIs.

URI

GET /v2/{project_id}/alarm-rules/{alarm_rule_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID, which can be obtained from the console or by calling an API. For details, see Obtaining a Project ID.
alarm_rule_id	Yes	String	Threshold rule ID.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	User token obtained from IAM. For details, see Obtaining a Token.
Content-Type	No	String	Message body type or format. Content type, which is application/json. Enumeration values: application/json

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
meta_data	MetaData object	Metadata, including pagination information.
thresholds	Array of QueryAlarmResult objects	Threshold rule list.

**Table 4** MetaData
Parameter	Type	Description
count	Integer	Number of returned records.
start	String	Start of the next page, which is used for pagination. null: No more data.
total	Integer	Total number of records.

**Table 5** QueryAlarmResult
Parameter	Type	Description
action_enabled	Boolean	Whether to enable notification.
alarm_actions	Array of strings	List of alarm notifications.
alarm_advice	String	Alarm clearance suggestion.
alarm_description	String	Threshold rule description.
alarm_level	String	Alarm severity.
alarm_rule_id	String	Threshold rule ID.
alarm_rule_name	String	Threshold rule name.
comparison_operator	String	Comparison operator.
dimensions	Array of Dimension objects	List of time series dimensions. To query the time series dimension list, call the API Querying Time Series Objects.
evaluation_periods	Integer	Interval.
id_turn_on	Boolean	Whether to enable the threshold rule.
insufficient_data_actions	Array of strings	List of insufficient data notifications.
metric_name	String	Time series name.
namespace	String	Time series objects' namespace.
ok_actions	Array of strings	List of normal status notifications.
period	Integer	Statistical period.
policy_name	String	Threshold rule name.
resources	Array of strings	Resource information (discarded).
state_reason	String	Cause description.
state_updated_timestamp	String	Time when the status was updated.
state_value	String	Service status.
statistic	String	Statistic.
threshold	String	Threshold value.
type	String	Threshold rule type.
unit	String	Threshold unit.

**Table 6** Dimension
Parameter	Type	Description
name	String	Dimension name.
value	String	Dimension value.

Status code: 400

**Table 7** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.
error_type	String	Error type.
trace_id	String	Trace ID, which is used to search for logs and locate faults. If 2xx is returned, trace_id is empty. If 4xx, trace_id is not empty.

Example Requests

Obtain the details about the alarm rule whose ID is alarm_rule_id.

https://{Endpoint}/v2/{project_id}/alarm-rules/{alarm_rule_id}

Example Responses

Status code: 200

OK: The request is successful.

{
  "meta_data" : {
    "count" : 1,
    "start" : null,
    "total" : 1
  },
  "thresholds" : [ {
    "action_enabled" : false,
    "alarm_actions" : null,
    "alarm_advice" : null,
    "alarm_description" : null,
    "alarm_level" : "3",
    "alarm_rule_id" : 2137,
    "alarm_rule_name" : "aom_rule",
    "comparison_operator" : ">=",
    "dimensions" : [ {
      "name" : "appName"
    }, {
      "value" : "rhm-broker"
    } ],
    "evaluation_periods" : 1,
    "id_turn_on" : true,
    "insufficient_data_actions" : null,
    "metric_name" : "cpuCoreLimit",
    "namespace" : "PAAS.CONTAINER",
    "ok_actions" : null,
    "period" : 60000,
    "policy_name" : "23,",
    "resources" : [ ],
    "state_reason" : null,
    "state_updated_timestamp" : null,
    "statistic" : "average",
    "threshold" : 0,
    "type" : "single,",
    "unit" : "Core"
  } ]
}

Status code: 400

Bad Request: The request is invalid. The client should not repeat the request without modifications.

{
  "error_code" : "AOM.02004115",
  "error_msg" : "Invalid request parameter",
  "error_type" : "BAD_REQUEST",
  "trace_id" : ""
}

Status Codes

Status Code	Description
200	OK: The request is successful.
400	Bad Request: The request is invalid. The client should not repeat the request without modifications.
401	Unauthorized: The authentication information is incorrect or invalid.
403	Forbidden: The request is rejected. The server has received the request and understood it, but the server refuses to respond to it. The client should not repeat the request without modifications.
500	Internal Server Error: The server is able to receive the request but unable to understand the request.
503	Service Unavailable: The requested service is invalid. The client should not repeat the request without modifications.