任务创建接口

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 {3}]

服务资源

必需

service_name

string

服务名

必需

service_image

string

服务镜像

必需

remote_ports

array [object {1}]

必需

示例

{
  "task_name": "suanleme-corn-job-handlererror",
  "resources": [
    {
      "mark": "L3G2WlaG+chj2qDncuEp6ilXCJS/JyMyihjJQqeFKqK17sDwcaU0wePHNv9sSQFheyncQUznNnv4KxTICBx8+rakGl36i6Lt07OsVuBmNXjups8icZRTMuMv4NsRTnf22cxSBoH2+w5O/tMVt6rnGUV4FNnCeQyf5tnXGrF3h1QdDoW5ENkfTk3pozSvQcjMJ2D+OZhs"
    }
  ],
  "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": "L3G2WlaG+chj2qDncuEp6ilXCJS/JyMyihjJQqeFKqK17sDwcaU0wePHNv9sSQFheyncQUznNnv4KxTICBx8+rakGl36i6Lt07OsVuBmNXjups8icZRTMuMv4NsRTnf22cxSBoH2+w5O/tMVt6rnGUV4FNnCeQyf5tnXGrF3h1QdDoW5ENkfTk3pozSvQcjMJ2D+OZhs"
    }
  ],
  "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
    }
}

显卡资源查询接口

任务列表查询接口