更新时间:2025-12-29 GMT+08:00

修改ACL角色

功能介绍

修改ACL账号的类型。

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。获取方法请参见获取项目ID

instance_id

String

实例ID。

account_id

String

ACL账号ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

account_role

String

账号权限,read:只读账号,write:读写账号。

account_read_policy

String

参数解释

指定账号的读请求转发到主节点或备节点。

约束限制

  • 仅proxy集群和读写分离实例支持,proxy集群未开启读写分离不支持设置。

  • 读写分离配置参考“用户指南>管理实例>修改DCS实例配置参数”中backend-master-only参数说明。

  • master:读请求转发到主节点。

  • replica:读请求转发到备节点。

  • master-replica:读请求转发到主备节点。

  • 完全读写分离配置参考 “用户指南>管理实例>修改DCS实例配置参数”中read-only-slave-when-wr-split参数说明。

  • proxy集群实例

    • 默认未开启读写分离,读请求转发到主节点。

    • 开启读写分离

      • 默认开启完全读写分离,读请求转发到备节点。

      • 未开启完全读写分离,读请求随机转发到主备节点。

  • 读写分离实例

    • 默认支持读写分离

      • 默认开启完全读写分离,读请求转发到备节点。

      • 未开启完全读写分离,读请求随机转发到主备节点。

取值范围

默认取值

默认不设置。不设置时,读请求按照实例读写分离配置进行转发。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

instance_id

String

账号所属实例ID。

job_id

String

修改ACL账号访问权限JOB的ID。

状态码:400

表4 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释

错误信息。

取值范围

不涉及。

error_code

String

参数解释

错误码。

取值范围

请参见错误码

error_ext_msg

String

参数解释

扩展错误信息(暂未使用,赋值为null)。

取值范围

不涉及。

状态码:401

表5 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释

错误信息。

取值范围

不涉及。

error_code

String

参数解释

错误码。

取值范围

请参见错误码

error_ext_msg

String

参数解释

扩展错误信息(暂未使用,赋值为null)。

取值范围

不涉及。

状态码:403

表6 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释

错误信息。

取值范围

不涉及。

error_code

String

参数解释

错误码。

取值范围

请参见错误码

error_ext_msg

String

参数解释

扩展错误信息(暂未使用,赋值为null)。

取值范围

不涉及。

状态码:404

表7 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释

错误信息。

取值范围

不涉及。

error_code

String

参数解释

错误码。

取值范围

请参见错误码

error_ext_msg

String

参数解释

扩展错误信息(暂未使用,赋值为null)。

取值范围

不涉及。

状态码:500

表8 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释

错误信息。

取值范围

不涉及。

error_code

String

参数解释

错误码。

取值范围

请参见错误码

error_ext_msg

String

参数解释

扩展错误信息(暂未使用,赋值为null)。

取值范围

不涉及。

请求示例

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

{
  "account_role" : "read"
}

响应示例

状态码:200

重置密码成功。

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

状态码:400

非法请求。

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

状态码

状态码

描述

200

重置密码成功。

400

非法请求。

401

认证信息非法。

403

请求被拒绝访问。

404

所请求的资源不存在。

500

内部服务错误。

错误码

请参见错误码