更新时间:2024-07-25 GMT+08:00

创建用户组

功能介绍

该接口提供创建用户组的功能。

URI

POST /v3/groups

请求

  • Request Header参数说明

    参数

    是否必选

    类型

    说明

    Content-Type

    String

    该字段内容填为“application/json;charset=utf8”

    X-Auth-Token

    String

    已认证的拥有Security Administrator权限的token。

  • Request Body参数说明

    参数

    是否必选

    类型

    说明

    description

    String

    用户组的描述,长度小于等于255字符。

    domain_id

    String

    用户组所属domain的ID。

    name

    String

    用户组的名称,长度小于等于64字符。

  • 请求样例
    curl -i -k -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf8' -H "X-Auth-Token:$token" -X POST -d'{"group": {"description": "Contract developers","domain_id": "d54061ebcb5145dd814f8eb3fe9b7ac0","name": "jixiang2"}}' https://sample.domain.com/v3/groups

响应

  • Response Body参数说明

    参数

    是否必选

    类型

    说明

    description

    String

    用户组的描述。

    domain_id

    String

    用户组所属domain的ID。

    id

    String

    用户组的ID。

    links

    JSONObject

    用户组的链接。

    name

    String

    用户组的名称。

  • 响应样例
    {
        "group":{ 
            "domain_id":"d54061ebcb5145dd814f8eb3fe9b7ac0",
            "description":"Contract developers",
            "id":"ab9f261180d746ef8624beb5ae39b5aa",
            "links":{
                "self":"https://sample.domain.com/v3/groups/ab9f261180d746ef8624beb5ae39b5aa"
            },
            "name":"abcdef"
        }
    }

状态码

状态码

说明

201

创建成功。

400

参数无效。

401

认证失败。

403

没有操作权限。

409

资源冲突。