共绩科技

任务修改接口

POST

/api/deployment/task/update

共绩算力 Open API/任务

更新部署任务的运行时配置参数，需使用动态生成的安全凭证进行签名验证

此接口要求二级密钥加签

更新操作将触发部署系统实时热重载

请求参数

Header 参数

token

string

动态会话令牌

必需

示例值:

1464a876-7cd0-4e1f-89d3-63dbc24cd7f9-20250619093506

正则匹配:

^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}-\d{14}$

version

enum<string>

API版本标识

必需

枚举值:

1.0.0

示例值:

1.0.0

timestamp

integer <int64>

毫秒级时间戳

必需

>= 1609459200000

示例值:

1750386057300

sign_str

string

必需

RSA-2048签名值(Base64编码)

>= 344 字符<= 348 字符

示例值:

PKBQqT3rIy1QdNOBXK3pvKdD/hsGxUxI3bqqO79Zp0FfJwyGD3zX9I6Q53EX3gMULvgQfMjpxRB+mLXCcWcbUfc/VFYKniwxeCmeMA6JsCwKNnysGoxSfFzWlFSS8SvIrOwApr6qg6jIlyZVrtaxwu8Tr5BWyDkelkeSjHhDbEmz/PEeQfGmVT5SK3yHH620GXL2FQ6OZBKlhWhwXTvrxSPmV80Bupgx0be+GAROVcfEqx5FO5/PrZbSel6nL/RMRlkFfZSQDCoIY0VoKH/XE7hnwkBP5KVVvkU2lVJ7pe3gw3tEX96QemHQ9N1/LiTYqP4Ddy5LfQi6PZoHhc4Bmw==

Body 参数application/json

task_id

string

任务全局唯一标识

必需

示例值:

tsk_9d3e8c5a7b

resource_profile

enum<string>

必需

枚举值:

standard_v1gpu_t4gpu_a100

replicas

integer

可选

>= 1<= 50

env_vars

object

可选

额外字段

string

可选

示例

{
    "task_id": "tsk_9d3e8c5a7b",
    "resource_profile": "standard_v1",
    "replicas": 1,
    "env_vars": {
        "property1": "string",
        "property2": "string"
    }
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://openapi.suanli.cn/api/deployment/task/update' \
--header 'token: 1464a876-7cd0-4e1f-89d3-63dbc24cd7f9-20250619093506' \
--header 'version: 1.0.0' \
--header 'timestamp: 1750386057300' \
--header 'sign_str: PKBQqT3rIy1QdNOBXK3pvKdD/hsGxUxI3bqqO79Zp0FfJwyGD3zX9I6Q53EX3gMULvgQfMjpxRB+mLXCcWcbUfc/VFYKniwxeCmeMA6JsCwKNnysGoxSfFzWlFSS8SvIrOwApr6qg6jIlyZVrtaxwu8Tr5BWyDkelkeSjHhDbEmz/PEeQfGmVT5SK3yHH620GXL2FQ6OZBKlhWhwXTvrxSPmV80Bupgx0be+GAROVcfEqx5FO5/PrZbSel6nL/RMRlkFfZSQDCoIY0VoKH/XE7hnwkBP5KVVvkU2lVJ7pe3gw3tEX96QemHQ9N1/LiTYqP4Ddy5LfQi6PZoHhc4Bmw==' \
--header 'Content-Type: application/json' \
--data-raw '{
    "task_id": "tsk_9d3e8c5a7b",
    "resource_profile": "standard_v1",
    "replicas": 1,
    "env_vars": {
        "property1": "string",
        "property2": "string"
    }
}'

返回响应

🟢200成功

application/json

配置更新成功

Headers

x-envoy-upstream-service-time

integer

可选

示例值:

124

Body

code

string

可选

示例值:

0000

reload_duration

number <float>

热重载耗时(秒)

可选

示例值:

1.24

next_validation

string <date-time>

下次配置校验时间

可选

示例值:

2025-06-20T03:05:00Z

示例

{
    "code": "0000",
    "reload_duration": 1.24,
    "next_validation": "2025-06-20T03:05:00Z"
}

修改于 2025-06-20 02:34:56

任务恢复接口

任务自定义YAML校验接口