Modifying an ACL Account Role
Function
This API is used to modify the role of an ACL account.
Calling Method
For details, see Calling APIs.
URI
PUT /v2/{project_id}/instances/{instance_id}/accounts/{account_id}/role
| 
        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
| 
        Parameter  | 
      
        Mandatory  | 
      
        Type  | 
      
        Description  | 
     
|---|---|---|---|
| 
        account_role  | 
      
        No  | 
      
        String  | 
      
        Account permission. Options: read (read-only) and write (read/write).  | 
     
Response Parameters
Status code: 200
| 
        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
| 
        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
| 
        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
| 
        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
| 
        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
| 
        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}/role
{
  "account_role" : "read"
}
 Example Responses
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 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.  | 
     
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.