响应示例 状态码：200 OK { "count" : 1000, "resources" : [ { "status" : "health", "dimensions" : [ { "name" : "instance_id", "value" : "4270ff17-aba3-4138-89fa-820594c39755" } ] } ] }

URI GET /v2/{project_id}/resource-groups/{group_id}/services/{service}/resources 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户ID group_id 是 String 资源分组ID，以rg开头，后跟22位由字母或数字组成的字符串 service 是 String 服务类别，如SYS.E CS 表2 Query参数 参数 是否必选 参数类型 描述 dim_name 否 String 资源维度信息，多个维度按字母序使用逗号分割 limit 否 String 分页查询时每页的条目数，取值[1,100]，默认值为100 offset 否 Integer 分页查询时查询的起始位置，表示从第几条数据开始，默认为0 取值范围： 0-10000 status 否 String 按状态信息进行过滤，取值只能为health（已设置告警规则且无告警触发的资源）、unhealthy（已设置告警规则且有告警触发的资源）、no_alarm_rule（未设置告警规则的资源） 枚举值： health unhealthy no_alarm_rule dim_value 否 String 资源维度值，不支持模糊匹配，但是多维度资源可以只指定一个维度值 tag 否 String 资源的标签信息，格式："[key]":"[value]"，样例参考："ssss":"1111" extend_relation_id 否 String 企业项目ID product_name 否 String 资源分组的云产品，一般由"服务命名空间,服务首层维度名称"组成，如"SYS.ECS,instance_id" resource_name 否 String 资源名称 正则匹配：^$|^([\u4E00-\u9FFF]|[a-z]|[A-Z]|[0-9]|_|-|\\.|)+$ event_status 否 String 按事件告警状态信息进行过滤，取值只能为health（已设置事件告警规则且无事件告警触发的资源）、unhealthy（已设置事件告警规则且有事件告警触发的资源）、no_alarm_rule（未设置事件告警规则的资源） 枚举值： health unhealthy no_alarm_rule

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 count Integer 资源总数 取值范围： 0-10000 resources Array of GetResourceGroupResources objects 资源分组资源列表 表5 GetResourceGroupResources 参数 参数类型 描述 status String 指标告警状态，取值为health（告警中）、unhealthy（已触发）、no_alarm_rule（未设置告警规则） 枚举值： health unhealthy no_alarm_rule dimensions Array of ResourceDimension objects 资源的维度信息 tags String 资源的tag信息,格式为key/value的json字符串,样例为"{"sss":"aaa"}" enterprise_project_id String 企业项目ID event_status String 事件告警状态，取值为health（告警中）、unhealthy（已触发）、no_alarm_rule（未设置告警规则） 枚举值： health unhealthy no_alarm_rule resource_name String 资源名称 表6 ResourceDimension 参数 参数类型 描述 name String 资源维度，如：弹性云服务器，则维度为instance_id；目前最大支持4个维度，各服务资源的指标维度名称可查看：“服务指标维度”。 正则匹配：^([a-z]|[A-Z]){1}([a-z]|[A-Z]|[0-9]|_|-){1,32}$ value String 资源维度值，为资源的实例ID，如：4270ff17-aba3-4138-89fa-820594c39755。 正则匹配：^((([a-z]|[A-Z]|[0-9]){1}([a-z]|[A-Z]|[0-9]|_|-|\.)*)|\*){1,256}$ 状态码：400 表7 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID 状态码：401 表8 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID 状态码：403 表9 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID 状态码：404 表10 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID 状态码：500 表11 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID

