查询用户列表

功能介绍

该接口用于查询用户列表。

URI

• URI格式

  GET /v3/users

• 参数说明

  参数	是否必选	类型	说明
  domain_id	否	String	用户所属的domain的ID。
  enabled	否	String	是否启用用户，true为启用，false为停用，默认为true。
  name	否	String	用户名。
  password_expires_at	否	String	密码过期时间，格式为：password_expires_at={operator}:{timestamp}。 示例： password_expires_at=lt:2016-12-08T22:02:00Z operator取值范围：lt，lte，gt，gte，eq，neq lt：过期时间小于timestamp lte：过期时间小于等于timestamp gt：过期时间大于timestamp gte：过期时间大于等于timestamp eq：过期时间等于timestamp neq：过期时间不等于timestamp timestamp格式为YYYY-MM-DDTHH:mm:ssZ

请求

• Request Header参数说明

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

• 请求样例

  curl -i -k -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf8' -H "X-Auth-Token:$token" -X GET https://sample.domain.com/v3/users

响应

• Response Body参数说明

  参数	是否必选	类型	说明
  users	是	JSONArray	用户列表。
  links	是	JSONObject	用户资源的链接。

• user格式说明

  参数	是否必选	类型	说明
  description	是	String	用户的描述。
  domain_id	是	String	用户所属租户的ID。
  enabled	是	Boolean	用户是否启用，true表示启用，false表示停用，默认为true。
  id	是	String	用户的ID。
  links	是	JSONObject	用户资源的链接。
  name	是	String	用户的名称。
  password_expires_at	是	String	密码过期时间（UTC时间），“null”表示密码不过期。
  pwd_status	否	Boolean	密码状态，true：需要修改密码，false：正常。
  default_project_id	否	String	用户登录控制台后默认跳转的项目ID。
  last_project_id	否	String	用户退出系统前，在控制台最后访问的项目的ID。
  email	否	String	IAM用户邮箱。

• 响应样例

  {
      "users": [{
          "name": "username",
          "links": {
              "self": "https://sample.domain.com/v3/users/6d8b04e3bf99445b8f76300xxx"
          },
          "description": "1234",
          "domain_id": "88b16b6440684467b8825d7xxx",
          "enabled": false,
          "id": "6d8b04e3bf99445b8f763009xxx",
          "email" : ""
          "default_project_id": "263fd9",
          "password_expires_at": "2016-12-07T00:00:00.000000Z"，
          "pwd_status": true,
          
          "last_project_id": ""
      }],
      "links": {
          "self": "https://sample.domain.com/v3/users?domain_id=88b16b6440684467b882xxx154d8&enabled=false",
          "previous": null,
          "next": null
      }
  }

状态码