组管理接口

多用户访问控制 IAM

  • 测试知识库SDK
  • 功能发布记录
  • 产品描述
    • 概念
    • 目前支持的产品线
    • 产品概述
    • 应用场景
    • 产品功能
    • 企业组织vs多用户访问控制
    • 系统限制
  • 操作记录
    • 操作记录（公测中）
  • API参考_IAM
    • 通用说明
    • 策略管理接口
    • 简介
    • 角色管理接口
    • 公共请求头与公共响应头
    • 数据类型
    • 组管理接口
    • 服务域名
    • 用户管理接口
    • 错误码
  • 产品公告
    • 【重要升级】百度智能云为所有用户开启登录保护MFA多因素认证通知
  • 快速入门
    • 创建子用户管理员
    • 创建用户组并授权
  • 典型实践
    • 用户管理与权限分配
    • 百度智能云合作伙伴开通子用户教程
  • 操作指南
    • 账户安全审计
    • 设置
    • 用户组管理
    • 消息中心
    • 外部账号接入
      • IAM用户联合
      • IAM角色联合
      • 联合登录概览
    • 角色管理
      • 相关概念
      • 常见场景
      • 管理角色
      • 使用角色
      • 常见问题
      • 创建角色
      • 概述
    • 用户异常行为分析（公测中）
      • 风险行为管理
    • 权限策略
      • 策略类型
      • 授权
      • 策略鉴权评估逻辑
      • 策略语法
      • 管理IAM策略
      • 基于标签授权与鉴权
      • 权限策略概述
    • 用户
      • 用户管理
      • 双因素验证
      • 子用户操作
  • API参考
    • 通用说明
    • 简介
    • 公共请求头与公共响应头
    • 数据类型
    • STS相关接口
    • 功能更新记录
    • 服务域名
    • 错误码
  • 常见问题
    • 子用户问题
    • 常见问题总览
    • 产品权限问题
  • 产品定价
    • 产品定价
  • SDK
    • Python-SDK
      • 策略管理接口
      • 角色管理接口
      • 版本变更记录
      • 组管理接口
      • 初始化
      • 用户管理接口
      • 安装SDK工具包
      • 错误码
      • 概述
    • Java-SDK
      • 策略管理接口
      • 角色管理接口
      • 版本变更记录
      • 组管理接口
      • 初始化
      • 用户管理接口
      • 安装SDK工具包
      • 错误码
      • 概述
    • Go-SDK
      • 策略管理接口
      • 角色管理接口
      • 版本变更记录
      • 组管理接口
      • 用户管理接口
      • 错误处理
      • 安装SDK工具包
      • 初始化sdk
      • 概述
所有文档
menu
没有找到结果，请重新输入

多用户访问控制 IAM

  • 测试知识库SDK
  • 功能发布记录
  • 产品描述
    • 概念
    • 目前支持的产品线
    • 产品概述
    • 应用场景
    • 产品功能
    • 企业组织vs多用户访问控制
    • 系统限制
  • 操作记录
    • 操作记录（公测中）
  • API参考_IAM
    • 通用说明
    • 策略管理接口
    • 简介
    • 角色管理接口
    • 公共请求头与公共响应头
    • 数据类型
    • 组管理接口
    • 服务域名
    • 用户管理接口
    • 错误码
  • 产品公告
    • 【重要升级】百度智能云为所有用户开启登录保护MFA多因素认证通知
  • 快速入门
    • 创建子用户管理员
    • 创建用户组并授权
  • 典型实践
    • 用户管理与权限分配
    • 百度智能云合作伙伴开通子用户教程
  • 操作指南
    • 账户安全审计
    • 设置
    • 用户组管理
    • 消息中心
    • 外部账号接入
      • IAM用户联合
      • IAM角色联合
      • 联合登录概览
    • 角色管理
      • 相关概念
      • 常见场景
      • 管理角色
      • 使用角色
      • 常见问题
      • 创建角色
      • 概述
    • 用户异常行为分析（公测中）
      • 风险行为管理
    • 权限策略
      • 策略类型
      • 授权
      • 策略鉴权评估逻辑
      • 策略语法
      • 管理IAM策略
      • 基于标签授权与鉴权
      • 权限策略概述
    • 用户
      • 用户管理
      • 双因素验证
      • 子用户操作
  • API参考
    • 通用说明
    • 简介
    • 公共请求头与公共响应头
    • 数据类型
    • STS相关接口
    • 功能更新记录
    • 服务域名
    • 错误码
  • 常见问题
    • 子用户问题
    • 常见问题总览
    • 产品权限问题
  • 产品定价
    • 产品定价
  • SDK
    • Python-SDK
      • 策略管理接口
      • 角色管理接口
      • 版本变更记录
      • 组管理接口
      • 初始化
      • 用户管理接口
      • 安装SDK工具包
      • 错误码
      • 概述
    • Java-SDK
      • 策略管理接口
      • 角色管理接口
      • 版本变更记录
      • 组管理接口
      • 初始化
      • 用户管理接口
      • 安装SDK工具包
      • 错误码
      • 概述
    • Go-SDK
      • 策略管理接口
      • 角色管理接口
      • 版本变更记录
      • 组管理接口
      • 用户管理接口
      • 错误处理
      • 安装SDK工具包
      • 初始化sdk
      • 概述
  • 文档中心
  • arrow
  • 多用户访问控制IAM
  • arrow
  • API参考_IAM
  • arrow
  • 组管理接口
