文档首页/云运维中心 COC/API参考/API/应用资源管理/分组管理/修改分组 - UpdateApplicationGroup
更新时间：2026-01-23 GMT+08:00
查看PDF
分享

修改分组 - UpdateApplicationGroup

功能介绍

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

调试

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

授权信息

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

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    coc:application:updateGroup

    Write

    application *

    -

    -

    -

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服务相关性能信息。

约束限制：

不涉及。

取值范围：

  • APM：apm服务自研探针。

  • OTEL：OpenTelemetry开源探针。

  • SKYWALKING：SkyWalking开源探针。

默认取值：

不涉及。

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

修改分组成功。

错误码

请参见错误码。

父主题：分组管理

相关文档