新增任务

POST

https://paas.matpool.com/v1/job

该接口用于创建任务，在用户按需指定任务的运行环境、启动命令、环境变量（选填）等信息，系统将创建任务并自动将任务加入到任务管理队列中。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数multipart/form-data

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://paas.matpool.com/v1/job' \
--form 'spec="{\"gpuName\": \"NVIDIA A16\"}"' \
--form 'envs="model_code=3;env=hello"' \
--form 'from_image_id="633839"' \
--form 'from_snapshot_id=""' \
--form 'cmd="tail -f /dev/null"' \
--form 'remark="job & instance'\''s name"' \
--form 'domain="all"' \
--form 'agent_domain="0"' \
--form 'ports="[{\"port\": 22, \"protocol\":1}, {\"port\": 8888, \"protocol\":2}, {\"port\":8895, \"protocol\":2}]"'

返回响应

🟢200成功

application/json

请求成功后，后台会自动创建一个job

Body

示例

成功示例鉴权失败：token过期或失效参数错误

{
    "code": 0,
    "msg": "",
    "job": {
        "id": 421112,
        "ctx": {
            "ownerId": 724,
            "nodeId": -1,
            "clientID": 10001,
            "nodeDisplayID": "",
            "class": "",
            "aotuRelease": false,
            "releaseTime": null,
            "nodeDomain": 0
        },
        "state": {
            "status": 6,
            "log": []
        },
        "status": 6,
        "app": {
            "name": "",
            "ver": "",
            "envs": "model_code=3;env=hello",
            "format": 2,
            "files": null,
            "cmd": "tail -f /dev/null",
            "hostname": "",
            "creds": "",
            "ports": [
                {
                    "port": 8989,
                    "protocol": 1,
                    "extraData": null
                },
                {
                    "port": 8888,
                    "protocol": 2,
                    "extraData": null
                },
                {
                    "port": 8895,
                    "protocol": 2,
                    "extraData": null
                }
            ],
            "urls": null,
            "fromSnapshotId": 0,
            "SSHAuths": null,
            "netConfig": null,
            "remark": "job & instance's name",
            "fromImageId": 634203
        },
        "res": {
            "cpus": 0,
            "gpus": 0,
            "diskGB": 0,
            "gpuName": "NVIDIA A16",
            "domain": "all",
            "agentDomain": 0
        },
        "createTime": {
            "seconds": 1744017355
        },
        "vols": null,
        "queueLen": 0,
        "nets": null,
        "displayID": "PBy8mz",
        "autoRelease": false,
        "releaseTime": null,
        "updateTime": null,
        "desc": ""
    }
}

修改于 2025-04-08 09:39:17

PaaS API

查询单个任务详情