【elasticsearch】如何更新许可证（License）

在 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 许可证的问题，欢迎继续提问！