修改资源分组
功能介绍
修改资源分组
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
PUT /v2/{project_id}/resource-groups/{group_id}
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
租户ID 最小长度:1 最大长度:64 |
group_id |
是 |
String |
资源分组ID,以rg开头,后跟22位由字母或数字组成的字符串 最小长度:2 最大长度:24 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
租户Token 最小长度:1 最大长度:16384 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
group_name |
是 |
String |
资源分组名称,只能为字母、数字、汉字、-、_,最大长度为128 最小长度:1 最大长度:128 |
tags |
否 |
Array of ResourceGroupTagRelation objects |
标签动态匹配时的关联标签,type为TAG时该字段不为空 数组长度:1 - 50 |
enterprise_project_id_and_tags |
否 |
Array of EnterpriseProjectIdAndTags objects |
资源匹配规则为组合匹配时传入的参数 数组长度:1 - 50 |
extend_relation_ids |
否 |
Array of strings |
智能添加时企业项目匹配传入参数 数组长度:1 - 50 |
instances |
否 |
Array of Instance objects |
实例名称匹配参数 数组长度:1 - 50 |
product_names |
否 |
String |
修改资源层级为云产品时的云产品的取值,一般由"服务命名空间,服务首层维度名称"组成,如"SYS.ECS,instance_id"。多个云产品则用“;”隔开,如"SERVICE.BMS,instance_id;SYS.ECS,instance_id"。 最小长度:0 最大长度:10240 |
comb_relation |
否 |
CombRelation object |
参数解释 组合匹配参数。 约束限制 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
key |
是 |
String |
参数解释 TMS标签键规范 约束限制 不涉及 取值范围 长度为[1,128]个字符 默认取值 不涉及 |
operator |
否 |
String |
参数解释 tag操作符,含义是标签key与value的关系 约束限制 不涉及 取值范围
默认取值 不涉及 枚举值:
|
value |
否 |
String |
参数解释 TMS标签值规范 约束限制 不涉及 取值范围 长度为[0,255]个字符 默认取值 不涉及 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
enterprise_project_id |
否 |
String |
参数解释 企业项目ID 约束限制 不涉及 取值范围 由字母、数字、_和-组成,长度为[1,128]个字符 默认取值 不涉及 最小长度:1 最大长度:128 正则匹配:^([a-z]|[A-Z]|[0-9]|_|-)+$ |
tag |
否 |
ResourceGroupTagRelation object |
参数解释 标签的匹配规则 约束限制 不涉及 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
product_name |
是 |
String |
参数解释 云产品名称 约束限制 不涉及 取值范围 长度为[1,16]个字符 默认取值 不涉及 最小长度:1 最大长度:16 |
logical_operator |
是 |
String |
参数解释 逻辑运算符 约束限制 不涉及 取值范围
默认取值 不涉及 枚举值:
|
instance_names |
是 |
Array of ResourceName objects |
参数解释 资源名称匹配参数数组 约束限制 不超过10个名称 数组长度:1 - 10 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
resource_name |
否 |
String |
参数解释 资源名称条件值 约束限制 不涉及 取值范围 长度[0,128]个字符 默认取值 不涉及 最小长度:0 最大长度:128 |
operator |
是 |
String |
参数解释 实例操作符,含义是真实资源的名称与资源名称条件值的运算关系。 约束限制 不涉及 取值范围
默认取值 不涉及 枚举值:
|
resource_name_is_ignore_case |
否 |
Boolean |
参数解释 资源名称忽略大小写 约束限制 不涉及 取值范围
默认取值 false |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
logical_operator |
是 |
String |
参数解释 逻辑运算符。 约束限制 不涉及。 取值范围
默认取值 不涉及。 枚举值:
|
conditions |
是 |
Array of Condition objects |
参数解释 组合匹配资源分组的匹配条件。 约束限制 不超过50个条件。 数组长度:1 - 50 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
enterprise_project_id |
否 |
String |
参数解释 企业项目ID 约束限制 不涉及 取值范围 由数字、字母和-组成,或者为0(默认企业项目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 |
否 |
CombResourceName object |
组合匹配资源名称 |
tag |
否 |
ResourceGroupTagRelation object |
参数解释 标签的匹配规则 约束限制 不涉及 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
resource_name |
否 |
String |
参数解释 资源名称条件值 约束限制 不涉及 取值范围 长度[1,128]个字符 默认取值 不涉及 最小长度:1 最大长度:128 |
operator |
是 |
String |
参数解释 实例操作符,含义是真实资源的名称与资源名称条件值的运算关系。 约束限制 不涉及 取值范围
默认取值 不涉及 枚举值:
|
resource_name_is_ignore_case |
否 |
Boolean |
参数解释 资源名称忽略大小写 约束限制 不涉及 取值范围
默认取值 false |
响应参数
状态码:204
No Content
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
请求异常内部业务状态码 最小长度:0 最大长度:256 |
error_msg |
String |
请求异常信息 最小长度:0 最大长度:256 |
request_id |
String |
请求ID 最小长度:0 最大长度:256 |
状态码:401
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
请求异常内部业务状态码 最小长度:0 最大长度:256 |
error_msg |
String |
请求异常信息 最小长度:0 最大长度:256 |
request_id |
String |
请求ID 最小长度:0 最大长度:256 |
状态码:403
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
请求异常内部业务状态码 最小长度:0 最大长度:256 |
error_msg |
String |
请求异常信息 最小长度:0 最大长度:256 |
request_id |
String |
请求ID 最小长度:0 最大长度:256 |
状态码:404
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
请求异常内部业务状态码 最小长度:0 最大长度:256 |
error_msg |
String |
请求异常信息 最小长度:0 最大长度:256 |
request_id |
String |
请求ID 最小长度:0 最大长度:256 |
状态码:500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
请求异常内部业务状态码 最小长度:0 最大长度:256 |
error_msg |
String |
请求异常信息 最小长度:0 最大长度:256 |
request_id |
String |
请求ID 最小长度:0 最大长度:256 |
请求示例
修改名称为rg_test的资源分组。
{ "group_name" : "test", "tags" : [ { "key" : "key1", "value" : "value1" } ] }
响应示例
无
状态码
状态码 |
描述 |
---|---|
204 |
No Content |
400 |
参数校验失败 |
401 |
未认证 |
403 |
认证鉴权失败 |
404 |
资源不存在 |
500 |
系统内部错误 |
错误码
请参见错误码。