---
title: "查询租户详情 | OceanBase 文档中心"
description: "查询租户详情 功能说明 查询指定租户详情。 调用说明 接口约束 调用者需要具备指定集群的读权限。 请求路径 GET /api/v2/ob/clusters/{clusterId}/tenants/{tenantId} path 参数 类型 必选 示例值 描述 clusterld Long 是 1 目标租户所属集群的 …"
---
切换语言

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

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

# 查询租户详情

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

## 功能说明

查询指定租户详情。

## 调用说明

### 接口约束

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

### 请求路径

`GET /api/v2/ob/clusters/{clusterId}/tenants/{tenantId}`

**path**

| 参数 | 类型 | 必选 | 示例值 | 描述 |
| --- | --- | --- | --- | --- |
| clusterld | Long | 是 | 1 | 目标租户所属集群的 ID。 |
| tenantId | Long | 是 | 5 | 目标租户 ID。 |

### 返回结果

基础数据结构

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| data | Object | 租户详情 |
| successful | Boolean | 请求是否成功。 |
| timestamp | Datetime | 服务端完成请求的时间戳。 |
| duration | Integer | 服务端处理请求的时间（毫秒）。 |
| status | Integer | 符合 HTTP Status 规范的编码。 |
| traceId | String | 请求的 Trace ID，用于排查问题。 |
| server | String | 响应请求的服务端的地址。 |

租户详情的数据结构

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| id | Long | 租户的 ID 。 |
| name | String | 租户的名称。 |
| clusterName | String | 租户所属集群的名称。 |
| clusterId | Long | 租户所属集群的 ID。 |
| obClusterId | Long | 租户所属集群在 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 | 租户的描述信息。 |
| charset | String | 字符集 |
| collation | String | 排序规则 |
| zones | Array | TenantZone 列表 |
| whitelist | String | 白名单 |

TenantZone 数据结构

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| name | String | zone名 |
| replicaType | String | 副本类型 |
| resourcePool | Object | ResourcePool 数据结构 |
| units | Array | Unit 列表 |

ResourcePool 数据结构

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| id | String | 资源池 ID |
| name | String | 资源池名称 |
| unitCount | Integer | Unit 个数 |
| unitConfig | Object | UnitConfig 数据结构 |

UnitConfig 数据结构

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| maxCpuCoreCount | Double | 最大 CPU 个数 |
| minCpuCoreCount | Double | 最小 CPU 个数 |
| maxMemorySize | Integer | 最大内存，单位 GB |
| minMemorySize | Integer | 最小内存，单位 GB |

Unit 数据结构

| 参数 | 类型 | 说明 |
| --- | --- | --- |
| id | Integer | Uint ID |
| resourcePoolId | Integer | 所属资源池 ID |
| serverId | Integer | 所属 OBServer 节点ID |
| serverIp | String | 所属 OBServer 节点IP |
| serverPort | Integer | 所属 OBServer 节点端口 |
| zoneName | String | Zone 名称 |
| status | String | Unit 状态 |

## 示例

### 请求示例

`GET /api/v2/ob/clusters/8/tenants/9`

### 返回示例

```unknow
{
  "data": {
    "charset": "utf8mb4",
    "clusterId": 12000001,
    "clusterName": "protoss",
    "clusterStatus": "RUNNING",
    "clusterType": "PRIMARY",
    "collation": "utf8mb4_general_ci",
    "createTime": "2021-09-02T16:39:57+08:00",
    "id": 14000001,
    "locality": "FULL{1}@zone1",
    "locked": false,
    "mode": "MYSQL",
    "name": "sys",
    "obClusterId": 22,
    "obTenantId": 1,
    "obVersion": "3.1.0",
    "primaryZone": "zone1",
    "readonly": false,
    "sqlAuditEnabled": true,
    "status": "NORMAL",
    "whitelist": "%",
    "zoneList": "zone1",
    "zones": [
      {
        "name": "zone1",
        "replicaType": "FULL",
        "resourcePool": {
          "id": 1,
          "name": "sys_pool",
          "unitConfig": {
            "maxCpuCoreCount": 5.00,
            "maxMemorySize": 9,
            "minCpuCoreCount": 2.50,
            "minMemorySize": 8
          },
          "unitCount": 1
        },
        "units": [
          {
            "id": 1,
            "resourcePoolId": 1,
            "serverId": 12000001,
            "serverIp": "xxx.xxx.xxx.xxx",
            "serverPort": 2882,
            "status": "ACTIVE",
            "zoneName": "zone1"
          }
        ]
      }
    ]
  },
  "duration": 476,
  "server": "a83ad33525",
  "status": 200,
  "successful": true,
  "timestamp": "2021-09-06T00:47:21.093+08:00",
  "traceId": "0b10e088732d432e"
}

```

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