---
title: "概述 | OceanBase 文档中心"
description: 概述 为方便调用 API 管理您的 OceanBase 集群资源和开发自己的应用程序，OCP 公开符合 REST 规范的 HTTP API。本文档提供 OCP 开放 API 的描述、语法及示例。文档面向开发人员。在调用接口前，请确保已充分了解 OCP 平台的的相关概念。 集群信息 API 列表 模块 API 名称 说…
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lJTmRZ61jSUAAAAAAAAAAAAADiGDAQ/original) 云平台 OCPV 4.2.0 企业版

# 概述

更新时间：2026-06-25 11:30:44

为方便调用 API 管理您的 OceanBase 集群资源和开发自己的应用程序，OCP 公开符合 REST 规范的 HTTP API。本文档提供 OCP 开放 API 的描述、语法及示例。文档面向开发人员。在调用接口前，请确保已充分了解 OCP 平台的的相关概念。

## 集群信息 API 列表

| 模块 | API 名称 | 说明 |
| --- | --- | --- |
| 集群信息 | [查询集群列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126217) | 用于查询 OCP 所管理的 OceanBase 集群信息的接口。 |
| 集群信息 | [创建 OceanBase 集群](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126223) | 用于创建 OceanBase 集群的接口。 |
| 集群信息 | [删除 OceanBase 集群](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126221) | 用于删除 OceanBase 集群的接口。 |
| 集群信息 | [停止 OceanBase 集群](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126232) | 用于停止 OceanBase 集群的接口。 |
| 集群信息 | [启动 OceanBase 集群](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126218) | 用于启动 OceanBase 集群的接口。 |
| 集群信息 | [重启 OceanBase 集群](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126231) | 用于重启 OceanBase 集群的接口。 |
| 集群信息 | [升级 OceanBase 集群](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126230) | 用于升级 OceanBase 集群的接口。 |
| 集群信息 | [查看 OceanBase 集群的 Zone 列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126237) | 用于查询 OceanBase 集群的 Zone 列表。 |
| 集群信息 | [OceanBase 集群新建 Zone](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126216) | 用于为 OceanBase 集群新增 Zone。 |
| 集群信息 | [OceanBase 集群删除 Zone](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126219) | 用于删除指定 OceanBase 集群的 Zone。 |
| 集群信息 | [OceanBase 集群停止 Zone](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126227) | 用于停止指定 OceanBase 集群的 Zone。 |
| 集群信息 | [OceanBase 集群启动 Zone](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126222) | 用于启动目标 OceanBase 集群的 Zone。 |
| 集群信息 | [OceanBase 集群重启 Zone](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126213) | 用于重启指定 OceanBase 集群的 Zone。 |
| 集群信息 | [增加 OBServer 节点](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126234) | 用于为目标 OceanBase 集群增加 OBServer 节点。 |
| 集群信息 | [批量删除 OBServer 节点](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126226) | 用于批量删除目标 OceanBase 集群中的 OBServer 节点。 |
| 集群信息 | [停止 OBServer 节点](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126226) | 用于停止目标 OceanBase 集群的 OBServer 节点。 |
| 集群信息 | [启动 OBServer 节点](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000125915) | 用于启动目标 OceanBase 集群的 OBServer 节点。 |
| 集群信息 | [重启 OBServer 节点](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126233) | 用于重启目标 OceanBase 集群的 OBServer 节点。 |
| 集群信息 | [替换 OBServer 节点](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126236) | 用于替换目标 OceanBase 集群中的 OBServer 节点。 |
| 集群信息 | [修改 OceanBase 集群密码](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126225) | 用于修改目标 OceanBase 集群的密码。 |
| 集群信息 | [获取 OceanBase 集群参数元数据](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126229) | 用于获取 OceanBase 集群参数元数据。 |
| 集群信息 | [获取 OceanBase 集群参数列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126215) | 用于获取目标 OceanBase 集群的参数列表。 |
| 集群信息 | [修改 OceanBase 集群参数](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126224) | 用于修改目标 OceanBase 集群的参数。 |
| 集群信息 | [查询服务器列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126220) | 查询集群下的所有服务器的信息。 |
| 集群信息 | [查询 Zone 的服务器列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126228) | 查询集群的指定 Zone 下的服务器的信息。 |

## 租户信息 API 列表

