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
