Listado de usuarios de IAM
Función
Esta API se proporciona para que el administrador muestre una lista de todos los usuarios de IAM.
Se puede invocar a la API utilizando tanto el punto de conexión global como los puntos de conexión específicos de la región. Para los puntos de conexión de IAM, consulte Regiones y puntos de conexión.
URI
GET /v3/users
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| domain_id | No | String | ID de cuenta. Para obtener más información sobre cómo obtener el ID de cuenta, consulte Obtención de información de cuenta, usuario de IAM, grupo, proyecto, región y delegación. |
| enabled | No | Boolean | Habilitación del estado del usuario de IAM. true (valor predeterminado) indica que el usuario está habilitado. false indica que el usuario está deshabilitado. |
| name | No | String | Nombre de usuario de IAM. |
| password_expires_at | No | String | Tiempo de caducidad de la contraseña. El valor null indica que la contraseña nunca caducará. Formato de contraseña: password_expires_at={operator}:{timestamp}. Formato de marca de tiempo: YYYY-MM-DDTHH:mm:ssZ. Ejemplo: password_expires_at=lt:2016-12-08T22:02:00Z NOTA:
|
Parámetros de solicitud
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| Content-Type | Sí | String | Rellene application/json;charset=utf8 en este campo. |
| X-Auth-Token | Sí | String | Token de acceso emitido a un usuario para que porte su identidad y permisos. Para obtener más información sobre los permisos requeridos por el token, consulte Acciones. |
Parámetros de respuesta
| Parámetro | Tipo | Descripción |
|---|---|---|
| Object | Información de enlace de recurso. | |
| Array of objects | Información del usuario de IAM. |
| Parámetro | Tipo | Descripción |
|---|---|---|
| self | String | Enlace de recurso. |
| previous | String | Enlace de recurso anterior. |
| next | String | Siguiente enlace de recurso. |
| Parámetro | Tipo | Descripción |
|---|---|---|
| name | String | Nombre de usuario de IAM. |
| Object | Información de enlace de recursos de usuario de IAM. | |
| domain_id | String | ID de la cuenta a la que pertenece el usuario de IAM. |
| enabled | Boolean | Habilitación del estado del usuario de IAM. true (valor predeterminado) indica que el usuario está habilitado. false indica que el usuario está deshabilitado. |
| id | String | ID de usuario de IAM. |
| password_expires_at | String | Tiempo de caducidad de la contraseña del usuario de IAM. Si este parámetro se establece en null, la contraseña nunca caducará. NOTA: El valor es una hora UTC en el formato AAAA-MM-DDTHH:mm:ss.ssssssZ, por ejemplo, 2023-06-28T08:56:33.710000Z. Para obtener más información sobre los formatos de fecha y hora, consulte ISO-8601. |
| description | String | Descripción del usuario de IAM. |
| pwd_status | Boolean | Estado de la contraseña. true significa que la contraseña debe cambiarse, y false significa que la contraseña es normal. |
| last_project_id | String | ID del proyecto al que el usuario de IAM accedió por última vez antes de salir del sistema. |
| pwd_strength | String | Seguridad de la contraseña. El valor puede ser high, mid, o low. |
Solicitud de ejemplo
Solicitud de listado de usuarios de IAM como administrador
GET https://iam.myhuaweicloud.com/v3/users 
Para reducir el rango de consulta, agregue un parámetro de ruta. Por ejemplo:
GET https://iam.myhuaweicloud.com/v3/users?domain_id=d78cbac186b744899480f25bd02...&enabled=true Ejemplo de respuesta
Código de estado: 200
La solicitud se ha realizado correctamente.
{
"links": {
"next": null,
"previous": null,
"self": "https://iam.myhuaweicloud.com/v3/users"
},
"users": [
{
"domain_id": "d78cbac186b744899480f25bd02...",
"name": "IAMUserA",
"description": "IAMDescriptionA",
"password_expires_at": null,
"links": {
"next": null,
"previous": null,
"self": "https://iam.myhuaweicloud.com/v3/users/07667db96a00265f1fc0c003a3..."
},
"id": "07667db96a00265f1fc0c003a...",
"enabled": true
},
{
"pwd_status": true,
"domain_id": "d78cbac186b744899480f25bd02...",
"last_project_id": "065a7c66da0010992ff7c0031e5a...",
"name": "IAMUserB",
"description": "IAMDescriptionB",
"password_expires_at": null,
"links": {
"next": null,
"previous": null,
"self": "https://iam.myhuaweicloud.com/v3/users/07609fb9358010e21f7bc003751c7..."
},
"id": "07609fb9358010e21f7bc003751c7...",
"enabled": true
}
]
} Códigos de estado
| Código de estado | Descripción |
|---|---|
| 200 | La solicitud se ha realizado correctamente. |
| 400 | Parámetros no válidos. |
| 401 | Error de autenticación. |
| 403 | Acceso denegado. |
| 404 | No se puede encontrar el recurso solicitado. |
| 405 | El método especificado en la solicitud no está permitido para el recurso solicitado. |
| 413 | Se produce un conflicto de recursos. |
| 500 | La entidad solicitada es demasiado grande. |
| 503 | Servicio no disponible. |
Códigos de error
Ninguno
