任务创建接口

POST

/api/deployment/task/create

任务创建接口，资源信息需要通过 “显卡资源查询接口” 获取（mark标识）。
如果使用了不存在的资源类型（mark标识），尽管接口会返回成功，GUI面板上也能看到任务被成功创建，但是因为实际资源不存在，任务无法匹配到GPU，Pod不会被分配，亦不会扣费。
services数组目前仅支持定义单个service，因而，建议service_name设置为和task_name相同。

*根据 API 密钥的生成模式，此接口可以自行决定是否需要加签。

请求参数

Header 参数

token

string

必需

timestamp

string

必需

示例值:

1747379023000

version

string

必需

示例值:

1.0.0

sign_str

string

可选

如果token为简易模式则无需填写此字段

Body 参数application/json

task_name

string

任务名

必需

resources

array [object {1}]

设备资源

必需

mark

string

资源mark标识，资源信息需要通过 “显卡资源查询接口” 获取

可选

points

integer

任务点数

必需

services

array [object {5}]

服务资源

必需

service_name

string

服务名

必需

service_image

string

服务镜像

必需

remote_ports

array [object {1}]

必需

env

string | null

环境变量

必需

storage_config

array [object {2}] | null

共享存储配置

必需

示例

{
  "task_name": "suanleme-corn-job-handlererror",
  "resources": [
    {
      "mark": "ha8GDGEAORN3a9Hhu7X+W/lveP9CW2eBkI+oB/QJLRcGvP7UMvA5irnPib2YTSwc3AN4DULuanCCqEj1LwDsR/IhlpYRSzIvKasM+AcJsuNXRGWqp1qI1Tx3A4TqmQRdHvNEuWujXhLX2FryHDG12cwUBmylTvRgY+fCH36uh5i6M170xTAuF7zCZBY="
    }
  ],
  "points": 1,
  "services": [
    {
      "service_name": "suanleme-corn-job-handlererror",
      "service_image": "harbor.suanleme.cn/library/ffmpeg-api:cpu",
      "remote_ports": [
        {
          "service_port": 8000
        }
      ],
      "env": null,
      "start_script": null
    }
  ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.suanli.cn/api/deployment/task/create' \
--header 'token;' \
--header 'timestamp: 1747379023000' \
--header 'version: 1.0.0' \
--header 'sign_str;' \
--header 'Content-Type: application/json' \
--data-raw '{
  "task_name": "suanleme-corn-job-handlererror",
  "resources": [
    {
      "mark": "ha8GDGEAORN3a9Hhu7X+W/lveP9CW2eBkI+oB/QJLRcGvP7UMvA5irnPib2YTSwc3AN4DULuanCCqEj1LwDsR/IhlpYRSzIvKasM+AcJsuNXRGWqp1qI1Tx3A4TqmQRdHvNEuWujXhLX2FryHDG12cwUBmylTvRgY+fCH36uh5i6M170xTAuF7zCZBY="
    }
  ],
  "points": 1,
  "services": [
    {
      "service_name": "suanleme-corn-job-handlererror",
      "service_image": "harbor.suanleme.cn/library/ffmpeg-api:cpu",
      "remote_ports": [
        {
          "service_port": 8000
        }
      ],
      "env": null,
      "start_script": null
    }
  ]
}'

返回响应

🟢200成功

application/json

Body

code

string

响应码

必需

message

string

响应信息

必需

data

object

必需

task_id

integer

任务id，可用于其他任务相关操作

必需

示例

{
    "code": "0000",
    "message": "success",
    "data": {
        "task_id": 504
    }
}

修改于 2025-07-08 10:44:58

显卡资源查询接口

任务列表查询接口