Help Center/ Identity and Access Management/ API Reference/ API/ IAM User Management/ Modifying IAM User Information (Recommended)
Updated on 2023-09-14 GMT+08:00

Modifying IAM User Information (Recommended)

Function

This API can be used by an IAM user to modify its basic information.

The API can be called using both the global endpoint and region-specific endpoints.

URI

PUT /v3.0/OS-USER/users/{user_id}/info

Table 1 URI parameters

Parameter

Mandatory

Type

Description

user_id

Yes

String

IAM user ID. For details about how to obtain a user ID, see Obtaining Account, IAM User, Group, Project, Region, and Agency Information.

Request Parameters

Table 2 Parameters in the request header

Parameter

Mandatory

Type

Description

Content-Type

Yes

String

Fill application/json;charset=utf8 in this field.

X-Auth-Token

Yes

String

Token (no special permission requirements) of the IAM user corresponding to the user_id specified in the URL.

Table 3 Parameters in the request body

Parameter

Mandatory

Type

Description

user

Yes

Object

IAM user information.

Table 4 user

Parameter

Mandatory

Type

Description

email

No

String

Email address, which can contain not more than 255 characters.

mobile

No

String

Country code and new mobile number. The mobile number can contain not more than 32 digits.

Response Parameters

None

Example Request

Assume that an IAM user changes their email address to IAMEmail@huawei.com and the mobile number to .

PUT https://iam.myhuaweicloud.eu/v3.0/OS-USER/users/{user_id}/info
{
    "user": {
        "email": "IAMEmail@huawei.com",
        "mobile": ""
    }
}

Example Response

None

Status Codes

Status Code

Description

204

The user information is modified successfully.

400

Invalid parameters.

401

Authentication failed.

403

Access denied.

404

The requested resource cannot be found.

405

The method specified in the request is not allowed for the requested resource.

409

A resource conflict occurs.

413

The request entity is too large.

500

Internal server error.

503

Service unavailable.

Error Codes

For details, see Error Codes.