更新时间:2025-09-18 GMT+08:00

获得集群运维账户状态

功能介绍

获得数据库运维账户状态。

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/clusters/{cluster_id}/db-manager/om-user/status

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

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

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

cluster_id

String

参数解释

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

约束限制

必须是有效的dws集群ID。

取值范围

36位UUID。

默认取值

不涉及。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

error_code

Integer

参数解释

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

取值范围

不涉及。

error_msg

String

参数解释

错误信息。

取值范围

不涉及。

om_user_info

DatabaseOmUserInfo object

参数解释

运维用户信息。

取值范围

不涉及。

表3 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/status

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

响应示例

状态码:200

查询成功。

{
  "error_code" : 0,
  "error_msg" : null,
  "om_user_info" : null
}

状态码

状态码

描述

200

查询成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。