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 llamar 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 finales de IAM, consulte Regions 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 agencia. |
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 |
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 |
Hora UTC cuando caducará la contraseña. null indica que la contraseña tiene validez ilimitada. |
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 |
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. |
Solicitud de ejemplo
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.