Query Alarm Rule

Last updated: 2020-06-05 21:50:38

    Note:

    This is a legacy API which has been hidden and will no longer be updated.

    1. API Description

    This API (DescribeAlarmRuleList) is used to query the list of created alarm rules.

    Domain name: monitor.api.qcloud.com

    2. Input Parameters

    The following request parameter list only provides API request parameters. Common request parameters are also needed when the API is called. The Action field for this API is DescribeAlarmRuleList.

    Parameter Name Required Type Description
    namespace Yes String Namespace. This can be queried by calling the API Query Namespace (DescribeNamespace)
    metricName No string Metric name. All rules under the namespace will be returned if this is left empty. Metric names can be queried by calling the API Query Metric (DescribeMetric)
    offset No Int Offset. Default is 0 (i.e. query result is displayed from the first alarm rule)
    rows No Int Number of rows to be displayed in the result. Default is 30. Starting from offset, this number of alarm rules are displayed

    3. Output Parameters

    Parameter Name Type Description
    code Int Error code, 0: Successful. Other values: Failed. For more information, please see Common Error Codes on the Error Codes page
    message String Error message
    data Array This field exists if there is additional returned information

    "data" field contains:

    Parameter Name Type Description
    ruleList Array Details of the alarm rules
    total Int Number of rules

    "ruleList" field contains:

    Parameter Name Type Description
    alarmRuleId String Alarm rule ID
    namespace String Namespace in which the alarm rule resides
    metricName String Name of the metric in which the alarm ru

    le resides |
    | dimensionGroup | String | Group of dimension names |
    | operatorType | String | Operator |
    | threshold | Int | Threshold |
    | constancy | Int | Number of periods for the alarm to persist |
    | period | Int | Statistical period (in sec) |
    | statistics | String | Statistical method of the alarm rule, which determines how the statistics within specified statistical period shall be taken from a data set. Available analytical methods are: max (to take the maximum value in the data set), min (to take the minimum value in the data set), sum (to take the sum of all data in the data set), avg (to take the average value of all data in the data set), last (to take the last value in the data set) |
    | isWild | Int | Whether the rule is a wildcard rule. A wildcard rule applies to all the objects in the metric name group and cannot be bound to specific objects |
    | receiversId | Int | Receiving group ID for the alarm. "0" means no receiving group is bound with the alarm rule |

    4. Example

    Input

    https://monitor.api.qcloud.com/v2/index.php?Action=DescribeAlarmRuleList
    &<Common request parameters>
    &namespace=cvm
    

    Output

    {
        "code": 0,
        "message": "",
        "data": {
            "ruleList": [
                {
                    "alarmRuleId": "policy-ou3kyu2f",
                    "namespace": "cvm",
                    "metricName": "diskusage",
                    "dimensionGroup": "diskname,ip",
                    "operatorType": ">=",
                    "threshold": "100",
                    "constancy": "4",
                    "period": "300",
                    "statistics": "max",
                    "isWild": "0",
                    "receiversId": "0"
                }
            ],
            "total": "1"
        }
    }

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help