文档首页/ 统一身份认证服务 IAM/ API参考/ API/ IAM用户管理/ 修改IAM用户密码
更新时间：2025-09-24 GMT+08:00
查看PDF
分享

修改IAM用户密码

功能介绍

该接口可以用于IAM用户修改自己的密码。

该接口可以使用全局区域的Endpoint和其他区域的Endpoint调用。IAM的Endpoint请参见：地区和终端节点。

调试

您可以在API Explorer中调试该接口。

URI

POST /v3/users/{user_id}/password

表1 路径参数

参数

是否必选

参数类型

描述

user_id

是

String

待修改密码的IAM用户ID，获取方式请参见：获取账号、IAM用户、项目、用户组、区域、委托的名称和ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

该字段内容填为“application/json;charset=utf8”。

X-Auth-Token

是

String

URL中user_id所对应IAM用户的token（无需特殊权限）。
表3 请求Body参数

参数

是否必选

参数类型

描述

user

是

Object

IAM用户信息。
表4 user

参数

是否必选

参数类型

描述

password

是

String

IAM用户的新密码。

  • 系统默认密码最小长度为8位字符，在8-32位之间支持用户自定义密码长度。
  • 至少包含以下四种字符中的两种： 大写字母、小写字母、数字和特殊字符。
  • 不能包含手机号和邮箱。
  • 必须满足用户所属账号的密码策略要求。
  • 新密码不能与当前密码相同。

original_password

是

String

IAM用户的原密码。

响应参数

无

请求示例

IAM用户将自己的原始密码“IAMOriginalPassword@”修改为“IAMNewPassword@”。

POST https://iam.myhuaweicloud.com/v3/users/{user_id}/password
{
    "user": {
        "password": "IAMNewPassword@",
        "original_password": "IAMOriginalPassword@"
    }
}

响应示例

无

返回值

返回值

描述

204

修改成功。

400

参数无效。

401

认证失败。

403

没有操作权限。

404

未找到相应的资源。

405

不允许的方法。

413

请求体过大。

500

内部服务错误。

503

服务不可用。

错误码

无

父主题： IAM用户管理