Modificación de la información del usuario de IAM (recomendado)
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.
URI
PUT /v3.0/OS-USER/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 con permisos de Security Administrator. |
Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
Sí | Object | Información del usuario de IAM. |
Parámetro | Obligatorio | Tipo | Descripción |
|---|---|---|---|
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 | Contraseña del usuario. La contraseña debe cumplir los siguientes requisitos:
|
No | String | Dirección de correo electrónico, que no puede contener más de 255 caracteres. | |
areacode | No | String | Código de país. El código de país debe usarse junto con un número de teléfono móvil. |
phone | No | String | Nuevo número de móvil, que puede contener un máximo de 32 dígitos. El número de móvil debe usarse junto con un código de país. |
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. |
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. |
xuser_type | No | String | Tipo del usuario IAM en el sistema externo. El tipo de usuario puede contener un máximo de 64 caracteres. xuser_type debe usarse junto con xuser_id y se verificará en base a xaccount_type y xdomain_type de la misma cuenta. NOTA: Un sistema externo se refiere a un sistema de gestión empresarial conectado a Huawei Cloud. Los parámetros xaccount_type, xaccount_id, xdomain_type, xdomain_id, xuser_type, y xuser_id no se pueden obtener de Huawei Cloud. Póngase en contacto con el administrador de la empresa. |
xuser_id | No | String | ID del usuario de IAM en el sistema externo. El ID de usuario puede contener un máximo de 128 caracteres y debe usarse junto con xuser_type. Debido a la latencia, es posible que la consola IAM no pueda mostrar el ID de identidad externo que ha establecido en tiempo real. Actualice la página más tarde. NOTA: Un sistema externo se refiere a un sistema de gestión empresarial conectado a Huawei Cloud. Los parámetros xaccount_type, xaccount_id, xdomain_type, xdomain_id, xuser_type, y xuser_id no se pueden obtener de Huawei Cloud. Póngase en contacto con el administrador de la empresa. |
access_mode | No | String | Tipo de acceso del usuario IAM.
|
description | No | String | Descripción del usuario de IAM. |
Parámetros de respuesta
Parámetro | Tipo | Descripción |
|---|---|---|
Object | Información del usuario de IAM. |
Parámetro | Tipo | Descripción |
|---|---|---|
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. |
xuser_id | String | ID del usuario de IAM en el sistema externo. NOTA: Un sistema externo se refiere a un sistema de gestión empresarial conectado a Huawei Cloud. Los parámetros xaccount_type, xaccount_id, xdomain_type, xdomain_id, xuser_type, y xuser_id no se pueden obtener de Huawei Cloud. Póngase en contacto con el administrador de la empresa. |
xuser_type | String | Tipo del usuario IAM en el sistema externo. NOTA: Un sistema externo se refiere a un sistema de gestión empresarial conectado a Huawei Cloud. Los parámetros xaccount_type, xaccount_id, xdomain_type, xdomain_id, xuser_type, y xuser_id no se pueden obtener de Huawei Cloud. Póngase en contacto con el administrador de la empresa. |
access_mode | String | Tipo de acceso del usuario IAM.
|
description | String | Descripción del usuario de IAM. |
name | 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. |
phone | String | Nuevo número de móvil, que puede contener un máximo de 32 dígitos. El número de móvil debe usarse junto con un código de país. |
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. |
areacode | String | Código de país. |
String | Nueva dirección de correo electrónico. | |
id | String | ID de usuario de IAM. |
Object | Información de enlace de recursos de usuario de IAM. | |
password_expires_at | String | Tiempo de caducidad de la contraseña. Este parámetro no se devolverá si su valor es null. 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. |
Solicitud de ejemplo
Solicitud de un administrador para modificar la información de un usuario de IAM llamado IAMUser: cambie la dirección de correo electrónico a IAMEmail@huawei.com, el número de móvil a 085212345678910 y la contraseña a IAMPassword@
PUT https://iam.myhuaweicloud.com/v3.0/OS-USER/users/{user_id} {
"user": {
"email": "IAMEmail@huawei.com",
"areacode": "0852",
"phone": "12345678910",
"enabled": true,
"name": "IAMUser",
"password": "IAMPassword@",
"pwd_status": false,
"xuser_type": "",
"xuser_id": "",
"access_mode" : "default",
"description": "IAMDescription"
}
} Example Response
Status code: 200
La solicitud se ha realizado correctamente.
{
"user": {
"description": "IAMDescription",
"areacode": "0852",
"enabled": true,
"pwd_status": false,
"xuser_id": "",
"access_mode" : "default",
"domain_id": "d78cbac186b744899480f25bd0...",
"phone": "12345678910",
"name": "IAMUser",
"links": {
"self": "https://iam.myhuaweicloud.com/3.0/OS-USER/users/076934ff9f0010cd1f0bc003..."
},
"id": "076934ff9f0010cd1f0bc0031019...",
"xuser_type": "",
"email": "IAMEmail@huawei.com"
}
} 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.
