Modifies a process monitoring task for an application group.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes ModifyGroupMonitoringAgentProcess

The operation that you want to perform. Set the value to ModifyGroupMonitoringAgentProcess.

AlertConfig.N.ComparisonOperator String Yes GreaterThanOrEqualToThreshold

The comparison operator of the threshold for critical-level alerts. Valid values of N: 1 to 200. Valid values:

  • GreaterThanOrEqualToThreshold: greater than or equal to the threshold
  • GreaterThanThreshold: greater than the threshold
  • LessThanOrEqualToThreshold: less than or equal to the threshold
  • LessThanThreshold: less than the threshold
  • NotEqualToThreshold: not equal to the threshold
  • GreaterThanYesterday: greater than the metric value at the same time yesterday
  • LessThanYesterday: less than the metric value at the same time yesterday
  • GreaterThanLastWeek: greater than the metric value at the same time last week
  • LessThanLastWeek: less than the metric value at the same time last week
  • GreaterThanLastPeriod: greater than the metric value in the last monitoring cycle
  • LessThanLastPeriod: less than the metric value in the last monitoring cycle
AlertConfig.N.EscalationsLevel String Yes warn

The level of the alert. Default value: critical. Valid values of N: 1 to 200. Valid values:

  • critical
  • warn
  • info
AlertConfig.N.Threshold String Yes 5

The threshold for triggering alerts. Valid values of N: 1 to 200.

AlertConfig.N.Times String Yes 3

The number of times for which the threshold can be consecutively exceeded. Valid values of N: 1 to 200. Default value: 3.

Note A metric triggers an alert only after the metric value reaches the threshold consecutively for the specified times.
GroupId String Yes 12345

The ID of the application group.

Id String Yes 92E3065F-0980-4E31-9AA0-*******

The ID of the process monitoring task.

MatchExpressFilterRelation String No and

The logical operator used between conditional expressions that are used to match instances. Valid values:

  • all
  • and
  • or
AlertConfig.N.EffectiveInterval String No 00:00-22:59

The time period during which the alert rule is effective. Valid values of N: 1 to 200.

AlertConfig.N.NoEffectiveInterval String No 23:00-23:59

The time period during which the alert rule is ineffective. Valid values of N: 1 to 200.

AlertConfig.N.SilenceTime String No 86400

The duration of the mute period during which new alerts are not sent even if the trigger conditions are met. Valid values of N: 1 to 200.

Unit: seconds. Minimum value: 3600, which is equivalent to one hour. Default value: 86400, which is equivalent to one day.

Note Only one alert notification is sent during each mute period even if the metric value consecutively exceeds the alert threshold several times.
AlertConfig.N.Webhook String No http://ww.aliyun.com

The callback URL to which a POST request is sent when an alert is triggered based on the alert rule. Valid values of N: 1 to 200.

AlertConfig.N.Statistics String No Average

The method used to calculate the metric values. Valid values of N: 1 to 200.

Note Set the value to Average.

Response parameters

Parameter Type Example Description
RequestId String 7985D471-3FA8-4EE9-8F4B-45C19DF3D36F

The ID of the request.

Code String 200

The HTTP status code.

Note The status code 200 indicates that the call was successful.
Success Boolean true

Indicates whether the call was successful. The value true indicates a success. The value false indicates a failure.

Message String The Request is not authorization.

The returned message.

Examples

Sample requests

http(s)://[Endpoint]/? Action=ModifyGroupMonitoringAgentProcess
&AlertConfig.1.ComparisonOperator=GreaterThanOrEqualToThreshold
&AlertConfig.1.EscalationsLevel=warn
&AlertConfig.1.Threshold=5
&AlertConfig.1.Times=3
&GroupId=12345
&Id=92E3065F-0980-4E31-9AA0-*******
&<Common request parameters>

Sample success responses

XML format

<ModifyGroupMonitoringAgentProcess>
          <RequestId>7985D471-3FA8-4EE9-8F4B-45C19DF3D36F</RequestId>
          <Success>true</Success>
          <Code>200</Code>
</ModifyGroupMonitoringAgentProcess>

JSON format

{
    "RequestId": "7985D471-3FA8-4EE9-8F4B-45C19DF3D36F",
    "Success": true,
    "Code": 200
}

Error codes

For a list of error codes, visit the API Error Center.