Skip to main content
Deployment

获取 Deployment

根据 ID 获取单个 Deployment 的详细信息。

前提

已完成 Endpoint 与鉴权配置,详见API 总览与认证

接口

GET /deployments/{deployment_id}

路径参数

参数必填类型说明
deployment_idstringDeployment ID

请求示例

curl "$AGENTSTUDIO_URL/deployments/depl_xxx" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

响应

{
  "id": "depl_xxx",
  "type": "deployment",
  "name": "每日订单汇总",
  "status": "active",
  "agent": {
    "id": "agent_xxx",
    "version": 12
  },
  "environment_id": "env_xxx",
  "schedule": {
    "type": "cron",
    "expression": "0 9 * * 1-5",
    "timezone": "Asia/Shanghai",
    "last_run_at": null,
    "next_run_at": "2026-07-28T01:00:00Z"
  },
  "initial_events": [
    {
      "type": "message",
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "汇总昨日订单数据"
        }
      ]
    }
  ],
  "resources": [],
  "vault_ids": [],
  "metadata": {},
  "paused_reason": null,
  "archived_at": null,
  "created_at": "2026-07-28T01:00:00Z",
  "updated_at": "2026-07-28T01:00:00Z",
  "request_id": "req_xxx"
}

响应字段

字段类型说明
idstringDeployment ID
typestring固定值 deployment
namestringDeployment 名称
descriptionstring部署用途描述
agentobject
environment_idstring
scheduleobject
initial_eventsarray<object>
resourcesarray<object>
vault_idsarray<string>
metadataobject
statusstring
paused_reasonobject | null暂停原因,仅暂停状态时返回
archived_atstring | null
created_atstring
updated_atstring
request_idstring本次请求的唯一标识,排查问题时附带

错误码

状态码错误码说明
400InvalidParameterRequired parameter missing or invalid.
401InvalidApiKeyInvalid API-key provided.
404DEPLOYMENT_NOT_FOUNDDeployment not found.