外观
1. 创建作业
- Token: 此接口需要 Token 调用,需要先调用登录接口换取 Token。
- 费用:作业创建运行以后开始计费,创建过程及排队中不收费,创建不成功不收费。根据资源类型与使用量确定单价。使用量目前只有GPU数量可以调整。CPU内存本地SSD硬盘资源不可以调整,只能申请到GPU数量的预设比例。具体比例请到官网查询。
- 流量限制:每token每秒50次。
- 接口作用:创建一个作业(支持批量创建)
接口路径
请求方式
POST 方式,请求参数为 JSON 格式
输入说明
请求头
请求头 | 说明 |
---|---|
X-Auth-Token | Token 值 |
请求体
请求参数 | 选项 | 类型 | 默认值 | 说明 |
---|---|---|---|---|
imageId | 必填 | 整数 | 空 | 镜像ID |
resourceForeignId | 必填 | 整数 | 无 | 资源对应的foreignid |
regionId | 必填 | 整数 | 无 | 资源所在的区域ID |
name | 必填 | 字符串 | 空 | 作业名称, 只是用于展示作用,格式不限 |
gpuNum | 必填 | 整数 | 无 | gpu数量, 选项[1,2,4,8] |
replicas | 可选 | 整数 | 无 | 副本数 |
command | 可选 | 列表 | 0 | 启动命令 |
envs | 可选 | 列表 | 空 | 环境变量 |
示例
json
{
"resourceForeignId": 110032,
"imageId": 1122,
"name": "测试",
"gpuNum": 1,
"regionId": 1,
"replicas": 1,
"command": ["sleep 10"],
"envs": [{"key": "", "value": ""}]
}
输出说明
请求参数 | 说明 |
---|---|
code | 响应码,成功为 200,非 200 状态码为失败,参考 msg 错误信息 |
msg | 响应信息,成功状态下为 null,失败状态下为具体错误信息 |
data | 响应数据 |
示例
json
{
"code": 200,
"msg": "任务创建成功",
"data": None
}
2. 列出所有作业及其状态
- Token: 此接口需要 Token 调用,需要先调用登录接口换取 Token。
- 费用:不收费
- 流量限制:每token每秒50次。
- 接口作用:列出所有作业
接口路径
请求方式
GET 方式
输入说明
请求头
请求头 | 说明 |
---|---|
X-Auth-Token | Token 值 |
请求参数
请求参数 | 选项 | 类型 | 默认值 | 说明 |
---|---|---|---|---|
name | 可选 | 字符串 | 空 | 作业名称 |
示例
http://12.2.100.11:9001/casdao/api/v1.0/k8s/spaces/job_list?name="测试"
输出说明
请求参数 | 说明 |
---|---|
code | 响应码,成功为 200,非 200 状态码为失败,参考 msg 错误信息 |
msg | 响应信息,成功状态下为 null,失败状态下为具体错误信息 |
data | 响应数据 |
id | 作业ID |
queue_name | 所属队列名称 |
deploy_name | 作业对应的实例ID |
status | 作业状态,queuing 排队中 creating 创建中 running 运行中 completed 正常结束 failed 运行失败 closed 余额不足关机 paused退出队列 |
description | 备注 |
create_time | 创建时间 |
start_time | 启动时间 |
end_time | 结束时间 |
image_id | 作业对应的镜像id |
name | 作业名称 |
gpuNum | GPU卡数量 |
resource_id | 型号ID |
region_id | 区域ID |
node_id | 节点ID |
replicas | 副本数 |
command | 启动命令 |
envs | 环境变量 |
ports | 端口号 |
namespace | 名称空间 |
user_id | 用户ID |
external_resource_id | 资源ID |
department_name | 运营机构 |
示例
json
{
"code": 200,
"msg": "success",
"data": {
"list_data": [
{
"id": 1,
"queue_name": "queue:L40S:1",
"deploy_name": "test-ocean-8962",
"status": "completed",
"description": "Job completed",
"create_time": "2025-03-14 14:42:33",
"start_time": "2025-03-14 06:42:37",
"end_time": "2025-03-14 06:43:01",
"image_id": 942,
"name": "KSD-mktpmhke-1",
"gpuNum": 1,
"resource_id": 29,
"region_id": 1,
"node_id": 75,
"replicas": 1,
"command": "[\"sleep 20\"]",
"envs": "[{\"key\": \"\", \"value\": \"\"}]",
"ports": "null",
"namespace": "con0002",
"user_id": 7,
"external_resource_id": 31,
"department_name": "算力互联"
}
],
"total": 1
}
}
3. 删除作业
- Token: 此接口需要 Token 调用,需要先调用登录接口换取 Token。
- 费用:不收费
- 流量限制:每token每秒50次。
- 接口作用:删除指定的作业
接口路径
请求方式
GET 方式
输入说明
请求头
请求头 | 说明 |
---|---|
X-Auth-Token | Token 值 |
请求参数
请求参数 | 选项 | 类型 | 默认值 | 说明 |
---|---|---|---|---|
job_id | 必填 | 整数 | 空 | 作业ID |
示例
http://12.2.100.11:9001/casdao/api/v1.0/k8s/spaces/delete_job?job_id=1
输出说明
请求参数 | 说明 |
---|---|
code | 响应码,成功为 200,非 200 状态码为失败,参考 msg 错误信息 |
msg | 响应信息,成功状态下为 null,失败状态下为具体错误信息 |
data | 响应数据 |
示例
json
{
"code": 200,
"msg": "删除成功",
"data": None
}