更新时间:2025-08-01 GMT+08:00
分享

修改分组

功能介绍

修改分组,创建后,可对组件的名称进行修改。

调试

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

URI

PUT /v1/groups/{id}

表1 路径参数

参数

是否必选

参数类型

描述

id

String

参数解释:

分组ID。

约束限制:

不涉及。

取值范围:

字符串,长度24个字符。

默认取值:

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

name

String

参数解释:

应用名称。

约束限制:

由中文、英文字母、数字、中划线、下划线组成。

取值范围:

长度在3~50个字符之间

默认取值:

不涉及。

sync_mode

String

参数解释:

资源同步方式。

约束限制:

不涉及。

取值范围:

  • MANUAL:表示手动关联:用户在对应分组下,手动将对应资源数据关联至分组内进行管理。

  • AUTO:表示智能关联:用户通过企业项目和标签的形式,将企业项目下的相同标签资源创建至同一资源分组。

默认取值:

默认MANUAL。

sync_rules

Array of sync_rules objects

参数解释:

智能关联规则。

约束限制:

不涉及。

取值范围:

智能关联已选择的企业项目和对应标签的现存及未来创建的资源。

默认取值:

不涉及。

relation_configurations

Array of GroupRelationConfiguration objects

分组配置信息。

表3 sync_rules

参数

是否必选

参数类型

描述

ep_id

String

参数解释:

企业项目id。

约束限制:

不涉及。

取值范围:

请选择企业管理中存在的项目ID。

默认取值:

不涉及。

rule_tags

String

参数解释:

关联标签。

企业项目中的资源满足配置的所有标签时,应用分组将智能关联。

约束限制:

不涉及。

取值范围:

可自定义。

默认取值:

不涉及。

表4 GroupRelationConfiguration

参数

是否必选

参数类型

描述

type

String

参数解释:

配置类型。

约束限制:

不涉及。

取值范围:

配置本分组所对应的APM服务中的应用-组件-环境,故障诊断时可获取APM服务相关性能信息。

默认取值:

不涉及。

parameters

Map<String,String>

参数解释:

配置参数。

约束限制:

不涉及。

取值范围:

apm相关配置参数 app_id->business_id->env_id。

默认取值:

不涉及。

响应参数

状态码:200

表5 响应Body参数

参数

参数类型

描述

data

String

参数解释:

分组配置信息。

取值范围:

不涉及。

请求示例

修改分组。

PUT https://{Endpoint}/v1/groups/{id}

{
  "name" : "test分组",
  "sync_mode" : "MANUAL",
  "sync_rules" : null,
  "relation_configurations" : null
}

响应示例

状态码:200

修改分组成功。

{
  "data" : "685d116902a50263fb2c209e"
}

状态码

状态码

描述

200

修改分组成功。

错误码

请参见错误码

相关文档