修改用户组信息

最近更新时间: 2026-10-12 00:11:06

1. 接口描述

接口请求域名： cic.api3.fincloud.tencent.com。

修改用户组信息

默认接口请求频率限制：20次/秒。

接口更新时间：2024-12-11 12:17:58。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：UpdateGroup
Version	是	否	String	公共参数，本接口取值：2021-03-31
Region	是	否	String	公共参数，地域信息本接口不需要传递此参数。
GroupId	是	是	String	用户组ID。示例值： g-sd8sh8sdno***
NewGroupName	否	是	String	新的用户组名称。示例值： group_name
NewDescription	否	是	String	新的用户组描述。示例值： description
ZoneId	是	是	String	空间 ID。示例值： z-2d8shd8***

3. 输出参数

参数名称	类型	描述
GroupInfo	GroupInfo	用户组信息。示例值：查看
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
FailedOperation.ManualGroupNotUpdate
FailedOperation.SynchronizedGroupNotUpdate
InvalidParameter.GroupNotExist
InvalidParameter.GroupNameAlreadyExists
FailedOperation.ZoneIdNotExist
FailedOperation.IdentityCenterNotOpen

5. 示例

示例1 修改用户组信息

输入示例

{
  "ZoneId": "z-s8shs8bd***",
  "GroupId": "g-s8dhdn3",
  "NewGroupName": "testGroup",
  "NewDescription": "this is group."
}

输出示例

{
  "Response": {
    "GroupInfo": {
      "GroupName": "testGroup",
      "Description": "this is group",
      "CreateTime": "2024-01-01 12:12:12",
      "GroupType": "Manual",
      "UpdateTime": "2024-01-01 12:12:12",
      "GroupId": "g-w8hd8n***",
      "MemberCount": 20
    },
    "RequestId": "e297543a-80de-4039-83c8-9d324545"
  }
}