Changing the Password of an ACL Account

Function

This API is used to change 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/modify

**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
lock_time	String	Lock duration. If the password authentication fails and the account is locked, a response is returned and is not null.
result	String	Password change result: success: Password changed. passwordFailed: Password authentication failed. locked: The account has been locked. failed: Password change failed.
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 password authentication fails, a response is returned and is not null.
message	String	Modification result description.

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/modify

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

Example Responses

Status code: 200

Password changed.

{
  "lock_time" : "0",
  "result" : "success",
  "lock_time_left" : "0",
  "retry_times_left" : "5",
  "message" : "Modify DCSInstance password success."
}

Status code: 400

Invalid request.

{
  "error_code" : "DCS.4961",
  "error_msg" : "Acl account request param invalid."
}

Status Codes

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