*View user list (soon to be scrapped)
Tip: This interface will be deprecated soon, but it will work fine until it is deprecated. It is recommended that you use the optimized interface GET /auth/v2/users, which supports filtering of users by status on top of GET /auth/v1/users and has better performance.
Requests
HTTP request
GET /auth/v1/users
Fetch users
Responses
Content-Type
application/json
Status code: 200
OK
Sample response
user list
{
"items": [
{
"apiVersion": "auth.alauda.io/v1",
"kind": "User",
"metadata": {
"annotations": {
"cpaas.io/display-name": "areslwrgs-bot"
},
"creationTimestamp": "2021-06-21T08:59:42Z",
"generation": 1,
"labels": {
"auth.cpaas.io/user.connector_id": "local",
"auth.cpaas.io/user.connector_type": "local",
"auth.cpaas.io/user.email": "84a4eeac2a6efeba8b4a3c0fd044069b",
"auth.cpaas.io/user.state": "active",
"auth.cpaas.io/user.username": "",
"auth.cpaas.io/user.valid": "true"
},
"name": "84a4eeac2a6efeba8b4a3c0fd044069b",
"resourceVersion": "202851",
"selfLink": "/apis/auth.alauda.io/v1/users/84a4eeac2a6efeba8b4a3c0fd044069b",
"uid": "7bae9bd0-7d6e-4c32-87b9-163cc17c0e09"
},
"spec": {
"connector_name": "local",
"connector_type": "local",
"email": "areslwrgs-bot@acp.io",
"groups": [
"ungrouped"
],
"is_admin": false,
"mail": "areslwrgs-bot@acp.io",
"state": "active",
"username": "areslwrgs-bot",
"valid": true
}
},
{
"apiVersion": "auth.alauda.io/v1",
"kind": "User",
"metadata": {
"annotations": {
"cpaas.io/display-name": "admin"
},
"creationTimestamp": "2021-06-21T05:27:22Z",
"generation": 59,
"labels": {
"auth.cpaas.io/user.connector_id": "local",
"auth.cpaas.io/user.connector_type": "local",
"auth.cpaas.io/user.email": "8afe307d054f1e96ce2e3d10aa374162",
"auth.cpaas.io/user.state": "active",
"auth.cpaas.io/user.username": "",
"auth.cpaas.io/user.valid": "true"
},
"name": "8afe307d054f1e96ce2e3d10aa374162",
"resourceVersion": "10602022",
"selfLink": "/apis/auth.alauda.io/v1/users/8afe307d054f1e96ce2e3d10aa374162",
"uid": "9c64cb40-022d-484a-ae34-8d43b7fd2ccd"
},
"spec": {
"connector_name": "local",
"connector_type": "local",
"email": "admin@cpaas.io",
"groups": [
"ungrouped"
],
"is_admin": true,
"last_login_time": "2021-06-30T08:38:32Z",
"mail": "admin@cpaas.io",
"state": "active",
"username": "admin",
"valid": true
}
}
],
"kind": "UserList",
"metadata": {},
"total": 2
}Parameters
| Name | Type | Description |
|---|---|---|
| items | array |
Path: items |
| items[] | object |
user definition
Path: items[] |
| items[].apiVersion | string | See common parameters |
| items[].kind | string | See common parameters |
| items[].metadata | object | See common parameters |
| items[].spec | object |
user spec
Path: items[].spec |
| spec.connector_name | string |
connector name
Path: items[].spec.connector_name |
| spec.connector_type | string |
connector type
Path: items[].spec.connector_type |
| spec.email | string |
email
Path: items[].spec.email |
| spec.groups | array |
groups
Path: items[].spec.groups |
| spec.groups[] | string |
group
Path: items[].spec.groups[] |
| spec.is_admin | boolean |
check user is admin or not
Path: items[].spec.is_admin |
| spec.username | string |
username
Path: items[].spec.username |
| spec.valid | boolean |
describe user is valid or not
Path: items[].spec.valid |
| kind | string | See common parameters |
| metadata | object | See common parameters |