eKuiper REST api允许您上传配置文件并列出所有上传的文件。
## 上传配置文件
支持以下方式上传配置文件:上传文件,提供文件名和文本内容或者提供文件下载链接。上传请求将把文件保存到你的 `${dataPath}/uploads` 。它将覆盖现有的同名文件。返回的响应是上传文件的绝对路径,从而可以在其他配置中使用。
### 上传文件
该API接受多部分的文件上传请求。下面是一个上传文件到 `http://127.0.0.1:9081/config/uploads` 的 html 文件例子。在表格数据中,文件输入名称必须是 `uploadFile` 。
```html
Upload File
```
### 通过文本内容创建文件
若需要上传的为文本文件,可通过提供文件名和其文本内容来创建。
```shell
POST http://localhost:9081/config/uploads
{
"name": "my.json",
"content": "{\"hello\":\"world\"}"
}
```
### 通过文件链接创建文件
文件需提前放到 HTTP 服务器,并提供对外下载链接
```shell
POST http://localhost:9081/config/uploads
{
"name": "my.json",
"file": "http://127.0.0.1:80/my.json"
}
```
## 获取上传文件的列表
该API用于显示 `${dataPath}/uploads` 路径中的所有文件。
```shell
GET http://localhost:9081/config/uploads
```
响应示例:
```json
[
"/ekuiper/data/uploads/zk.gif",
"/ekuiper/data/uploads/abc.gif"
]
```
## 删除已上传文件
该 API 用于删除 `${dataPath}/uploads` 路径下的文件。
```shell
DELETE http://localhost:9081/config/uploads/{fileName}
```