---
title: "查询许可证"
date: 2026-01-08
lastmod: 2026-01-08
description: "介绍如何在 Easysearch 中查询许可证信息。"
tags: ["许可证", "集群管理"]
summary: "此 API 用于获取 Easysearch 的许可证信息。
API #  GET /_license GET /_license/info API 的作用 #  返回 Easysearch 集群的许可证信息，包括：
 许可证类型：许可证的类型（如 basic、platinum、enterprise） 许可证 ID：许可证的唯一标识符 颁发给：许可证颁发给的实体 颁发日期：许可证的颁发时间 有效期：许可证的生效和失效时间 节点限制：许可证允许的最大节点数 产品信息：许可证覆盖的产品 签名：许可证的数字签名  API 的参数 #  路由参数 #  此 API 没有路由参数。
查询字符串参数 #  此 API 没有查询字符串参数。
请求示例 #  # 查询许可证信息 GET /_license # 查询详细许可证信息 GET /_license/info 响应示例 #  成功响应 #  { "license": { "uid": "easysearch-license-uid", "type": "enterprise", "issue_to": "INFINI Labs", "issuer": "INFINI Labs", "issue_date_in_millis": 1672531200000, "expiry_date_in_millis": 1734067200000, "max_nodes": 10, "issued_to": "INFINI Labs", "start_date_in_millis": 1672531200000 }, "status": "active" } 详细响应（GET /_license/info） #  { "license": { "license_type": "enterprise", "license_id": "LICENSE-12345", "issue_to": "Customer Name", "issue_at": "2023-01-01T00:00:00Z", "valid_from": "2023-01-01T00:00:00Z", "expire_at": "2024-12-31T23:59:59Z", "max_nodes": 10, "product": "Easysearch Enterprise", "signature": "BASE64_ENCODED_SIGNATURE", "metadata": { "contact_email": "support@example."
---


此 API 用于获取 Easysearch 的许可证信息。

## API

```
GET /_license
GET /_license/info
```

## API 的作用

返回 Easysearch 集群的许可证信息，包括：

- **许可证类型**：许可证的类型（如 basic、platinum、enterprise）
- **许可证 ID**：许可证的唯一标识符
- **颁发给**：许可证颁发给的实体
- **颁发日期**：许可证的颁发时间
- **有效期**：许可证的生效和失效时间
- **节点限制**：许可证允许的最大节点数
- **产品信息**：许可证覆盖的产品
- **签名**：许可证的数字签名

## API 的参数

### 路由参数

此 API **没有**路由参数。

### 查询字符串参数

此 API **没有**查询字符串参数。

## 请求示例

```bash
# 查询许可证信息
GET /_license

# 查询详细许可证信息
GET /_license/info
```

## 响应示例

### 成功响应

```json
{
  "license": {
    "uid": "easysearch-license-uid",
    "type": "enterprise",
    "issue_to": "INFINI Labs",
    "issuer": "INFINI Labs",
    "issue_date_in_millis": 1672531200000,
    "expiry_date_in_millis": 1734067200000,
    "max_nodes": 10,
    "issued_to": "INFINI Labs",
    "start_date_in_millis": 1672531200000
  },
  "status": "active"
}
```

### 详细响应（GET /_license/info）

```json
{
  "license": {
    "license_type": "enterprise",
    "license_id": "LICENSE-12345",
    "issue_to": "Customer Name",
    "issue_at": "2023-01-01T00:00:00Z",
    "valid_from": "2023-01-01T00:00:00Z",
    "expire_at": "2024-12-31T23:59:59Z",
    "max_nodes": 10,
    "product": "Easysearch Enterprise",
    "signature": "BASE64_ENCODED_SIGNATURE",
    "metadata": {
      "contact_email": "support@example.com",
      "company": "Example Company"
    }
  }
}
```

### 响应字段说明

| 字段 | 描述 |
|------|------|
| `uid` | 许可证唯一标识符 |
| `type` | 许可证类型<br>`basic`：基础版<br>`platinum`：白金版<br>`enterprise`：企业版 |
| `issue_to` | 许可证颁发给的实体 |
| `issuer` | 许可证颁发者 |
| `issue_date_in_millis` | 颁发时间（毫秒） |
| `expiry_date_in_millis` | 失效时间（毫秒） |
| `max_nodes` | 允许的最大节点数 |
| `issued_to` | 颁发给 |
| `start_date_in_millis` | 生效时间（毫秒） |
| `status` | 许可证状态<br>`active`：有效<br>`expired`：已过期<br>`invalid`：无效 |

## 许可证类型说明

| 类型 | 功能 |
|------|------|
| `basic` | 基础功能 |
| `standard` | 标准功能 |
| `platinum` | 高级功能 |
| `enterprise` | 企业级功能 |

## 使用场景

1. **许可证验证**：确认集群许可证的有效性
2. **容量规划**：检查许可证允许的最大节点数
3. **到期提醒**：监控许可证到期时间
4. **合规检查**：验证许可证使用是否符合规定

## 许可证过期处理

当许可证过期时：

- 集群可能进入受限模式
- 某些功能可能被禁用
- 建议及时更新许可证

## 注意事项

1. 此 API 只支持 GET 方法
2. `GET /_license/info` 返回更详细的许可证信息
3. 许可证信息是只读的，无法通过 API 修改
4. 许可证签名验证确保许可证未被篡改

## 相关文档

- [获取集群状态](./get-cluster-state.md)
- [获取集群统计信息](./get-cluster-stats.md)