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

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

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

调试

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

请求参数

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

要执行的操作,取值:CreateDynamicTagGroup。

TagKey String ecs_instance

资源的标签键。

关于如何查询资源的标签键,请参见DescribeTagKeyList

ContactGroupList.N RepeatList ECS_Group

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

报警联系组是一组报警联系人,可以包含一个或多个报警联系人。关于如何创建报警联系人和报警联系组,请参见PutContactPutContactGroup。关于如何获取报警联系组,请参见DescribeContactGroupList

EnableSubscribeEvent Boolean true

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

  • true:开启。
  • false(默认值):关闭。
EnableInstallAgent Boolean true

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

  • true:开启。
  • false(默认值):关闭。
MatchExpressFilterRelation String and

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

  • and(默认值):和。
  • or:或。
MatchExpress.N.TagValueMatchFunction String contains

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

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

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

说明 参数MatchExpress.N.TagValueMatchFunctionMatchExpress.N.TagValue必须同时设置。
TemplateIdList.N RepeatList 85****

报警模板ID。

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

TagRegionId String cn-hangzhou

标签归属的地域ID。

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

返回数据

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

状态码。

说明 200表示成功。
Success Boolean true

操作是否成功。取值:

  • true:成功。
  • false:失败。
RequestId String 84AC6F0B-7945-466A-AA44-99BB5A561F86

请求ID。

Message String The specified resource is not found.

错误信息。

Id String 2534dc0a-e3e5-4ae1-a2fc-75ef166c****

标签匹配规则ID。

示例

请求示例

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

正常返回示例

XML格式

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

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. 未找到指定资源。

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