Modifying an ACL Account Role

This API is used to modify the role of an ACL account.

For details, see Calling APIs.

PUT /v2/{project_id}/instances/{instance_id}/accounts/{account_id}/role

**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.

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
account_role	No	String	Account permission. Options: read (read-only) and write (read/write).

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
instance_id	String	ID of the instance to which the account belongs.
job_id	String	ID of the job for modifying the access permission of an ACL account.

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.

PUT  https://{dcs_endpoint}/v2/{project_id}/instances/{instance_id}/accounts/{account_id}/role

{
  "account_role" : "read"
}

Status code: 200

Password reset.

{
  "job_id" : "ff80808284d4c6d50184e8cff10248bd",
  "instance_id" : "10fda556-51c3-4cfa-ab6f-37667428da6e"
}

Status code: 400

Invalid request.

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

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.

Parent topic: Account Management

Thank you very much for your feedback. We will continue working to improve the documentation.

The system is busy. Please try again later.