Deployment

触发 Deployment

手动触发一次部署运行

POST

/api/v1/agentstudio/deployments/{deployment_id}/run

cURL

curl --request POST \
  --url 'https://dashscope.aliyuncs.com/api/v1/agentstudio/deployments/{deployment_id}/run' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "id": "drun_xxx",
  "type": "deployment_run",
  "deployment_id": "depl_xxx",
  "agent": {
    "id": "agent_xxx",
    "version": 13
  },
  "session_id": null,
  "trigger_source": "manual",
  "status": "running",
  "error": null,
  "started_at": "2026-07-28T02:00:00Z",
  "finished_at": null,
  "request_id": "req_xxx"
}

鉴权

string

header

必填

DashScope API Key

路径参数

string

必填

Deployment ID

响应

200-application/json

string

Deployment Run ID

string

固定值 deployment_run

string

object

显示子属性

string

integer

string | null

异步 Session 创建完成前为 null

enum<string>

可选值：manual,schedule

enum<string>

可选值：running,succeeded,failed

object | null

错误信息，仅运行失败时返回

string

ISO 8601 时间戳

string | null

string

cURL

curl --request POST \
  --url 'https://dashscope.aliyuncs.com/api/v1/agentstudio/deployments/{deployment_id}/run' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

{
  "id": "drun_xxx",
  "type": "deployment_run",
  "deployment_id": "depl_xxx",
  "agent": {
    "id": "agent_xxx",
    "version": 13
  },
  "session_id": null,
  "trigger_source": "manual",
  "status": "running",
  "error": null,
  "started_at": "2026-07-28T02:00:00Z",
  "finished_at": null,
  "request_id": "req_xxx"
}