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.
