在 Elasticsearch 中，**许可证（License）** 用于控制集群的功能和权限。Elasticsearch 提供了多种许可证类型，包括 **Basic（免费）**、**Trial（试用）** 和 **订阅许可证（如 Gold、Platinum、Enterprise）**。如果你需要更新或更改许可证，可以按照以下步骤操作。
---
## 1. **查看当前许可证**
在更新许可证之前，可以先查看当前集群的许可证信息。
### 使用 API 查看许可证
```bash
GET /_license
```
### 响应示例
```json
{
"license": {
"status": "active",
"uid": "12345678-1234-1234-1234-123456789012",
"type": "basic", // 当前许可证类型
"issue_date": "2023-01-01T00:00:00.000Z",
"issue_date_in_millis": 1672531200000,
"expiry_date": "2023-12-31T23:59:59.999Z",
"expiry_date_in_millis": 1704067199999,
"max_nodes": 1000,
"issued_to": "My Company",
"issuer": "Elasticsearch"
}
}
```
---
## 2. **更新许可证**
### （1）**从 Basic 升级到 Trial**
如果你使用的是 **Basic 许可证**，可以免费升级到 **Trial 许可证**，试用 30 天的 Platinum 功能。
#### 使用 API 启动试用
```bash
POST /_license/start_trial?acknowledge=true
```
#### 响应示例
```json
{
"acknowledged": true,
"trial_was_started": true,
"type": "trial"
}
```
#### 注意事项
- 每个集群只能启动一次试用。
- 试用期结束后，集群会自动回退到 Basic 许可证。
---
### （2）**更新订阅许可证**
如果你购买了 Elasticsearch 的订阅许可证（如 Gold、Platinum、Enterprise），可以通过上传新的许可证文件来更新。
#### 步骤：
1. **获取许可证文件**：
- 登录 [Elasticsearch 官网](https://www.elastic.co/)。
- 在订阅管理页面下载新的许可证文件（通常是一个 JSON 文件）。
2. **上传许可证文件**：
使用以下 API 上传许可证文件：
```bash
POST /_license?acknowledge=true
{
"licenses": [
{
"uid": "12345678-1234-1234-1234-123456789012",
"type": "platinum", // 许可证类型
"issue_date": "2023-01-01T00:00:00.000Z",
"expiry_date": "2024-01-01T23:59:59.999Z",
"max_nodes": 1000,
"issued_to": "My Company",
"issuer": "Elasticsearch",
"signature": "..." // 许可证签名
}
]
}
```
#### 响应示例
```json
{
"acknowledged": true,
"license_status": "valid"
}
```
#### 注意事项
- 确保许可证文件的格式和内容正确。
- 如果许可证已过期或无效，上传会失败。
---
### （3）**从 Trial 回退到 Basic**
试用期结束后，集群会自动回退到 Basic 许可证。如果需要手动回退，可以删除当前许可证。
#### 使用 API 删除许可证
```bash
DELETE /_license
```
#### 响应示例
```json
{
"acknowledged": true
}
```
---
## 3. **许可证类型及其功能**
| 许可证类型 | 功能描述 |
|--------------|--------------------------------------------------------------------------|
| **Basic** | 免费许可证，支持基本功能（如搜索、聚合）。 |
| **Trial** | 试用许可证，提供 30 天的 Platinum 功能（如机器学习、安全功能）。 |
| **Gold** | 提供高级功能（如监控、警报）。 |
| **Platinum** | 提供更多高级功能（如机器学习、安全功能、跨集群搜索）。 |
| **Enterprise** | 提供所有功能，包括高级安全性和操作功能。 |
---
## 4. **注意事项**
- **许可证过期**：如果许可证过期，集群会进入 **过期模式**，部分功能可能受限。
- **集群健康状态**：更新许可证时，确保集群处于健康状态（`green` 或 `yellow`）。
- **备份数据**：在更新许可证之前，建议备份重要数据。
- **版本兼容性**：确保许可证与 Elasticsearch 版本兼容。
---
## 5. **总结**
- 使用 `GET /_license` 查看当前许可证信息。
- 使用 `POST /_license/start_trial` 启动试用许可证。
- 使用 `POST /_license` 上传新的订阅许可证。
- 使用 `DELETE /_license` 删除当前许可证（回退到 Basic）。
如果你有更多关于 Elasticsearch 许可证的问题，欢迎继续提问！
