文档首页> 统一身份认证服务 IAM> API参考> API> IAM用户管理> 管理员修改IAM用户信息
更新时间：2022-05-18 GMT+08:00
编辑
查看PDF
分享

管理员修改IAM用户信息

功能介绍

该接口可以用于管理员修改IAM用户信息。

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

接口约束

该接口无法修改手机号、邮箱等信息。如需修改手机号、邮箱等信息，请使用接口：管理员修改IAM用户信息（推荐）。

调试

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

URI

PATCH /v3/users/{user_id}

表1 路径参数

参数

是否必选

参数类型

描述

user_id

是

String

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

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

X-Auth-Token

是

String

请参见授权项。
表3 请求Body参数

参数

是否必选

参数类型

描述

user

是

Object

IAM用户信息。
表4 user

参数

是否必选

参数类型

描述

domain_id

否

String

IAM用户所属帐号ID。

name

否

String

IAM用户新用户名，长度1~32之间，只能包含如下字符：大小写字母、空格、数字或特殊字符（-_.）且不能以数字开头。

password

否

String

IAM用户密码。

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

enabled

否

Boolean

是否启用IAM用户。true为启用，false为停用，默认为true。

description

否

String

IAM用户新描述信息。

pwd_status

否

Boolean

IAM用户密码状态。true:需要修改密码,false:正常。

响应参数

表5 响应Body参数

参数

参数类型

描述

user

Object

IAM用户信息。
表6 user

参数

参数类型

描述

name

String

IAM用户名。

domain_id

String

IAM用户所属帐号ID。

enabled

Boolean

IAM用户是否启用。true表示启用，false表示停用，默认为true。

id

String

IAM用户ID。

password_expires_at

String

密码过期时间（UTC时间），“null”表示密码不过期。

description

String

IAM用户描述信息。

pwd_status

Boolean

IAM用户密码状态。true：需要修改密码，false：正常。

last_project_id

String

IAM用户退出系统前，在控制台最后访问的项目ID。

extra

Object

IAM用户的其他信息。

links

Object

IAM用户的资源链接信息。
表7 user.extra

参数

参数类型

描述

description

String

IAM用户描述信息。

pwd_status

Boolean

IAM用户密码状态。true：需要修改密码，false：正常。

last_project_id

String

IAM用户退出系统前，在控制台最后访问的项目ID。
表8 user.links

参数

参数类型

描述

self

String

资源链接地址。

请求示例

PATCH https://iam.myhuaweicloud.com/v3/users/{user_id}
{
    "user": {
        "domain_id": "d78cbac186b744899480f25bd02...",
        "name": "IAMUser",
        "password": "IAMPassword@",
        "enabled": true,
        "pwd_status": false,
        "description": "IAMDescription"
    }
}

响应示例

状态码为 200 时:

请求成功。

{
    "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..."
    }
}

返回值

返回值

描述

200

请求成功。

400

参数无效。

401

认证失败。

403

没有操作权限。

404

未找到相应的资源。

405

不允许的方法。

409

资源冲突。

413

请求体过大。

500

内部服务错误。

503

服务不可用。

错误码

请参考错误码。

父主题： IAM用户管理
分享：

    相关文档

    相关产品

close