| 模块 | API 名称 | 说明 |
| --- | --- | --- |
| 租户信息 | [查询集群的租户列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126148) | 查询集群的租户列表。 |
| 租户信息 | [查询全部租户列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126161) | 查询 OCP 所管理集群的所有租户的信息。 |
| 租户信息 | [查询租户详情](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126156) | 查询指定租户详情。 |
| 租户信息 | [创建租户](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126149) | 在指定的集群下创建单个租户时使用的接口。 |
| 租户信息 | [删除租户](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126157) | 在指定的集群下删除指定租户时使用的接口。 |
| 租户信息 | [锁定租户](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126143) | 在指定的集群下锁定指定租户时使用的接口。 |
| 租户信息 | [解锁租户](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126153) | 在指定的集群下解锁指定租户时使用的接口。 |
| 租户信息 | [查询租户 Unit 列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126159) | 查询租户的 Unit 列表。 |
| 租户信息 | [删除租户 Unit](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126146) | 删除租户 Unit 时使用的接口。 |
| 租户信息 | [增加租户副本](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126142) | 为指定租户新增副本。 |
| 租户信息 | [删除租户副本](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126144) | 为指定租户删除副本时使用的接口。 |
| 租户信息 | [修改租户副本](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126152) | 修改指定租户的副本时使用的接口。 |
| 租户信息 | [修改租户 Zone 优先级](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126158) | 修改指定租户的 Zone 优先级时使用的接口。 |
| 租户信息 | [修改租户管理密码](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126145) | 修改指定租户的管理密码时使用的接口。 |
| 租户信息 | [修改租户白名单](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126147) | 修改指定租户的白名单时使用的接口。 |
| 租户信息 | [获取租户参数列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126160) | 获取租户参数列表时使用的接口。 |
| 租户信息 | [修改租户参数](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126155) | 该接口用于修改租户的参数。 |
| 租户信息 | [获取数据库列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126451) | 获取数据库列表时使用的接口。 |
| 租户信息 | [创建数据库](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126450) | 创建数据库时使用的接口。 |
| 租户信息 | [修改数据库](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126452) | 修改数据库时使用的接口。 |
| 租户信息 | [删除数据库](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126449) | 删除数据库时使用的接口。 |

## 主机 API 列表

| 模块 | API 名称 | 说明 |
| --- | --- | --- |
| 主机模块 | [查询区域列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126095) | 查询区域信息列表。 |
| 主机模块 | [查询区域详细信息](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126090) | 根据区域 ID 查询主机区域信息。 |
| 主机模块 | [新增区域](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126096) | 添加主机区域信息。 |
| 主机模块 | [删除区域信息](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126094) | 删除区域信息。 |
| 主机模块 | [查询机房列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126084) | 查询机房信息列表。 |
| 主机模块 | [查询机房详细信息](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126098) | 根据机房 ID 查询主机机房信息。 |
| 主机模块 | [新增机房](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126082) | 添加主机机房信息。 |
| 主机模块 | [删除机房信息](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126083) | 删除机房信息。 |
| 主机模块 | [查询机型列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126087) | 查询机型信息列表。 |
| 主机模块 | [查询机型详细信息](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126092) | 根据机型 ID 查询主机机房信息。 |
| 主机模块 | [新增机型](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126089) | 添加主机机型信息。 |
| 主机模块 | [删除机型信息](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126091) | 删除机型信息。 |
| 主机模块 | [查询主机列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126093) | 查询主机信息列表。 |
| 主机模块 | [查询主机详细信息](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126086) | 根据主机 ID 查询主机详细信息。 |
| 主机模块 | [批量新增主机](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126088) | 批量添加主机信息。 |
| 主机模块 | [删除主机](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126085) | 删除主机信息。 |
| 主机模块 | [批量删除主机](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126097) | 批量删除主机信息。 |

## 软件包 API 列表

| 模块 | API 名称 | 说明 |
| --- | --- | --- |
| 软件包接口 | [查询软件包列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126100) | 查询 OCP 所管理的软件包信息。可以通过软件包名称关键字、类型、版本、操作系统、架构信息过滤软件包列表，也可以通过上传时间针对列表进行排序。 |
| 软件包接口 | [上传软件包](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126099) | 将本地的软件包上传到 OCP 服务器，可以通过软件包名称关键字、类型、版本、操作系统、架构信息过滤软件包列表，也可以通过上传时间针对列表进行排序。 |
| 软件包接口 | [删除软件包](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126101) | 删除指定的软件包信息。 |

## OBProxy API 列表

