创建用户

功能介绍

该接口用于在某一租户下创建用户。

URI

POST /v3/users

请求

• Request Header参数说明

  参数	是否必选	类型	说明
  Content-Type	是	String	该字段内容填为“application/json;charset=utf8”。
  X-Auth-Token	是	String	已认证的拥有Security Administrator权限的token。

• Request Body参数说明

  表1 user格式说明

  参数	是否必选	参数类型	描述
  user	是	Object	用户信息。

  表2 user

  参数	是否必选	类型	说明
  name	是	String	用户名，长度5~32之间，首位不能为数字，特殊字符只能包含“下划线_、中划线-、和空格”。
  domain_id	否	String	用户所在domain的ID。
  enabled	否	Boolean	是否启用用户。 true为启用，false为停用，默认为true。
  password	否	String	用户密码。 至少包含以下四种字符中的两种： 大写字母、小写字母、数字和特殊字符； 不能与用户名以及用户名的倒序； 不能包含手机号和邮箱； 必须满足账户设置中密码策略的要求；
  default_project_id	否	String	用户默认的project ID。
  description	否	String	用户的描述信息。

• 请求样例

  1.按照以下模板创建临时文件${filename}.json。${filename}是临时文件名，用户可以自定义。
  {
      "user": {
          "default_project_id": "acf2ffabba974fae8f30378ffde2cfa6",
          "domain_id": "88b16b6440684467b8825d7d96e154d8",
          "enabled": true,
          "name": "jamesdoe",
          "password": "********"
      }
  }
  2.在${filename}.json文件同目录下，执行如下curl命令。
  curl -i -k -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf8' -H "X-Auth-Token:$token" -X POST -d @${filename}.json https://sample.domain.com/v3/users
  3.在${filename}.json文件同目录下，执行如下命令删除临时文件${filename}.json。
  rm ${filename}.json

响应

• Response Body参数说明

  参数	是否必选	类型	说明
  user	是	JSONObject	user对象。

• user格式说明

  参数	是否必选	类型	说明
  enabled	是	Boolean	是否启用用户。 true为启用，false为停用，默认为true。
  id	是	String	用户ID。
  domain_id	是	String	用户所在domain的ID。
  name	是	String	用户名称。
  links	是	JSONObject	用户的资源链接。
  default_project_id	否	String	用户默认的project ID。
  password_expires_at	是	String	密码过期时间（UTC时间），“null”表示密码不过期。

• 响应样例

  {
      "user": {
          "name": "jamesdoe",
          "links": {
              "self": "https://sample.domain.com/v3/users/614d1d2fb86940faab8f350bf1b9dbac"
          },
          "domain_id": "88b16b6440684467b8825d7d96e154d8",
          "enabled": true,
          "id": "614d1d2fb86940faab8f350bf1b9dbac",
          "default_project_id": "acf2ffabba974fae8f30378ffde2cfa6",
          "password_expires_at": null
      }
  }

状态码