管理员修改IAM用户信息（推荐）
调试
您可以在API Explorer中调试该接口。
URI
PUT /v3.0/OS-USER/users/{user_id}
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
user_id |
是 |
String |
待修改信息的IAM用户ID，获取方式请参见：获取账号、IAM用户、项目、用户组、区域、委托的名称和ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
Content-Type |
是 |
String |
该字段内容填为“application/json;charset=utf8”。 |
X-Auth-Token |
是 |
String |
拥有Security Administrator权限的token。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
是 |
Object |
IAM用户信息。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
name |
否 |
String |
新IAM用户名，长度1~32之间，只能包含如下字符：大小写字母、空格、数字或特殊字符（-_.）且不能以数字或空格开头。 |
password |
否 |
String |
IAM用户新密码。
|
否 |
String |
IAM用户新邮箱，需符合邮箱格式，长度小于等于255字符。 |
|
areacode |
否 |
String |
国家码。必须与手机号同时存在。中国大陆为“0086”。 |
phone |
否 |
String |
IAM用户新手机号，纯数字，长度小于等于32位。必须与国家码同时存在。 |
enabled |
否 |
Boolean |
是否启用IAM用户。true为启用，false为停用，默认为true。 |
pwd_status |
否 |
Boolean |
IAM用户密码状态。true：需要修改密码，false：正常。 |
xuser_type |
否 |
String |
IAM用户在外部系统中的类型。长度小于等于64位。xuser_type如果存在，则需要与同一租户中的xaccount_type、xdomain_type校验，须与xuser_id同时存在。
说明：
外部系统指与华为云对接的外部企业管理系统，xaccount_type、xaccount_id、xdomain_type、xdomain_id、xuser_type、xuser_id等参数值，无法在华为云获取，请咨询企业管理员。 |
xuser_id |
否 |
String |
IAM用户在外部系统中的ID。长度小于等于128位，必须与xuser_type同时存在。使用API设置外部身份ID后，由于时延IAM控制台暂无法实时显示，请稍后刷新查看。
说明：
外部系统指与华为云对接的外部企业管理系统，xaccount_type、xaccount_id、xdomain_type、xdomain_id、xuser_type、xuser_id等参数值，无法在华为云获取，请咨询企业管理员。 |
access_mode |
否 |
String |
IAM用户访问方式。
|
description |
否 |
String |
IAM用户新描述信息。 |
响应参数
参数 |
参数类型 |
描述 |
|---|---|---|
Object |
IAM用户信息。 |
参数 |
参数类型 |
描述 |
|---|---|---|
pwd_status |
Boolean |
IAM用户密码状态。true：需要修改密码，false：正常。 |
xuser_id |
String |
IAM用户在外部系统中的ID。
说明：
外部系统指与华为云对接的外部企业管理系统，xaccount_type、xaccount_id、xdomain_type、xdomain_id、xuser_type、xuser_id等参数值，无法在华为云获取，请咨询企业管理员。 |
xuser_type |
String |
IAM用户在外部系统中的类型。
说明：
外部系统指与华为云对接的外部企业管理系统，xaccount_type、xaccount_id、xdomain_type、xdomain_id、xuser_type、xuser_id等参数值，无法在华为云获取，请咨询企业管理员。 |
access_mode |
String |
IAM用户访问方式。
|
description |
String |
IAM用户的新描述信息。 |
name |
String |
IAM用户新用户名，长度1~32之间，只能包含如下字符：大小写字母、空格、数字或特殊字符（-_.）且不能以数字或空格开头。 |
phone |
String |
IAM用户新手机号，纯数字，长度小于等于32位。必须与国家码同时存在。 |
domain_id |
String |
IAM用户所属账号ID。 |
enabled |
Boolean |
是否启用IAM用户。true为启用，false为停用，默认为true。 |
areacode |
String |
国家码。中国大陆为“0086”。 |
String |
IAM用户新邮箱。 |
|
id |
String |
IAM用户ID。 |
Object |
IAM用户的资源链接信息。 |
|
password_expires_at |
String |
密码过期时间。当值为“null”时，不返回。
说明：
UTC时间，格式为 YYYY-MM-DDTHH:mm:ss.ssssssZ，日期和时间戳格式参照 ISO-8601，如：2023-06-28T08:56:33.710000Z。 |
请求示例
管理员修改名为“IAMUser”的邮箱地址为“IAMEmail@huawei.com”，手机号码为“008612345678910”，密码为IAMPassword@。
PUT https://iam.myhuaweicloud.com/v3.0/OS-USER/users/{user_id}
{
"user": {
"email": "IAMEmail@huawei.com",
"areacode": "0086",
"phone": "12345678910",
"enabled": true,
"name": "IAMUser",
"password": "IAMPassword@",
"pwd_status": false,
"xuser_type": "",
"xuser_id": "",
"access_mode" : "default",
"description": "IAMDescription"
}
}
响应示例
状态码为 200 时:
请求成功。
{
"user": {
"description": "IAMDescription",
"areacode": "0086",
"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"
}
}
返回值
返回值 |
描述 |
|---|---|
200 |
请求成功。 |
400 |
参数无效。 |
401 |
认证失败。 |
403 |
没有操作权限。 |
404 |
未找到相应的资源。 |
405 |
不允许的方法。 |
409 |
资源冲突。 |
413 |
请求体过大。 |
500 |
内部服务错误。 |
503 |
服务不可用。 |
错误码
请参考错误码。
