区域
节点所属的地理区域,用于给节点和节点组归类。
regions节点调度鉴权: 仅管理员5 个接口列出区域
GET
/api/v2/regions鉴权: 仅管理员
查询参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | integer | — | 页码,从 1 开始。 |
| page_size | integer | — | 每页条数。 |
| sort | string | — | 排序字段,逗号分隔,前缀 `-` 表示降序,如 `-created_at,id`。 |
创建区域
POST
/api/v2/regions鉴权: 仅管理员
请求体 application/json
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| des | string | — | 备注说明 |
| name | string | 必填 | 名称 |
获取区域
GET
/api/v2/regions/{id}鉴权: 仅管理员
修改区域
PUT
/api/v2/regions/{id}鉴权: 仅管理员
请求体 application/json
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| des | string | — | 备注说明 |
| name | string | — | 名称 |
删除区域
DELETE
/api/v2/regions/{id}鉴权: 仅管理员
区域对象
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| created_at | string | — | 创建时间 |
| des | string | — | 备注说明 |
| id | integer | — | 记录 ID |
| name | string | — | 名称 |
| updated_at | string | — | 更新时间 |