Modificación de la información de usuario
Función
Esta API se proporciona para que el administrador modifique la información del usuario 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.
Restricciones
Esta API no se puede utilizar para cambiar el número de teléfono móvil y la dirección de correo electrónico de un usuario de IAM. Para cambiar el número de teléfono móvil y la dirección de correo electrónico, utilice la API descrita en Modificación de la información del usuario de IAM (recomendado).
URI
PATCH /v3/users/{user_id}
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| user_id | Sí | String | ID de usuario de IAM. Para obtener más información sobre cómo obtener un ID de usuario, consulte Obtención de información de cuenta, usuario de IAM, grupo, proyecto, región y delegación. |
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 acreditar su identidad y sus permisos. Para obtener más información sobre los permisos requeridos por el token, consulte Acciones. |
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| Sí | Object | Información del usuario de IAM. |
| Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
| domain_id | No | String | ID de la cuenta a la que pertenece el usuario de IAM. |
| name | No | String | Nuevo nombre de usuario de IAM, que consta de 1 a 32 caracteres. Puede contener letras, dígitos, espacios, guiones (-), guiones bajos (_) y puntos (.) y no puede comenzar con un dígito o espacio. |
| password | No | String | Nueva contraseña, que debe cumplir con los siguientes requisitos:
|
| 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. |
| description | No | String | Descripción del usuario de IAM. |
| pwd_status | No | Boolean | Estado de la contraseña. true significa que la contraseña debe cambiarse, y false significa que la contraseña es normal. |
Parámetros de respuesta
| Parámetro | Tipo | Descripción |
|---|---|---|
| Object | Información del usuario de IAM. |
| Parámetro | Tipo | Descripción |
|---|---|---|
| name | String | Nombre 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. 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. |
| Object | Otra información sobre el usuario de IAM. | |
| Object | Información de enlace de recursos de usuario de IAM. |
| Parámetro | Tipo | Descripción |
|---|---|---|
| description | String | Descripción del usuario de IAM. |
| pwd_status | Boolean | Password status. 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. |
Solicitud de ejemplo
Solicitud de un administrador para cambiar la contraseña del usuario de IAM llamado IAMUser a IAMPassword@
PATCH https://iam.myhuaweicloud.com/v3/users/{user_id} {
"user": {
"domain_id": "d78cbac186b744899480f25bd02...",
"name": "IAMUser",
"password": "IAMPassword@",
"enabled": true,
"pwd_status": false,
"description": "IAMDescription"
}
} Ejemplo de respuesta
Código de estado: 200
La solicitud se ha realizado correctamente.
{
"user": {
"pwd_status": false,
"description": "IAMDescription",
"name": "IAMUser",
"extra": {
"pwd_status": false,
"description": "IAMDescription",
},
"enabled": true,
"links": {
"self": "https://iam.myhuaweicloud.com/v3/users/07609fb9358010e21f7bc003751c7..."
},
"id": "07609fb9358010e21f7bc003751c7...",
"domain_id": "d78cbac186b744899480f25bd02..."
}
} 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. |
| 409 | Se produce un conflicto de recursos. |
| 413 | La entidad solicitada es demasiado grande. |
| 500 | Error de servidor interno. |
| 503 | Servicio no disponible. |
Códigos de error
Para obtener más información, consulte Códigos de error.