响应示例 状态码：200 OK { "group_name" : "band", "type" : "TAG", "tags" : [ { "key" : "Resource", "value" : "VPC" }, { "key" : "Usage", "value" : "Tmp" } ], "create_time" : "2006-01-02T15:04:05.000Z", "group_id" : "rg0123456789xxxx", "enterprise_project_id" : "0" }

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 group_name String 资源分组的名称 正则匹配：^((([a-z]|[0-9]){8}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){12})|0)$ group_id String 资源分组ID，以rg开头，后跟22位由字母或数字组成的字符串 create_time DateTime 资源分组的创建时间 enterprise_project_id String 资源分组归属企业项目ID 正则匹配：^((([a-z]|[0-9]){8}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){12})|0)$ type String 资源添加/匹配方式，取值只能为EPS（匹配企业项目）,TAG（匹配标签）,NAME（匹配实例名称）, COMB（组合匹配）,Manual（手动添加） 枚举值： EPS TAG NAME COMB Manual association_ep_ids Array of strings 该资源分组内包含的资源来源的企业项目ID，type为EPS时必传 tags Array of ResourceGroupTagRelation objects 当资源匹配规则为匹配标签时,所指定的标签规则 instances Array of Instance objects 实例名称匹配参数 comb_relation CombRelation object 组合匹配参数 related_ep_ids Array of strings 当资源匹配规则为匹配企业项目时，指定的企业项目列表 enterprise_project_id_and_tags Array of EnterpriseProjectIdAndTags objects 匹配企业项目或匹配标签参数 status String 指标告警状态，取值为health（告警中）、unhealthy（已触发）、no_alarm_rule（未设置告警规则） 枚举值： health unhealthy no_alarm_rule event_status String 事件告警状态，取值为health（告警中）、unhealthy（已触发）、no_alarm_rule（未设置告警规则） 枚举值： health unhealthy no_alarm_rule resource_statistics resource_statistics object 资源数(告警中/已触发/资源总数) resource_level String dimension: 子维度,product: 云产品 枚举值： dimension product product_names String 创建资源层级为云产品时的云产品的取值，一般由"服务命名空间,服务首层维度名称"组成，如"SYS.ECS,instance_id"。多个云产品则用“;”隔开，如"SERVICE.BMS,instance_id;SYS.ECS,instance_id"。 ep_resource_statistics Array of EpResourceStatistics objects 每个企业项目关联的资源状态 表4 ResourceGroupTagRelation 参数 参数类型 描述 key String TMS标签键规范。 operator String tag操作符，含义是标签key与value的关系。 include表示包含 prefix表示前缀 suffix表示后缀 notInclude表示不包含 equal表示相等 当operator为equal，value为空字符串时表示为全部 all表示全部 枚举值： include prefix suffix notInclude equal all value String TMS标签值规范。 表5 Instance 参数 参数类型 描述 product_name String 云产品名称 logical_operator String 逻辑运算符 ALL 所有条件匹配成功 ANY 任意条件匹配成功 枚举值： ALL ANY instance_names Array of ResourceName objects 资源名称匹配参数数组 表6 ResourceName 参数 参数类型 描述 resource_name String 资源名称条件值 operator String 实例操作符，含义是真实资源的名称与资源名称条件值的运算关系。 include表示包含 prefix表示前缀 suffix表示后缀 notInclude表示不包含 equal表示相等 all表示全部 枚举值： include prefix suffix notInclude equal all resource_name_is_ignore_case Boolean 资源名称忽略大小写 表7 CombRelation 参数 参数类型 描述 logical_operator String 逻辑运算符 ALL 所有条件匹配成功 ANY 任意条件匹配成功 枚举值： ALL ANY conditions Array of Condition objects 组合匹配资源分组的匹配条件 表8 Condition 参数 参数类型 描述 enterprise_project_id String 企业项目ID 正则匹配：^((([a-z]|[0-9]){8}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){4}-([a-z]|[0-9]){12})|0)$ instance_name ResourceName object 资源名称 tag ResourceGroupTagRelation object 标签的匹配规则 表9 EnterpriseProjectIdAndTags 参数 参数类型 描述 enterprise_project_id String 企业项目ID 正则匹配：^([a-z]|[A-Z]|[0-9]|_|-)+$ tag ResourceGroupTagRelation object 标签的匹配规则 表10 resource_statistics 参数 参数类型 描述 unhealthy Integer 告警中的资源数 取值范围： 0-9999999 total Integer 资源总数 取值范围： 0-9999999 event_unhealthy Integer 已触发的资源数 取值范围： 0-9999999 namespaces Integer 资源类型数 取值范围： 0-9999999 表11 EpResourceStatistics 参数 参数类型 描述 extend_relation_id String 企业项目ID unhealthy Integer 告警中的资源数 取值范围： 0-9999999 total Integer 资源总数 取值范围： 0-9999999 event_unhealthy Integer 已触发的资源数 取值范围： 0-9999999 namespaces Integer 资源类型数 取值范围： 0-9999999 状态码：400 表12 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID 状态码：401 表13 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID 状态码：403 表14 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID 状态码：404 表15 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID 状态码：500 表16 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID

