Resetting the Password of an ACL Account

Function

This API is used to reset the password of an ACL account.

Calling Method

For details, see Calling APIs.

URI

PUT /v2/{project_id}/instances/{instance_id}/accounts/{account_id}/password/reset

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details, see Obtaining a Project ID.
instance_id	Yes	String	Instance ID.
account_id	Yes	String	ACL account ID.

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
old_password	No	String	Old password.
new_password	No	String	New password. Can contain 8 to 64 characters. Cannot contain the username or the username spelled backwards. Must contain at least three of the following character types (colons are not allowed): Lowercase letters Uppercase letters Digits Special characters (`~!@#$%^&*()-_=+\|{},<.>/?)

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
code	String	Code indicating successful task execution.
message	String	Reset result description.
lock_time	String	Lock duration. If the authentication fails and the account is locked, a response is returned and is not null.
lock_time_left	String	Remaining time before the account is unlocked. When the account is locked, a response is returned and is not null.
retry_times_left	String	Number of remaining password attempts. If the authentication fails, a response is returned and is not null.

Status code: 400

**Table 4** Response body parameters
Parameter	Type	Description
error_msg	String	Error message.
error_code	String	Error code.
error_ext_msg	String	Extended error information. This parameter is not used currently and is set to null.

Status code: 401

**Table 5** Response body parameters
Parameter	Type	Description
error_msg	String	Error message.
error_code	String	Error code.
error_ext_msg	String	Extended error information. This parameter is not used currently and is set to null.

Status code: 403

**Table 6** Response body parameters
Parameter	Type	Description
error_msg	String	Error message.
error_code	String	Error code.
error_ext_msg	String	Extended error information. This parameter is not used currently and is set to null.

Status code: 404

**Table 7** Response body parameters
Parameter	Type	Description
error_msg	String	Error message.
error_code	String	Error code.
error_ext_msg	String	Extended error information. This parameter is not used currently and is set to null.

Status code: 500

**Table 8** Response body parameters
Parameter	Type	Description
error_msg	String	Error message.
error_code	String	Error code.
error_ext_msg	String	Extended error information. This parameter is not used currently and is set to null.

Example Requests

PUT  https://{dcs_endpoint}/v2/{project_id}/instances/{instance_id}/accounts/{account_id}/password/reset"

{
  "old_password" : "xxxxxx",
  "new_password" : "xxxxxx"
}

Example Responses

Status code: 200

Password reset.

{
  "code" : "1",
  "message" : "Reset DCSInstance password success.",
  "lock_time" : "0",
  "lock_time_left" : "0",
  "retry_times_left" : "5"
}

Status code: 400

Invalid request.

{
  "error_code" : "DCS.4961"
}

Status Codes

Status Code	Description
200	Password reset.
400	Invalid request.
401	Invalid authentication information.
403	Request rejected.
404	The requested resource could not be found.
500	Internal service error.