文档首页/云监控服务 CES/API参考/API/资源分组/资源分组管理/修改资源分组 - UpdateResourceGroup

更新时间：2026-01-05 GMT+08:00

修改资源分组 - UpdateResourceGroup

功能介绍

修改资源分组

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
ces:resourceGroups:put
Write
-
g:EnterpriseProjectId
-
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
ces:resourceGroups:put	Write	-	g:EnterpriseProjectId	-	-

URI

PUT /v2/{project_id}/resource-groups/{group_id}

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释: 项目ID。用于明确项目归属，配置后可通过该ID查询项目下资产，可以通过调用API获取，也可以从控制台获取。获取方式请参见获取项目ID。约束限制: 不涉及。取值范围: 字符串的长度必须在 1 到 64个字符之间。默认取值: 不涉及。
group_id	是	String	参数解释资源分组ID。约束限制不涉及。取值范围以"rg"开头，后跟22位由字母或数字组成的字符串。默认取值不涉及。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	租户Token

表3 请求Body参数
参数	是否必选	参数类型	描述
group_name	是	String	参数解释资源分组名称。约束限制不涉及。取值范围包含字母、数字、_、-或汉字，长度为[1,128]个字符。默认取值不涉及。
tags	否	Array of ResourceGroupTagRelation objects	参数解释标签动态匹配时的关联标签。约束限制 type为TAG时必传，不超过50个标签。
enterprise_project_id_and_tags	否	Array of EnterpriseProjectIdAndTags objects	参数解释资源匹配规则为组合匹配时传入的参数，已废弃。约束限制 type为COMB时传入，不超过50个条件。
extend_relation_ids	否	Array of strings	参数解释匹配企业项目时关联的企业项目ID。约束限制 type为EPS时必传，不超过50个企业项目。
instances	否	Array of Instance objects	参数解释实例名称匹配参数。约束限制 type为NAME时必传，不超过50个实例。
product_names	否	String	参数解释资源层级为云产品时的云产品名称约束限制不涉及。取值范围一般由"服务命名空间,服务首层维度名称"组成，如"SYS.ECS,instance_id"。多个云产品则用“;”隔开，如"SERVICE.BMS,instance_id;SYS.ECS,instance_id"。不超过10240个字符。默认取值不涉及。
comb_relation	否	CombRelation object	参数解释组合匹配参数。约束限制不涉及。

表4 ResourceGroupTagRelation
参数	是否必选	参数类型	描述
key	是	String	参数解释 TMS标签键规范约束限制不涉及取值范围长度为[1,128]个字符默认取值不涉及
operator	否	String	参数解释 tag操作符，含义是标签key与value的关系约束限制不涉及取值范围 include: 表示包含 prefix: 表示前缀 suffix: 表示后缀 notInclude: 表示不包含 equal: 表示相等，当operator为equal，value为空字符串时表示为全部 all: 表示全部默认取值不涉及
value	否	String	参数解释 TMS标签值规范约束限制不涉及取值范围长度为[0，255]个字符默认取值不涉及

表5 EnterpriseProjectIdAndTags
参数	是否必选	参数类型	描述
enterprise_project_id	否	String	参数解释企业项目ID 约束限制不涉及取值范围由字母、数字、_和-组成，长度为[1,128]个字符默认取值不涉及
tag	否	ResourceGroupTagRelation object	参数解释标签的匹配规则约束限制不涉及

表6 Instance
参数	是否必选	参数类型	描述
product_name	是	String	参数解释云产品名称约束限制不涉及取值范围长度为[0,128]个字符默认取值不涉及
logical_operator	是	String	参数解释逻辑运算符约束限制不涉及取值范围 ALL: 所有条件匹配成功 ANY: 任意条件匹配成功默认取值不涉及
instance_names	是	Array of ResourceNameItem objects	参数解释资源名称匹配参数数组约束限制不超过10个名称

表7 ResourceNameItem
参数	是否必选	参数类型	描述
resource_name	否	String	参数解释资源名称条件值约束限制不涉及取值范围长度[0,128]个字符默认取值不涉及
operator	是	String	参数解释实例操作符，含义是真实资源的名称与资源名称条件值的运算关系。约束限制不涉及取值范围 include: 表示包含 prefix: 表示前缀 suffix: 表示后缀 notInclude: 表示不包含 equal: 表示相等 all: 表示全部默认取值不涉及
resource_name_is_ignore_case	否	Boolean	参数解释资源名称忽略大小写约束限制不涉及取值范围 true: 名称忽略大小写 false: 名称不忽略大小写默认取值 false

表8 CombRelation
参数	是否必选	参数类型	描述
logical_operator	是	String	参数解释逻辑运算符。约束限制不涉及。取值范围 ALL: 所有条件匹配成功。 ANY: 任意条件匹配成功。默认取值不涉及。
conditions	是	Array of Condition objects	参数解释组合匹配资源分组的匹配条件。约束限制不超过50个条件。

表9 Condition
参数	是否必选	参数类型	描述
enterprise_project_id	否	String	参数解释企业项目ID 约束限制不涉及取值范围由数字、字母和-组成，或者为0（默认企业项目ID）默认取值不涉及
instance_name	否	CombResourceName object	资源名称匹配规则
tag	否	ResourceGroupTagRelation object	参数解释标签的匹配规则约束限制不涉及

**表10** CombResourceName
参数	是否必选	参数类型	描述
resource_name	否	String	参数解释资源名称条件值约束限制不涉及取值范围长度[1,128]个字符默认取值不涉及
operator	是	String	参数解释实例操作符，含义是真实资源的名称与资源名称条件值的运算关系。约束限制不涉及取值范围 include: 表示包含 prefix: 表示前缀 suffix: 表示后缀 notInclude: 表示不包含 equal: 表示相等默认取值不涉及
resource_name_is_ignore_case	否	Boolean	参数解释资源名称忽略大小写约束限制不涉及取值范围 true: 名称忽略大小写 false: 名称不忽略大小写默认取值 false

响应参数

状态码：204

No Content

状态码：400

**表11** 响应Body参数
参数	参数类型	描述
error_code	String	请求异常内部业务状态码
error_msg	String	请求异常信息
request_id	String	请求ID

状态码：401

**表12** 响应Body参数
参数	参数类型	描述
error_code	String	请求异常内部业务状态码
error_msg	String	请求异常信息
request_id	String	请求ID

状态码：403

**表13** 响应Body参数
参数	参数类型	描述
error_code	String	请求异常内部业务状态码
error_msg	String	请求异常信息
request_id	String	请求ID

状态码：404

**表14** 响应Body参数
参数	参数类型	描述
error_code	String	请求异常内部业务状态码
error_msg	String	请求异常信息
request_id	String	请求ID

状态码：500

**表15** 响应Body参数
参数	参数类型	描述
error_code	String	请求异常内部业务状态码
error_msg	String	请求异常信息
request_id	String	请求ID

请求示例

修改名称为rg_test的资源分组。

{
  "group_name" : "rg_test",
  "tags" : [ {
    "key" : "key1",
    "value" : "value1"
  } ]
}

响应示例

无

状态码

状态码	描述
204	No Content
400	参数校验失败
401	未认证
403	认证鉴权失败
404	资源不存在
500	系统内部错误

错误码

请参见错误码。

父主题：资源分组管理

上一篇：更新资源分组 - UpdateResourceGroupDeprecated

下一篇：删除资源分组 - DeleteResourceGroup

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

云宝助手提问云社区提问