调用CreateDynamicTagGroup接口通过标签自动创建应用分组。

本接口支持的云服务包括：云服务器ECS、云数据库RDS和负载均衡SLB。

本文将提供一个示例，为绑定了标签键ecs_instance的资源自动创建应用分组，应用分组的报警联系组为ECS_Group。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CreateDynamicTagGroup

要执行的操作，取值：CreateDynamicTagGroup。
TagKey String 是 ecs_instance

资源的标签键。

关于如何查询资源的标签键，请参见DescribeTagKeyList。
ContactGroupList.N String 是 ECS_Group

报警联系组。N的取值范围：1~100。应用分组的报警通知会发送给该报警联系组中的报警联系人。

报警联系组是一组报警联系人，可以包含一个或多个报警联系人。关于如何创建报警联系人和报警联系组，请参见PutContact和PutContactGroup。关于如何获取报警联系组，请参见DescribeContactGroupList。
MatchExpress.N.TagValueMatchFunction String 否 contains

资源标签值的匹配方法。N的取值为1。取值：

  • contains：包含。
  • startWith：前缀。
  • endWith：后缀。
  • notContains：不包含。
  • equals：等于。
  • all：全部。
说明 参数MatchExpress.N.TagValueMatchFunction和MatchExpress.N.TagValue必须同时设置。
MatchExpress.N.TagValue String 否 instance

资源标签值。N取值为1。

说明 参数MatchExpress.N.TagValueMatchFunction和MatchExpress.N.TagValue必须同时设置。
MatchExpress.N.TagName String 否 appname

用来创建分组的Tag的Key。如果包含此Key的资源有多个，那么会根据过滤条件，把符合的资源按相同的Key-Value，添加到相同的分组内。
TagRegionId String 否 cn-hangzhou

标签归属的地域ID。
EnableSubscribeEvent Boolean 否 true

应用分组是否开启自动订阅事件通知。当应用分组内资源发生严重和警告级别的事件时，云监控发送报警通知。取值：

  • true：开启。
  • false（默认值）：关闭。
EnableInstallAgent Boolean 否 true

应用分组是否开启自动安装云监控插件。云监控自动为应用分组内的主机安装云监控插件。取值：

  • true：开启。
  • false（默认值）：关闭。
MatchExpressFilterRelation String 否 and

资源标签值的条件表达式之间的关系。取值：

  • and（默认值）：和。
  • or：或。
TemplateIdList.N String 否 70****

报警模板ID。

关于如何查询报警模板ID，请参见DescribeMetricRuleTemplateList。

关于公共请求参数的详情，请参见公共参数。

返回数据

名称 类型 示例值 描述
Code String 200

状态码。

说明 200表示成功。
Message String The specified resource is not found.

错误信息。
RequestId String 84AC6F0B-7945-466A-AA44-99BB5A561F86

请求ID。
Success Boolean true

操作是否成功。取值：

  • true：成功。
  • false：失败。
Id String 2534dc0a-e3e5-4ae1-a2fc-75ef166c****

标签匹配规则ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateDynamicTagGroup
&TagKey=ecs_instance
&ContactGroupList.1=ECS_Group
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateDynamicTagGroupResponse>
	<RequestId>84AC6F0B-7945-466A-AA44-99BB5A561F86</RequestId>
	<Id>2534dc0a-e3e5-4ae1-a2fc-75ef166c****</Id>
	<Code>200</Code>
	<Success>true</Success>
</CreateDynamicTagGroupResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "84AC6F0B-7945-466A-AA44-99BB5A561F86",
  "Id" : "2534dc0a-e3e5-4ae1-a2fc-75ef166c****",
  "Code" : "200",
  "Success" : true
}

错误码

HttpCode 错误码 错误信息 描述
404 ResourceNotFound The specified resource is not found. 未找到指定资源。

访问错误中心查看更多错误码。