响应参数 状态码：200 表5 响应Body参数 参数 参数类型 描述 group_id String 资源分组ID，以rg开头，后跟22位由字母或数字组成的字符串 template_ids Array of strings 关联的告警模板的ID列表 状态码：400 表6 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID 状态码：401 表7 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID 状态码：403 表8 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID 状态码：404 表9 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID 状态码：500 表10 响应Body参数 参数 参数类型 描述 error_code String 请求异常内部业务状态码 error_msg String 请求异常信息 request_id String 请求ID

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 发送的实体的MIME类型。默认使用application/json; charset=UTF-8。 默认取值： application/json; charset=UTF-8 X-Auth-Token 是 String 用户Token 表3 请求Body参数 参数 是否必选 参数类型 描述 template_ids 是 Array of strings 告警模板编号列表，当ID列表为空时，将删除该资源分组已关联的告警模板所创建的告警规则 notification_enabled 是 Boolean 是否开启告警通知。true:开启，false:关闭。 alarm_notifications 否 Array of Notification objects 告警触发通知列表 ok_notifications 否 Array of Notification objects 告警恢复通知列表 notification_begin_time 否 String 告警通知开启时间 notification_end_time 否 String 告警通知关闭时间 effective_timezone 否 String 时区，形如："GMT-08:00"、"GMT+08:00"、"GMT+0:00" enterprise_project_id 否 String 企业项目ID notification_manner 否 String NOTIFICATION_GROUP(通知组)/TOPIC_SUBSCRIPTION(主题订阅)/NOTIFICATION_POLICY(通知策略) 枚举值： NOTIFICATION_GROUP TOPIC_SUBSCRIPTION NOTIFICATION_POLICY notification_policy_ids 否 Array of strings 关联的通知策略ID列表 表4 Notification 参数 是否必选 参数类型 描述 type 是 String 通知类型。notification为 SMN 通知，contact为云账号联系人，contactGroup为通知组，autoscaling为AS通知。 枚举值： notification autoscaling groupwatch ecsRecovery contact contactGroup iecAction notification_list 是 Array of strings 告警状态发生变化时，被通知对象的列表。topicUrn可从SMN获取，具体操作请参考查询Topic列表。当type为notification时，notification_list列表不能为空；当type为autoscaling时，列表必须为[]。 说明：若alarm_action_enabled为true，对应的alarm_actions、ok_actions至少有一个不能为空。若alarm_actions、ok_actions同时存在时，notification_list值保持一致。

URI PUT /v2/{project_id}/resource-groups/{group_id}/alarm-templates/async-association 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户ID 正则匹配：^[a-zA-Z0-9-]{1,64}$ group_id 是 String 资源分组ID，以rg开头，后跟22位由字母或数字组成的字符串 正则匹配：^rg([a-z]|[A-Z]|[0-9]){22}$

限制与约束 一个用户最多可创建1000个资源分组。 一个资源分组可添加1-10000个云服务资源。 一个资源分组对不同类型资源有可选数量限制，具体请参见控制台提示。 当新建资源分组成功后，由于资源分组规则存在同步生效过程，不会立即生效，可能存在3小时左右的延迟。 当修改资源分组成功后，由于资源分组规则存在同步生效过程，不会立即生效，可能仍然按照旧的分组规则匹配资源，新规则生效时间可能存在3小时左右延迟。