| 模块 | API 名称 | 说明 |
| --- | --- | --- |
| OBProxy 管理 | [创建 OBProxy 集群](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126126) | 创建 OBProxy 集群时使用的接口。 |
| OBProxy 管理 | [删除 OBProxy 集群](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126124) | 删除 OBProxy 集群时使用的接口。 |
| OBProxy 管理 | [查询 OBProxy 集群列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126128) | 查询 OBProxy 集群列表信息时使用的接口。 |
| OBProxy 管理 | [查询 OBProxy 集群详情](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126117) | 查询 OBProxy 集群详情信息时使用的接口。 |
| OBProxy 管理 | [更新 OBProxy 集群配置](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126129) | 查询 OBProxy 集群详情信息时使用的接口。 |
| OBProxy 管理 | [添加 OBProxy](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126122) | 为 OBProxy 集群添加 OBProxy 时使用的接口。 |
| OBProxy 管理 | [接管 OBProxy](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126120) | 将 OBProxy 接管进 OBProxy 集群时使用的接口。 |
| OBProxy 管理 | [删除 OBProxy](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126130) | 删除 OBProxy 时使用的接口。 |
| OBProxy 管理 | [重启 OBProxy](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126127) | 重启 OBProxy 时使用的接口。 |
| OBProxy 管理 | [升级 OBProxy](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126121) | 升级 OBProxy 使用的接口。 |
| OBProxy 管理 | [OBProxy 集群添加可连接 OceanBase 集群](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000125604) | 为 OBProxy 集群添加可连接 OceanBase 集群。 |
| OBProxy 管理 | [OBProxy 集群删除可连接 OceanBase 集群](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126123) | 删除 OBProxy 集群和可连接 OceanBase 集群的关联。 |
| OBProxy 管理 | [查询 OBProxy 参数元数据](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126119) | 查询 OBProxy 参数元数据。 |
| OBProxy 管理 | [查询 OBProxy 集群参数](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126118) | 查询 OBProxy 集群参数设置。 |

## 监控 API 列表

| 模块 | API 名称 | 说明 |
| --- | --- | --- |
| 监控 | [查询监控指标的元数据](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126131) | 查询 OCP 监控指标的元数据信息，可基于此信息查询指定指标的监控数据。 |
| 监控 | [查询监控数据](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126132) | 查询指定指标的监控数据，需要指定查询的时间区间。 |
| 监控 | [查询监控数据并附带标签](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126133) | 查询指定指标的监控数据，需要指定查询的时间区间，返回结果附带分组标签的值。 |

## 告警 API 列表

| 模块 | API 名称 | 说明 |
| --- | --- | --- |
| 告警 | [查询告警事件列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126455) | 查询告警事件列表。 |
| 告警 | [查询告警事件](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126454) | 查询单条告警事件信息。 |
| 告警 | [查询告警通知历史](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126453) | 获取通知历史, 支持搜索条件、接收人、发送时间。 |

## 任务管理 API 列表

| 模块 | API 名称 | 说明 |
| --- | --- | --- |
| 任务管理 | [查询任务列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126136) | 查询任务列表，支持根据不同参数进行过滤。 |
| 任务管理 | [查询任务详情](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126141) | 该接口用于查询任务执行的详细信息。 |
| 任务管理 | [重试任务](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126138) | 触发任务所有失败子任务的重新执行。 |
| 任务管理 | [回滚任务](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126140) | 从所有失败的子任务节点开始回滚。 |
| 任务管理 | [查询子任务实例日志](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126135) | 根据子任务实例 ID 查询子任务执行的日志信息，执行中的子任务多次查询会自动刷新日志信息。 |
| 任务管理 | [重试子任务](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126137) | 重新执行失败的子任务。 |
| 任务管理 | [跳过子任务](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126134) | 跳过失败子任务执行，并且将子任务标记成成功。 |
| 任务管理 | [取消子任务](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126139) | 取消执行中子任务的执行，并且将子任务标记成失败。 |

## OCP 历史事件 API 列表

| 模块 | API 名称 | 说明 |
| --- | --- | --- |
| OCP 历史事件 | [查询历史事件](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126116) | 查询 OCP 的历史事件。可以通过事件类型、操作事件名、资源名、操作者 ID、事件信息、事件状态、事件发生的时间段等条件查找历史事件。 |

## OceanBase 用户与权限 API 列表

