接口约束
5.6.10 管理员修改 IAM 用户信息(推荐)
}
响应示例
无
返回值
返回值 描述
204 修改成功。
400 参数无效。
401 认证失败。
403 没有操作权限。
404 未找到相应的资源。
405 不允许的方法。
409 资源冲突。
413 请求体过大。
500 内部服务错误。
503 服务不可用。
错误码
请参考错误码。
5.6.10 管理员修改 IAM 用户信息(推荐)
功能介绍
该接口可以用于管理员修改IAM用户信息 。
该接口可以使用全局区域的Endpoint和其他区域的Endpoint调用。IAM的Endpoint请 参见:地区和终端节点。
调试
您可以在API Explorer中调试该接口。
URI
表5-251 路径参数
参数 是否
必选
参数类型 描述
user_id 是 String 待修改信息的IAM用户ID,获取方式请 参见:获取帐号、IAM用户、项目、用 户组、区域、委托的名称和ID。
请求参数
表5-252 请求 Header 参数
参数 是否
必选
参数类型 描述
Content-Type 是 String 该字段内容填为“application/
json;charset=utf8”。
X-Auth-Token 是 String 拥有Security Administrator权限的 token。
表5-253 请求 Body 参数
参数 是否
必选
参数类型 描述
user 是 Object IAM用户信息。
表5-254 user
参数 是否
必选
参数类型 描述
name 否 String 新IAM用户名,长度1~32之间,只能包 含如下字符:大小写字母、空格、数字 或特殊字符(-_.)且不能以数字开头。
参数 是否 必选
参数类型 描述
password 否 String IAM用户新密码。
● 系统默认密码最小长度为6位字符,
email 否 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如果存在,则需
xuser_id 否 String IAM用户在外部系统中的ID。长度小于 等于128位,必须与xuser_type同时存
参数 是否 必选
参数类型 描述
access_mode 否 String IAM用户访问方式。
● default:默认访问模式,编程访问和 管理控制台访问。
● programmatic:编程访问。
● console:管理控制台访问。
description 否 String IAM用户新描述信息。
响应参数
表5-255 响应 Body 参数
参数 参数类型 描述
user Object IAM用户信息。
表5-256 user
参数 参数类型 描述
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用户访问方式。
● default:默认访问模式,编程访问和管理控制 台访问。
● programmatic:编程访问。
● console:管理控制台访问。
description String IAM用户的新描述信息。
参数 参数类型 描述
name String IAM用户新用户名,长度5~32之间,首位不能为 数字,特殊字符只能包含下划线“_”、中划线
“-”和空格。
phone String IAM用户新手机号,纯数字,长度小于等于32 位。必须与国家码同时存在。
domain_id String IAM用户所属帐号ID。
enabled Boolean 是否启用IAM用户。true为启用,false为停用,
默认为true。
areacode String 国家码。中国大陆为“0086”。
email String IAM用户新邮箱。
id String IAM用户ID。
links Object IAM用户的资源链接信息。
password_exp
ires_at String 密码过期时间(UTC时间)。当值为“null”时,
不返回。
表5-257 user.links
参数 参数类型 描述
self String 资源链接地址。
请求示例
PUT https://iam.myhuaweicloud.com/v3.0/OS-USER/users/{user_id}
{ "user": {
"email": "[email protected]", "areacode": "0086", "description": "IAMDescription"
} }
响应示例
状态码为 200 时:
请求成功。
"description": "IAMDescription",
"domain_id": "d78cbac186b744899480f25bd0...", "phone": "12345678910",
"name": "IAMUser", "links": {
"self": "https://iam.myhuaweicloud.com/3.0/OS-USER/users/076934ff9f0010cd1f0bc003..."
},
"id": "076934ff9f0010cd1f0bc0031019...", "xuser_type": "",
"email": "[email protected]"
}