---
title: "查询全部租户列表 | OceanBase 文档中心"
description: 查询全部租户列表 功能说明 查询全部租户列表。 调用说明 接口约束 调用者需要通过 OCP 应用服务鉴权。 只会返回调用者具有集群读权限下的租户。 请求路径 GET /api/v2/ob/tenants 请求参数 参数 类型 必选 示例值 描述 page Integer 否 1 请求数据的分页页码。值从 1 开始。 …
---
切换语言

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

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

# 查询全部租户列表

更新时间：2023-08-10 11:45:58

## **功能说明**

查询全部租户列表。

## **调用说明**

**接口约束**

- 调用者需要通过 OCP 应用服务鉴权。
 - 只会返回调用者具有集群读权限下的租户。

**请求路径**

`GET /api/v2/ob/tenants`

**请求参数**

| 参数 | 类型 | 必选 | 示例值 | 描述 |
| --- | --- | --- | --- | --- |
| page | Integer | 否 | 1 | 请求数据的分页页码。值从 1 开始。 默认值：1 |
| size | Integer | 否 | 10 | 请求数据的分页大小。 默认值：10 最大值：2000 |
| sort | String | 否 | name,asc | 请求数据的排序规则。 |
| name | String | 否 | foo | 查询名称包含关键词的租户，不区分大小写。 |
| mode | StringArray | 否 | ORACLE | 查询指定模式的租户。 * ORACLE：Oracle 模式。 * MYSQL：MySQL 模式。 |
| locked | Boolean | 否 | false | 根据租户的锁定状态查询。 * 不指定时，查询所有租户。 * 值为 true 时，只查询处于锁定状态的租户。 * 值为 false 时，只查询未处于锁定状态的租户。 |
| readonly | Boolean | 否 | false | 根据租户的只读状态查询。 * 不指定时，查询所有租户。 * 值为 true 时，只查询处于只读状态的租户。 * 值为 false 时，只查询未处于只读状态的租户。 |
| status | StringArray | 否 | NORMAL | 查询指定状态的租户。 * NORMAL：运行中 * CREATING：创建中 * MODIFYING：修改中 * DELETING：删除中 |

**返回结果**

- 基础数据结构

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| 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 | 租户所属集群的 Id。 |
| obClusterId | Integer | 租户所属集群在 OB 端的 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：修改中 * DELETING：删除中 |
| locked | Boolean | 租户是否处于锁定状态。 |
| readonly | Boolean | 租户是否处于只读状态。 |
| obVersion | String | 租户所属集群的 OB 版本。 |
| description | String | 租户的描述信息。 |

## **示例**

**请求示例**

查询租户名包含关键词"foo"，租户状态为"运行中"或"创建中"的租户列表。请求分页大小为 10 时，第二页的数据。

```code
GET /api/v2/ob/tenants?name=foo&status=NORMAL,CREATING&page=2&size=10

```

**返回示例**

```code
{
    "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":"foo1",
                "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":"foo2",
                "obClusterId":3,
                "obVersion":"2.2.72",
                "primaryZone":"zone1",
                "readonly":false,
                "status":"NORMAL",
                "zoneList":"zone1"
            }
        ],
        "page":{
            "number":1,
            "size":10,
            "totalElements":9,
            "totalPages":1
        }
    }
}

```

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