| 模块 | API 名称 | 说明 |
| --- | --- | --- |
| OceanBase 用户与权限管理 | [获取数据库用户详情列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126197) | 获取数据库用户详情列表。 |
| OceanBase 用户与权限管理 | [获取数据库用户详情](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126202) | 获取数据库用户详情。 |
| OceanBase 用户与权限管理 | [创建数据库用户](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126206) | 创建数据库用户。 |
| OceanBase 用户与权限管理 | [删除数据库用户](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126188) | 删除数据库用户。 |
| OceanBase 用户与权限管理 | [修改数据库用户密码](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126193) | 修改数据库用户密码。 |
| OceanBase 用户与权限管理 | [锁定数据库用户](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126205) | 锁定数据库用户。 |
| OceanBase 用户与权限管理 | [解锁数据库用户](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126203) | 解锁数据库用户。 |
| OceanBase 用户与权限管理 | [获取数据库角色详情列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126195) | 获取数据库角色详情列表。 |
| OceanBase 用户与权限管理 | [获取数据库角色详情](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126209) | 获取数据库角色详情。 |
| OceanBase 用户与权限管理 | [创建数据库角色](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126204) | 创建数据库角色。 |
| OceanBase 用户与权限管理 | [删除数据库角色](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126194) | 删除数据库角色。 |
| OceanBase 用户与权限管理 | [获取数据库对象列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126180) | 获取数据库对象列表。 |
| OceanBase 用户与权限管理 | [授予用户全局权限](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126207) | 授予用户全局权限。 |
| OceanBase 用户与权限管理 | [撤销用户全局权限](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126212) | 撤销用户全局权限。 |
| OceanBase 用户与权限管理 | [修改用户全局权限](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126210) | 修改用户全局权限。 |
| OceanBase 用户与权限管理 | [授予角色全局权限](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126211) | 授予角色全局权限。 |
| OceanBase 用户与权限管理 | [撤销角色全局权限](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126192) | 撤销角色全局权限。 |
| OceanBase 用户与权限管理 | [修改角色全局权限](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126196) | 修改角色全局权限。 |
| OceanBase 用户与权限管理 | [授予用户的角色](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126198) | 授予用户的角色。 |
| OceanBase 用户与权限管理 | [撤销用户的角色](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126208) | 撤销用户的角色。 |
| OceanBase 用户与权限管理 | [修改用户的角色](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126200) | 修改用户的角色。 |
| OceanBase 用户与权限管理 | [授予角色的角色](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126182) | 修改角色的角色。 |
| OceanBase 用户与权限管理 | [撤销角色的角色](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126190) | 撤销角色的角色。 |
| OceanBase 用户与权限管理 | [修改角色的角色](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126183) | 修改角色的角色。 |
| OceanBase 用户与权限管理 | [授予用户数据库权限](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126184) | 该接口用于授予用户数据库的权限。 |
| OceanBase 用户与权限管理 | [撤销用户数据库权限](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126185) | 该接口用于撤销用户对数据库的某些权限。 |
| OceanBase 用户与权限管理 | [修改用户数据库权限](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126201) | 该接口用于修改用户对数据库的权限。 |
| OceanBase 用户与权限管理 | [授予用户对象权限](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126187) | 授予用户对象权限。 |
| OceanBase 用户与权限管理 | [撤销用户对象权限](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126181) | 撤销用户对象权限。 |
| OceanBase 用户与权限管理 | [修改用户对象权限](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126191) | 修改用户对象权限。 |
| OceanBase 用户与权限管理 | [授予角色对象权限](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126186) | 授予角色对象权限。 |
| OceanBase 用户与权限管理 | [撤销角色对象权限](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126189) | 撤销角色对象权限。 |
| OceanBase 用户与权限管理 | [修改角色对象权限](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126199) | 修改角色对象权限。 |

## Agent 管理 API 列表

| 模块 | API 名称 | 说明 |
| --- | --- | --- |
| OCP Agent 管理 | [查询主机的 OCP Agent 详情](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126111) | 获取指定主机上 OCP Agent 详细信息。 |
| OCP Agent 管理 | [停止主机的 OCP Agent 的基础进程](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126115) | 停止指定主机上的 OCP Agent 基础进程。 |
| OCP Agent 管理 | [批量停止主机的 OCP Agent 的基础进程](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126112) | 批量停止主机的 OCP Agent 的基础进程。 |
| OCP Agent 管理 | [重启主机的 OCP Agent 的基础进程](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126114) | 重启指定主机上 OCP Agent 的基础进程。 |
| OCP Agent 管理 | [批量重启主机的 OCP Agent 的基础进程](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126109) | 批量重启主机的 OCP Agent 的基础进程。 |
| OCP Agent 管理 | [查询主机的 OCP Agent 的工作进程列表](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126110) | 查询主机的 OCP Agent 的工作进程列表。 |
| OCP Agent 管理 | [重启主机的 OCP Agent 的工作进程](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126113) | 重启时，指定主机上 OCP Agent 的工作进程。 |
| OCP Agent 管理 | [停止主机的 OCP Agent 的工作进程](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126108) | 停止指定主机上 OCP Agent 工作进程。 |

