All Products
Search
Document Center

CloudMonitor:PutCustomEventRule

Last Updated:Mar 01, 2024

Operation description

Before you call this operation, call the PutCustomEvent operation to report the monitoring data of the custom event. For more information, see PutCustomEvent .

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
GroupIdstringYes

The ID of the application group. For more information about how to obtain the group ID, see DescribeCustomEventAttribute .

Note The value 0 indicates that the reported custom event does not belong to any application Group.
7378****
RuleIdstringYes

The ID of the alert rule.

Note You can specify an existing ID to modify the corresponding alert rule or specify a new ID to create an alert rule.
CustomRuleId1
RuleNamestringYes

The name of the alert rule.

CustomeRule
EventNamestringYes

The name of the custom event. For more information about how to obtain the event name, see DescribeCustomEventAttribute .

HostDown
ContactGroupsstringYes

The alert contact group that receives alert notifications. Separate multiple contact groups with commas (,).

ECS_Group
WebhookstringNo

The callback URL to which a POST request is sent when an alert is triggered based on the alert rule.

https://www.aliyun.com
EffectiveIntervalstringNo

The time period during which the alert rule is effective. Valid values: 00:00 to 23:59.

00:00-23:59
PeriodstringNo

The cycle that is used to aggregate monitoring data of the custom event. Unit: seconds. Set the value to an integral multiple of 60. Default value: 300.

60
EmailSubjectstringNo

The subject of the alert notification email.

ThresholdstringYes

The alert threshold.

99
LevelstringYes

The level of the alert. Valid values:

  • CRITICAL: critical issue
  • WARN: warning
  • INFO: information
CRITICAL

Response parameters

ParameterTypeDescriptionExample
object
Codestring

The HTTP status code.

Note The value 200 indicates that the call was successful.
200
Messagestring

The error message.

The request has failed due to a temporary failure of the server.
RequestIdstring

The ID of the request.

AD5DCD82-BD1C-405F-BAED-32302DE9F498
Successboolean

Indicates whether the call was successful. Valid values:

  • true: The call was successful.
  • false: The call failed.
true

Examples

Sample success responses

JSONformat

{
  "Code": "200",
  "Message": "The request has failed due to a temporary failure of the server.",
  "RequestId": "AD5DCD82-BD1C-405F-BAED-32302DE9F498",
  "Success": true
}

Error codes

HTTP status codeError codeError message
403%s%s
500InternalErrorThe request processing has failed due to some unknown error.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history