文档首页/ IAM 身份中心/ API参考/ API/ 用户组管理/ 创建用户组
更新时间：2024-04-29 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建用户组

功能介绍

在指定的身份源中创建一个IAM身份中心用户组。

URI

POST /v1/identity-stores/{identity_store_id}/groups

表1 路径参数

参数

是否必选

参数类型

描述

identity_store_id

是

String

身份源的全局唯一标识符（ID）。

最小长度：12

最大长度：12

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Security-Token

否

String

如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。

最大长度：2048
表3 请求Body参数

参数

是否必选

参数类型

描述

description

否

String

用户组描述。

最小长度：0

最大长度：1024

display_name

是

String

用户组显示名称。

最小长度：1

最大长度：1024

响应参数

状态码： 201

表4 响应Body参数

参数

参数类型

描述

group_id

String

身份源中IAM身份中心用户组的全局唯一标识符（ID）。

最小长度：1

最大长度：47

identity_store_id

String

身份源的全局唯一标识符（ID）。

最小长度：1

最大长度：36

状态码： 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误信息。

request_id

String

请求ID。

encoded_authorization_message

String

鉴权信息。

状态码： 403

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误信息。

request_id

String

请求ID。

encoded_authorization_message

String

鉴权信息。

状态码： 409

表7 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误信息。

request_id

String

请求ID。

encoded_authorization_message

String

鉴权信息。

请求示例

在指定的身份源中创建一个IAM身份中心用户组。

POST https://{hostname}/v1/identity-stores/{identity_store_id}/groups

{
  "description" : "示例用户组",
  "display_name" : "用户组名g1"
}

响应示例

状态码： 201

Successful

{
  "group_id" : "0efaa0db-6aa4-7aaa-6aa5-c222aaaaf31a",
  "identity_store_id" : "d-a00aaaa33f"
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题： 用户组管理

相关文档