## SQL 性能 API 列表

| 模块 | API 名称 | 说明 |
| --- | --- | --- |
| SQL 性能 | [查询 SQL 的性能统计](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126103) | 查询租户的 SQL 性能，按指定的时间区间统计 SQL 的性能。性能数据包括：集群、租户、服务器、数据库、用户、SQL_ID 。 |
| SQL 性能 | [查询 SQL 的性能统计趋势](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126106) | 查询某一 SQL 在指定时间区间内的性能趋势。 |
| SQL 性能 | [查询 SQL 的文本](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126105) | 查询指定 ID 的 SQL 的全文本。 |
| SQL 性能 | [查询执行计划的性能统计](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126107) | 查询指定 SQL 的关联的执行计划的性能。 |
| SQL 性能 | [查询执行计划的性能统计趋势](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126104) | 查询指定 SQL 的关联的执行计划的性能趋势。 |
| SQL 性能 | [查询执行计划的算子结构](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126102) | 查询执行计划的操作结构。 |

## 备份恢复 API 列表

| 模块 | API 名称 | 说明 |
| --- | --- | --- |
| 备份恢复 | [查询集群的备份能力](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126172) | 该接口用于查询 OceanBase 集群的备份能力，即是否可备份、支持的备份方式等。 |
| 备份恢复 | [创建集群的备份策略](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126169) | 该接口用于创建集群的备份策略，通过该接口可以设置集群的备份调度的周期、时间和存储地址，以及过期数据清理、告警阈值等。 |
| 备份恢复 | [修改集群的备份策略](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126174) | 该接口用于修改集群的备份策略，通过该接口可以修改集群的备份调度的周期、时间和存储地址，以及过期数据清理、告警阈值，二次备份配置等信息。 |
| 备份恢复 | [删除集群的备份策略](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126176) | 该接口用于删除集群的备份策略。备份策略删除后，集群不再自动备份调度，以及检测相关的告警。 |
| 备份恢复 | [查询指定集群的备份策略](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126173) | 该接口用于查询 OceanBase 集群的备份策略详情。 |
| 备份恢复 | [查询集群的备份概览](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126175) | 该接口用于查询集群的备份概览，包括集群的基本信息，最近一次数据备份时间，日志备份位点，日志延迟时间，以及备份大小等信息。 |
| 备份恢复 | [查询某一集群的数据备份任务](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126171) | 该接口用于查询指定集群的数据备份任务。 |
| 备份恢复 | [查询某一集群的日志备份任务](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126165) | 该接口用于查询某一 OceanBase 集群的日志备份任务。 |
| 备份恢复 | [查询某一集群的恢复任务](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126167) | 该接口用于查询某一集群的恢复任务。 |
| 备份恢复 | [针对某个集群进行立即备份](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126166) | 该接口用于对某个集群发起一次立即备份。 |
| 备份恢复 | [解析集群备份信息](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126168) | 该接口用于解析集群的备份信息。 |
| 备份恢复 | [发起租户恢复](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126170) | 该接口用于将已备份的租户恢复到目标集群。 |

## 健康检查 API 列表

| 模块 | API 名称 | 说明 |
| --- | --- | --- |
| 健康检查 | [查询 OCP 应用的基本信息](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126162) | 查询 OCP 应用的基本信息，包括：版本号、构建日期、Java 版本等信息。 |
| 健康检查 | [查询 OCP 服务端的时间](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126164) | 查询 OCP 服务端的时间，该接口一般用于确认本地时间与服务端时间是否同步。 |
| 健康检查 | [查询 OCP 应用状态](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126163) | 查询 OCP 应用状态。该接口检查 OCP 应用各模块的状态，返回是否全部状态都处于健康状态。 |

## 附录

| 模块 | API 名称 | 说明 |
| --- | --- | --- |
| 附录 | [任务返回结构](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000125978) | TaskInstance 的数据结构说明。 |
| 附录 | [告警 API 接入示例](https://www.oceanbase.com/docs/enterprise-oceanbase-ocp-cn-1000000000126177) | 为您介绍将 OCP 的告警接入到用户告警平台的操作。 |

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线