本页目录
  • 创建组
  • 查询组
  • 更新组
  • 删除组
  • 列举组
  • 添加用户到组
  • 从组内移除用户
  • 列举用户的组
  • 列举组内用户

组管理接口

更新时间：2025-08-21

创建组

接口描述

创建组。

请求结构

Plain Text 
1POST /v1/group HTTP/1.1
2Host: iam.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

名称 类型 位置 描述 是否必须
name String RequestBody参数 组名 是
description String RequestBody参数 组的描述 否

响应头域

除公共头域外，无其它特殊头域。

响应参数

GroupModel对象

请求示例

Plain Text 
1POST /v1/group HTTP/1.1
2Host: iam.bj.baidubce.com
3content-type: application/json
4Content-Length: 20
5Authorization: AuthorizationString
6
7{"name":"test_group"}

响应示例

Plain Text 
1HTTP/1.1 201 Created     
2Content-Type: application/json;charset=UTF-8     
3X-Bce-Request-Id: 8d51a788-e79d-4ced-a9e0-0662ec85b7f7     
4Server: BWS     
5
6{
7    "description": "",
8    "id": "d3f6fd54fe3643459109ea0675c295a8",
9    "createTime": "2019-06-06T08:18:34Z",
10    "name": "test_group"
11}

查询组

接口描述

查询组。

请求结构

Plain Text 
1GET /v1/group/{groupName} HTTP/1.1
2Host: iam.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

名称 类型 位置 描述 是否必须
groupName String URL参数 组名 是

响应头域

除公共头域外，无其它特殊头域。

响应参数

GroupModel对象

请求示例

Plain Text 
1GET /v1/group/test_group HTTP/1.1
2Host: iam.bj.baidubce.com
3Authorization: AuthorizationString

响应示例

Plain Text 
1HTTP/1.1 200 OK     
2Content-Type: application/json;charset=UTF-8     
3X-Bce-Request-Id: 8d51a788-e79d-4ced-a9e0-0662ec85b7f7     
4Server: BWS     
5
6{
7    "description": "",
8    "id": "d3f6fd54fe3643459109ea0675c295a8",
9    "createTime": "2019-06-06T08:18:34Z",
10    "name": "test_group"
11}

更新组

接口描述

更新组。

请求结构

Plain Text 
1PUT /v1/group/{groupName} HTTP/1.1
2Host: iam.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

名称 类型 位置 描述 是否必须
groupName String URL参数 组名 是
name String RequestBody参数 更新后的组名 否
description String RequestBody参数 组的描述 否

响应头域

除公共头域外，无其它特殊头域。

响应参数

GroupModel对象

请求示例

Plain Text 
1PUT /v1/group/test_group HTTP/1.1
2Host: iam.bj.baidubce.com
3content-type: application/json
4Content-Length: 39
5Authorization: AuthorizationString
6
7{"description":"update for test group"}

响应示例

Plain Text 
1HTTP/1.1 200 OK     
2Content-Type: application/json;charset=UTF-8     
3X-Bce-Request-Id: 8d51a788-e79d-4ced-a9e0-0662ec85b7f7     
4Server: BWS     
5
6{
7    "description": "update for test group",
8    "id": "d3f6fd54fe3643459109ea0675c295a8",
9    "createTime": "2019-06-06T08:18:34Z",
10    "name": "test_group"
11}

删除组

接口描述

删除组。

说明：删除组前需要将子用户从组内全部移除，并解除所有权限策略的关联。

请求结构

Plain Text 
1DELETE /v1/group/{groupName} HTTP/1.1
2Host: iam.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

名称 类型 位置 描述 是否必须
groupName String URL参数 组名 是

响应头域

除公共头域外，无其它特殊头域。

响应参数

无。

请求示例

Plain Text 
1DELETE /v1/group/test_group HTTP/1.1
2Host: iam.bj.baidubce.com
3Authorization: AuthorizationString

响应示例

