All Products
Search
Document Center

Drive and Photo Service:UpdateUser

Last Updated:May 15, 2026

Modifies user information.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST /v2/user/update HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

domain_id

string

Yes

body

object

No

The request body.

user_id

string

Yes

The user ID. The maximum length is 64 characters. The value cannot contain the # character.

c9b7a5aa04d14ae3867fdc886fa01da4

nick_name

string

No

The nickname. The maximum length is 128 characters.

pdsuer

status

string

No

The user status. Valid values:

  • disabled

  • enabled

Valid values:

  • disabled :

    disabled

  • enabled :

    enabled

enabled

role

string

No

The role. Valid values:

  • superadmin: super administrator

  • admin: administrator

  • user: regular user

Valid values:

  • superadmin :

    super administrator

  • admin :

    administrator

  • user :

    regular user

user

avatar

string

No

The URL of the avatar.

HTTP URLs must start with http:// or https:// and be 4 KB or smaller.

Data URLs must start with data://, be Base64-encoded, and be 300 KB or smaller.

http://a.b.c/pds.jpg

description

string

No

The description. The maximum length is 1,024 characters.

vip用户

phone

string

No

The mobile number.

13900001111

email

string

No

The email address.

a@aliyunpds.com

user_data

object

No

The custom user data. The maximum length is 1,024 characters.

string

No

The value of a custom data field.

test

group_info_list

array<object>

No

The group list.

object

No

Information about a group.

group_id

string

No

The group ID.

g123

Response elements

Element

Type

Description

Example

User

The user information.

Examples

Success response

JSON format

{
  "domain_id": "bj1",
  "user_id": "c9b7a5aa04d14ae3867fdc886fa01da4",
  "avatar": "http://aa.com/1.jpg",
  "created_at": 1639762579768,
  "updated_at": 1639762579768,
  "email": "a@aliyunpds.com",
  "nick_name": "001",
  "phone": "13900001111",
  "role": "user",
  "status": "enabled",
  "user_name": "pds",
  "description": "vipuser",
  "default_drive_id": "1",
  "user_data": {
    "key": ""
  },
  "creator": "user1"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.