Skip to content

1. 创建作业

  • Token: 此接口需要 Token 调用,需要先调用登录接口换取 Token。
  • 费用:作业创建运行以后开始计费,创建过程及排队中不收费,创建不成功不收费。根据资源类型与使用量确定单价。使用量目前只有GPU数量可以调整。CPU内存本地SSD硬盘资源不可以调整,只能申请到GPU数量的预设比例。具体比例请到官网查询。
  • 流量限制:每token每秒50次。
  • 接口作用:创建一个作业(支持批量创建)

接口路径

请求方式

POST 方式,请求参数为 JSON 格式

输入说明

请求头

请求头说明
X-Auth-TokenToken 值

请求体

请求参数选项类型默认值说明
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-TokenToken 值

请求参数

请求参数选项类型默认值说明
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作业名称
gpuNumGPU卡数量
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-TokenToken 值

请求参数

请求参数选项类型默认值说明
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
}

苏州算力科技有限公司版权所有