资源分组支持的云服务 由于智能创建资源分组的能力依赖云服务对接config资源管理服务，可能存在部分云服务在某些region未对接config的情况，具体支持情况可在页面配置资源分组时查看确认。 云服务 英文简称 产品 手动添加 企业项目 标签 实例名称 组合匹配 弹性云服务器 ECS 云服务器 √ √ √ √ √ 裸金属服务器 BMS 云服务器 √ √ √ √ √ API网关专享版 APIC APIG实例 √ √ √ √ √ API网关 APIG 接口 √ × × × × 弹性伸缩 AS 弹性伸缩组 √ √ √ √ √ 云堡垒机 CBH CBH √ √ √ √ √ 云备份 CBR 存储库 √ × × × × 云连接 CC 云连接 √ × × × × 云数据迁移 服务 CDM 实例 √ × × × × 内容分发网络 CDN 域名 √ √ × √ × 云防火墙 CFW 云防火墙实例 √ × × × × 表格存储服务 CloudTable 集群ID √ √ × √ × 云专线 DCAAS 物理连接 √ × × × × 历史专线 √ × × × × 虚拟接口 √ × × × × 虚拟网关 √ × × × × 分布式缓存服务 DCS DCSRedis实例 √ √ √ √ √ DCS IMDG实例 √ × × × × DCS Memcached实例 √ × × × × 分布式数据库 中间件(newddm) DDMS DDM实例 √ √ √ √ √ 文档数据库服务 DDS 文档数据库实例 √ √ √ √ √ 数据湖探索 DLI 队列 √ × × × × 分布式消息服务 DMS Kafka专享版 √ √ √ √ √ RabbitMQ实例 √ √ √ √ √ RocketMQ专享版 √ √ √ √ √ 队列消费组 √ × × × × 队列 √ × × × × 云解析服务 DNS 记录集 √ √ √ √ √ 域名 √ √ √ √ √ 数据复制服务 DRS DRS运行实例 √ √ √ √ √ 数据仓库服务 DWS 数据仓库 服务 √ √ √ √ √ 数据仓库节点 √ × × × × 数据仓库实例 √ × × × × 弹性文件服务Turbo EFS 实例 √ √ × √ × 弹性负载均衡 ELB 弹性负载均衡 √ √ √ √ √ 经典型负载均衡器 √ × × × × 云搜索服务 ES CSS 集群 √ √ √ √ √ 云硬盘 EVS 磁盘 √ √ × √ × 函数工作流 FunctionGraph 租户 √ × × × × 函数流 √ × × × × 函数 √ × × × × 云数据库 GaussDB GAUSSDB 云数据库 GaussDB实例 √ × × × × 云数据库 GaussDB(for MySQL) GaussDB(for MySQL) GaussDBforMySQ L实例 √ √ √ √ √ 全域弹性公网IP和带宽 GEIP 公网带宽 √ × × × × 全域弹性公网ip √ × × × × 全域弹性公网ip段 √ × × × × 图引擎服务 GES 图实例 √ √ √ √ √ 主机安全服务 HSS 主机实例 √ √ √ √ √ 主机安全 √ √ √ √ √ 视频直播 LIVE 域名 √ × × × × Mapreduce服务 MRS 集群 √ √ √ √ √ NAT网关 NAT 私网NAT网关 √ × × × × 公网NAT网关 √ √ √ √ √ 云数据库 GeminiDB NoSQL Cassandra √ √ √ √ √ Redis √ √ √ √ √ InfluxDB √ × × × × MongoDB √ × × × × 对象存储服务 OBS 桶名称 √ √ √ √ √ 关系型数据库 RDS PostgreSQL实例 √ √ √ √ √ MySQL实例 √ √ √ √ √ MicrosoftSQLServer实例 √ √ √ √ √ ROMA ROMA ROMA实例 √ × × × × 弹性文件服务 SFS SFS容量型 √ × × × × 通用文件系统 √ × × × × 虚拟私有云 VPC 带宽 √ √ √ √ × 弹性IP √ √ √ √ × 虚拟专用网络 VPN VPN连接 √ √ × √ × 企业版站点入云VPN网关 √ √ √ √ √ 企业版站点入云VPN连接 √ √ √ √ √ 企业版终端入云VPN网关 √ √ √ √ √ 新VPN连接实例 √ × × × × 独享型VPN连接 √ × × × × Web应用防火墙 WAF 防护域名 √ √ × √ × 独享实例 √ × × × × 父主题： 资源分组