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

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

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

调试

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

请求参数

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

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

TagKey String ecs_instance

资源的标签键。

ContactGroupList.N RepeatList ECS_Group

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

说明 报警联系组是一组报警联系人,可以包含一个或多个报警联系人。关于如何创建报警联系人和报警联系组,请参见PutContactPutContactGroup
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

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

返回数据

名称 类型 示例值 描述
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.

错误信息。

示例

请求示例

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

正常返回示例

XML格式

<CreateDynamicTagGroupResponse>
	  <Code>200</Code>
	  <RequestId>84AC6F0B-7945-466A-AA44-99BB5A561F86</RequestId>
	  <Success>true</Success>
</CreateDynamicTagGroupResponse>

JSON格式

{
    "Code":"200",
    "RequestId":"84AC6F0B-7945-466A-AA44-99BB5A561F86",
    "Success":true
}

错误码

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

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