Creating a User Group

Function

This API is used to create a user group.

URI

POST /v3/groups

Request Parameters

• Parameters in the request header

  Parameter	Mandatory	Type	Description
  Content-Type	Yes	String	Fill application/json;charset=utf8 in this field.
  X-Auth-Token	Yes	String	Authenticated token with the Security Administrator permission.

• Parameters in the request body

  Parameter	Mandatory	Type	Description
  description	No	String	Description for a user group. The length is less than or equal to 255 characters.
  domain_id	No	String	ID of the domain to which a user group belongs.
  name	Yes	String	Name of a user group. The length is less than or equal to 64 characters.

• Example request

  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 Parameters

• Parameters in the response body

  Parameter	Mandatory	Type	Description
  description	Yes	String	Description for a user group.
  domain_id	Yes	String	ID of the domain to which a user group belongs.
  id	Yes	String	ID of a user group.
  links	Yes	JSON object	Links to a user group.
  name	Yes	String	Name of a user group.

• Example response

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

Status Codes