Updated on 2023-12-22 GMT+08:00

Resetting a User Password

Description

This API is used to reset a user password. After receiving a request, the server resets the user password and returns the result.

Debugging

You can debug this API in API Explorer.

Prototype

Table 1 Prototype

Request Method

PUT

Request Address

/v1/usg/acs/password/reset

Transport Protocol

HTTPS

Request Parameters

Table 2 Parameters

Parameter

Mandatory

Type

Location

Description

X-Access-Token

Yes

String

Header

Authorization token. Obtain the token returned in Verifying a Verification Code.

Content-Type

Yes

String

Header

Media format of the body.

Example: application/json; charset=UTF-8

X-Request-Id

No

String

Header

Request ID, which is used for fault tracing and locating. You are advised to use a UUID. If this parameter is not carried, a request ID is automatically generated.

Accept-Language

No

String

Header

Language. Values: zh-CN for Chinese (default) and en-US for English.

newPwd

Yes

String

Body

New login password.

Password requirements:

  • Password length: 8–32 characters.
  • The password must contain at least two of the following: lowercase letters, uppercase letters, numbers, and special characters.
  • The password cannot contain three or more of the same characters consecutively.
  • The password cannot be the same as the name or the reverse of the name (case insensitive).

passWordType

No

Integer

Body

  • 1: temporary password. After the user password is reset, the user may be forced to change the password after logging in to Huawei Cloud Meeting Management Platform based on configurations.
  • Other values: formal password. After the user password is reset, the user does not need to change the password after logging in to Huawei Cloud Meeting Management Platform.

user

Yes

String

Body

User identity information (mobile number, email address, or user account).

Status Codes

Table 3 Status codes

HTTP Status Code

Description

200

Operation successful.

400

Invalid parameters.

401

Authentication is not performed or fails.

403

Insufficient permissions.

500

Server exception.

Response Parameters

None

Example Request

PUT /v1/usg/acs/password/reset 
Connection: keep-alive 
X-Access-Token: hYRlErvNnuqEuseSo0PoDBLMvol71wJm7
Content-Type: application/json 
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191) 

{
    "user": "+86136****9209", 
    "newPwd": "*********"
}

Example Response

HTTP/1.1 200  
Date: Wed, 18 Dec 2019 06:20:40 GMT 
Content-Type: application/json;charset=UTF-8 
Connection: keep-alive 
Pragma: No-cache 
Cache-Control: no-cache 
http_proxy_id: c94f64967745b0670c299c0688479078 

Error Codes

If an error code starting with MMC or USG is returned when you use this API, rectify the fault by following the instructions provided in Huawei Cloud API Error Center.