Creates an application group based on the tags of cloud resources.
This operation is available for Elastic Compute Service (ECS), ApsaraDB RDS, and Server Load Balancer (SLB).
This topic provides an example to show how to create an application group for resources
whose tag key is ecs_instance
. In this example, the alert contact group of the application group is ECS_Group
.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | CreateDynamicTagGroup |
The operation that you want to perform. Set the value to CreateDynamicTagGroup. |
TagKey | String | Yes | ecs_instance |
The tag keys of the cloud resources. For more information about how to obtain tag keys, see DescribeTagKeyList. |
ContactGroupList.N | RepeatList | Yes | ECS_Group |
The alert contact group. Valid values of N: 1 to 100. The alert notifications of the application group are sent to the alert contacts that belong to the alert contact group. An alert contact group can contain one or more alert contacts. For information about how to create alert contacts and alert contact groups, see PutContact and PutContactGroup. For information about how to obtain alert contact groups, see DescribeContactGroupList. |
EnableSubscribeEvent | Boolean | No | true |
Specifies whether the application group automatically subscribes to event notifications. If events whose severity level is critical or warning occur on resources in an application group, CloudMonitor sends alert notifications. Valid values:
|
EnableInstallAgent | Boolean | No | true |
Specifies whether the CloudMonitor agent is automatically installed for the application group. CloudMonitor determines whether to automatically install the CloudMonitor agent for the hosts in an application group based on the value of this parameter. Valid values:
|
MatchExpressFilterRelation | String | No | and |
The relationship between the conditional expressions for the tag values of the cloud resources. Valid values:
|
MatchExpress.N.TagValueMatchFunction | String | No | contains |
The method that is used to match the tag values of the cloud resources. In this example, set the value of N to 1. Valid values:
Note If you set the
MatchExpress.N.TagValueMatchFunction parameter, you must also set the MatchExpress.N.TagValue parameter.
|
MatchExpress.N.TagValue | String | No | instance |
The tag values of the cloud resources. In this example, set the value of N to 1. Note If you set the
MatchExpress.N.TagValue parameter, you must also set the MatchExpress.N.TagValueMatchFunction parameter.
|
TemplateIdList.N | RepeatList | No | 85**** |
The IDs of the alert templates. For more information about how to query alert template IDs, see DescribeMetricRuleTemplateList. |
TagRegionId | String | No | cn-hangzhou |
The ID of the region to which the tags belong. |
For more information about common request parameters, see Common parameters.
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
Code | String | 200 |
The HTTP status code. Note The value 200 indicates that the call was successful.
|
Success | Boolean | true |
Indicates whether the call was successful. Valid values:
|
RequestId | String | 84AC6F0B-7945-466A-AA44-99BB5A561F86 |
The ID of the request. |
Message | String | The specified resource is not found. |
The error message. |
Id | String | 2534dc0a-e3e5-4ae1-a2fc-75ef166c**** |
The ID of the tag matching rule. |
Examples
Sample requests
http(s)://[Endpoint]/?Action=CreateDynamicTagGroup
&TagKey=ecs_instance
&ContactGroupList.1=ECS_Group
&<Common request parameters>
Sample success responses
XML
format
<CreateDynamicTagGroupResponse>
<RequestId>84AC6F0B-7945-466A-AA44-99BB5A561F86</RequestId>
<Id>2534dc0a-e3e5-4ae1-a2fc-75ef166c****</Id>
<Code>200</Code>
<Success>true</Success>
</CreateDynamicTagGroupResponse>
JSON
format
{
"RequestId":"84AC6F0B-7945-466A-AA44-99BB5A561F86",
"Id": "2534dc0a-e3e5-4ae1-a2fc-75ef166c****",
"Code": "200",
"Success":true
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
404 | ResourceNotFound | The specified resource is not found. | The error message returned because the specified resource is not found. |
For a list of error codes, visit the API Error Center.