---
title: "查询集群的租户列表 - 云平台 OCP V4.3.0 | OceanBase 文档中心"
description: "查询集群的租户列表 功能说明 查询集群的租户列表。 调用说明 接口约束 调用者需要具备指定集群的读权限。 请求路径 GET /api/v2/ob/clusters/{id}/tenants 请求参数 path： 参数 类型 必选 示例值 描述 id Integer 是 1000002 OCP 端的集群 ID。 bod…"
---
切换语言

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

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

# 查询集群的租户列表

更新时间：2026-04-14 11:55:54

[编辑](https://github.com/oceanbase/ocp-doc/edit/V4.3.0/zh-CN/1900.reference-guide/200.api-reference/500.tenant-information/100.query-tenants-of-a-cluster.md)  

## 功能说明

查询集群的租户列表。

## 调用说明

### 接口约束

调用者需要具备指定集群的读权限。

### 请求路径

`GET /api/v2/ob/clusters/{id}/tenants`

### 请求参数

**path：**

| 参数 | 类型 | 必选 | 示例值 | 描述 |
| --- | --- | --- | --- | --- |
| id | Integer | 是 | 1000002 | OCP 端的集群 ID。 |

**body：**

| 参数 | 类型 | 必选 | 示例值 | 描述 |
| --- | --- | --- | --- | --- |
| page | Integer | 否 | 0 | 请求数据的分页页码。值从 1 开始，默认值为 1。 |
| size | Integer | 否 | 10 | 请求数据的分页大小。- 默认值：10 - 最大值：2000 |
| sort | String | 否 | asc,name | 排序规则。 |
| name | String | 否 | foo | 集群名关键词，不区分大小写。 |
| mode | String | 否 | MYSQL | 租户模式：MYSQL、ORACLE。 |
| locked | Boolean | 否 | true | 是否锁定。 |
| readonly | Boolean | 否 | Boolean | 是否只读。 |
| status | StringArray | 否 | CREATING | 租户的状态：- NORMAL：运行中。 - CREATING：创建中。 - MODIFYING：修改中。 - UNAVAILABLE：不可用。 - RESTORING：恢复中。 - DISCONNECTING：解耦中。 - FAILOVER：容灾切换。 - SWITCHOVER：日常切换。 - OPERATING：运维中。 |

### 返回结果

**基础数据结构**

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| data | Object | 请求的业务数据。 |
| ├─ contents | Array | 详情参见 **租户信息的数据结构**。 |
| ├─ page | Object | 分页信息。 |
| ├─ totalElements | Integer | 总记录数。 |
| ├─ totalPage | Integer | 总页数。 |
| ├─ number | Integer | 当前页码。 |
| ├─ size | Integer | 当前页大小。 |
| successful | Boolean | 请求是否成功。 |
| timestamp | Datetime | 服务端完成请求的时间戳。 |
| duration | Integer | 服务端处理请求的时间（毫秒）。 |
| status | Integer | 符合 HTTP Status 规范的编码。 |
| traceId | String | 请求的 Trace ID，用于排查问题。 |
| server | String | 响应请求的服务端的地址。 |

**租户信息数据结构**

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| id | Integer | 租户的 ID。 |
| name | String | 租户的名称。 |
| clusterName | String | 租户所属集群的名称。 |
| clusterId | Integer | 租户所属集群在 OCP 端的集群 ID。 |
| obClusterId | Integer | 租户所属集群在 OceanBase 端的集群 ID。 |
| clusterType | String | 租户所属集群的类型，取值范围：- PRIMARY：主集群 - STANDBY：备集群 |
| mode | String | 租户的模式，取值范围：- ORACLE：Oracle 模式 - MYSQL：MySQL 模式 |
| createTime | Datetime | 租户的创建时间。 |
| primaryZone | String | 租户的 Zone 优先级。 |
| zoneList | String | 租户的 Zone List。 |
| locality | String | 租户的副本分布。 |
| status | String | 租户的状态，取值范围：- NORMAL：运行中。 - CREATING：创建中。 - MODIFYING：修改中。 - UNAVAILABLE：不可用。 - RESTORING：恢复中。 - DISCONNECTING：解耦中。 - FAILOVER：容灾切换。 - SWITCHOVER：日常切换。 - OPERATING：运维中。 |
| locked | Boolean | 租户是否处于锁定状态。 |
| readonly | Boolean | 租户是否处于只读状态。 |
| obVersion | String | 租户所属集群的 OceanBase 版本。 |
| description | String | 租户的描述信息。 |

## 示例

### 请求示例

查询 ID 为 1000002 的集群下的所有租户。

```json
GET /api/v2/ob/clusters/1000002/tenants

```

### 返回示例

```json
{
    "duration":197,
    "server": "a83ad33525",
    "status":200,
    "successful":true,
    "timestamp":"2020-11-11T20:52:34.669+08:00",
    "traceId":"47e0c4c4a7a24207",
    "data":{
        "contents":[
            {
                "clusterId":1,
                "clusterName":"foo",
                "clusterType":"PRIMARY",
                "createTime":"2020-01-01T00:00:00+08:00",
                "id":10,
                "locality":"FULL{1}@zone1, FULL{1}@zone2, FULL{1}@zone3",
                "locked":false,
                "mode":"Oracle",
                "name":"first",
                "obClusterId":1,
                "obVersion":"2.2.52",
                "primaryZone":"zone2,zone3;zone1",
                "readonly":false,
                "status":"NORMAL",
                "zoneList":"zone1;zone2;zone3"
            },
            {
                "clusterId":2,
                "clusterName":"bar",
                "clusterType":"PRIMARY",
                "createTime":"2020-01-02T00:00:00+08:00",
                "id":11,
                "locality":"FULL{1}@zone1",
                "locked":true,
                "mode":"MYSQL",
                "name":"second",
                "obClusterId":3,
                "obVersion":"2.2.72",
                "primaryZone":"zone1",
                "readonly":false,
                "status":"NORMAL",
                "zoneList":"zone1"
            }
        ],
        "page":{
            "number":1,
            "size":10,
            "totalElements":9,
            "totalPages":1
        }
    },
    "duration": 95,
    "server": "21dc8a9b83",
    "status": 200,
    "successful": true,
    "timestamp": "2025-05-26T14:38:36.643066258+08:00",
    "traceId": "5b3c49e18a4e1e4d"
}

```

 上一篇 下一篇 ![有帮助](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) 咨询热线