矩池云开放API
  1. PaaS API
矩池云开放API
  • PaaS API
    • 新增任务
      POST
    • 查询单个任务详情
      GET
    • 查询所有任务状态
      GET
    • 查询所有任务详情
      GET
    • 取消任务
      DELETE
  1. PaaS API

新增任务

POST
https://paas.matpool.com/v1/job
该接口用于创建任务,在用户按需指定任务的运行环境、启动命令、环境变量(选填)等信息,系统将创建任务并自动将任务加入到任务管理队列中。

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数multipart/form-data

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
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

示例
{
    "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
下一页
查询单个任务详情
Built with