Plain Text 
1HTTP/1.1 204 No Content
2X-Bce-Request-Id: 8d51a788-e79d-4ced-a9e0-0662ec85b7f7
3Server: BWS

列举组

接口描述

列举组。

请求结构

Plain Text 
1GET /v1/group HTTP/1.1
2Host: iam.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

无。

响应头域

除公共头域外，无其它特殊头域。

响应参数

名称 类型 描述
groups List<GroupModel> 组对象的列表

请求示例

Plain Text 
1GET /v1/group HTTP/1.1
2Host: iam.bj.baidubce.com
3Authorization: AuthorizationString

响应示例

Plain Text 
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3X-Bce-Request-Id: 8d51a788-e79d-4ced-a9e0-0662ec85b7f7
4Server: BWS
5
6{
7    "groups": [
8        {
9            "description": "update for test group",
10            "id": "d3f6fd54fe3643459109ea0675c295a8",
11            "createTime": "2019-06-06T08:18:34Z",
12            "name": "test_group"
13        }
14    ]
15}

添加用户到组

接口描述

添加用户到组。

请求结构

Plain Text 
1PUT /v1/group/{groupName}/user/{userName} HTTP/1.1
2Host: iam.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

名称 类型 位置 描述 是否必须
userName String URL参数 用户名 是
groupName String URL参数 组名 是

响应头域

除公共头域外，无其它特殊头域。

响应参数

无。

请求示例

Plain Text 
1PUT /v1/group/test_group/user/test-user HTTP/1.1
2Host: iam.bj.baidubce.com
3Authorization: AuthorizationString

响应示例

Plain Text 
1HTTP/1.1 204 No Content
2Content-Type: application/json;charset=UTF-8
3X-Bce-Request-Id: 8d51a788-e79d-4ced-a9e0-0662ec85b7f7
4Server: BWS

从组内移除用户

接口描述

从组内移除用户。

请求结构

Plain Text 
1DELETE /v1/group/{groupName}/user/{userName} HTTP/1.1
2Host: iam.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

名称 类型 位置 描述 是否必须
userName String URL参数 用户名 是
groupName String URL参数 组名 是

响应头域

除公共头域外，无其它特殊头域。

响应参数

无。

请求示例

Plain Text 
1DELETE /v1/group/test_group/user/test-user HTTP/1.1
2Host: iam.bj.baidubce.com
3Authorization: AuthorizationString

响应示例

Plain Text 
1HTTP/1.1 204 No Content
2Content-Type: application/json;charset=UTF-8
3X-Bce-Request-Id: 8d51a788-e79d-4ced-a9e0-0662ec85b7f7
4Server: BWS

列举用户的组

接口描述

列举用户所在的组。

请求结构

Plain Text 
1GET /v1/user/{userName}/group HTTP/1.1
2Host: iam.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

名称 类型 位置 描述 是否必须
userName String URL参数 用户名 是

响应头域

除公共头域外，无其它特殊头域。

响应参数

名称 类型 描述
groups List<GroupModel> 组对象的列表

请求示例

Plain Text 
1GET /v1/user/test-user/group HTTP/1.1
2Host: iam.bj.baidubce.com
3Authorization: AuthorizationString

响应示例

Plain Text 
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3X-Bce-Request-Id: 8d51a788-e79d-4ced-a9e0-0662ec85b7f7
4Server: BWS
5
6{
7    "groups": [
8        {
9            "description": "",
10            "id": "5cf62eee890146ed8116f6b449268f33",
11            "name": "test_group"
12        }
13    ]
14}

列举组内用户

接口描述

列举组内的用户。

请求结构

Plain Text 
1GET /v1/group/{groupName}/user HTTP/1.1
2Host: iam.bj.baidubce.com
3Authorization: authorization string

请求头域

除公共头域外，无其它特殊头域。

请求参数

名称 类型 位置 描述 是否必须
groupName String URL参数 组名 是

响应头域

除公共头域外，无其它特殊头域。

响应参数

名称 类型 描述
users List<UserModel> 用户对象的列表

请求示例

Plain Text 
1GET /v1/group/test_group/user
2Host: iam.bj.baidubce.com
3Authorization: AuthorizationString

响应示例

Plain Text 
1HTTP/1.1 200 OK
2Content-Type: application/json;charset=UTF-8
3X-Bce-Request-Id: 8d51a788-e79d-4ced-a9e0-0662ec85b7f7
4Server: BWS
5
6{
7    "users": [
8        {
9            "id": "f4225c39ba2247b692eec7b461835aa1",
10            "createTime": "2019-06-06T03:42:13Z",
11            "name": "test-user"
12        }
13    ]
14}

上一篇
数据类型
下一篇
服务域名