文档首页/ 数据仓库服务 DWS/ 更多文档/ API参考（吉隆坡区域）/ API说明/ 数据库权限管理/ 执行运维用户操作
更新时间：2025-09-18 GMT+08:00
在线调试
CLI示例
查看PDF
分享

执行运维用户操作

功能介绍

进行数据库运维账户操作。

调用方法

请参见如何调用API。

URI

POST /v1/{project_id}/clusters/{cluster_id}/db-manager/om-user/action

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

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

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

cluster_id

是

String

参数解释：

集群ID。获取方法请参见获取集群ID。

约束限制：

必须是有效的dws集群ID。

取值范围：

36位UUID。

默认取值：

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

operation

是

String

参数解释：

操作类型。

取值范围：

addOmUser：添加运维用户。

deleteOmUser：删除运维用户。

increaseOmUserPeriod：延长用户有效期。

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

error_code

Integer

参数解释：

错误码。非0皆为异常场景。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息。

取值范围：

不涉及。

om_user_info

DatabaseOmUserInfo object

参数解释：

运维用户信息。

取值范围：

不涉及。
表4 DatabaseOmUserInfo

参数

参数类型

描述

om_user_status

String

参数解释：

运维账户状态。

取值范围：

on、off

om_user_expires_time

Long

参数解释：

运维账户过期状态。格式是有效的时间戳。

取值范围：

不涉及。

请求示例

  • 添加运维用户

    https://{Endpoint}/dws/rest-dms/v1.0/05f2cff45100d5112f4bc00b794ea08e/clusters/e7107fab-cac0-4261-916b-7f32b3053034/db-manager/om-user/action

{
  "operation" : "addOmUser"
}

  • 删除运维用户

    https://{Endpoint}/dws/rest-dms/v1.0/05f2cff45100d5112f4bc00b794ea08e/clusters/e7107fab-cac0-4261-916b-7f32b3053034/db-manager/om-user/action

{
  "operation" : "deleteOmUser"
}

  • 延长用户有效期

    https://{Endpoint}/dws/rest-dms/v1.0/05f2cff45100d5112f4bc00b794ea08e/clusters/e7107fab-cac0-4261-916b-7f32b3053034/db-manager/om-user/action

{
  "operation" : "increaseOmUserPeriod"
}

响应示例

状态码：200

操作成功。

{
  "error_code" : 0,
  "error_msg" : null,
  "om_user_info" : {
    "om_user_status" : "on",
    "om_user_expires_time" : 1747214333491
  }
}

状态码

状态码

描述

200

操作成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。
父主题： 数据库权限管理