创建用户组
功能介绍
在指定的身份源中创建一个IAM身份中心用户组。
URI
POST /v1/identity-stores/{identity_store_id}/groups
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
identity_store_id |
是 |
String |
身份源的全局唯一标识符（ID）。 最小长度：12 最大长度：12 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Security-Token |
否 |
String |
如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。 最大长度：2048 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
description |
否 |
String |
用户组描述。 最小长度：0 最大长度：1024 |
|
display_name |
是 |
String |
用户组显示名称。 最小长度：1 最大长度：1024 |
响应参数
状态码： 201
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
group_id |
String |
身份源中IAM身份中心用户组的全局唯一标识符（ID）。 最小长度：1 最大长度：47 |
|
identity_store_id |
String |
身份源的全局唯一标识符（ID）。 最小长度：1 最大长度：36 |
状态码： 400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 |
|
error_msg |
String |
错误信息。 |
|
request_id |
String |
请求ID。 |
|
encoded_authorization_message |
String |
鉴权信息。 |
状态码： 403
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 |
|
error_msg |
String |
错误信息。 |
|
request_id |
String |
请求ID。 |
|
encoded_authorization_message |
String |
鉴权信息。 |
状态码： 409
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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"
}
状态码
请参见状态码。
错误码
请参见错误码。
