文档首页/ 智果（AgentArts）智能体平台/ API参考/ API/ 智能体优化/ 模型部署/ 查询模型部署详情 - ShowOpsModelDeployment
更新时间：2026-11-09 GMT+08:00
查看PDF
分享

查询模型部署详情 - ShowOpsModelDeployment

功能介绍

本接口用于精确获取某个指定的模型部署的全景元数据。与列表查询相比，它无需复杂过滤，直接通过唯一的 deployment_id 命中目标，返回包括绑定的智能体信息、上下游服务ID、最新运行状态以及最终生成的推理API调用地址等核心字段。

适用场景：

查询特定部署实例的完整配置信息与实时状态等信息。

调用方法

请参见如何调用API。

授权信息

账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

agentarts:modelTuningTask:showOpsModelDeployment

Read

modelTuningTask *

g:ResourceTag/<tag-key>

-

-

URI

GET /v1/ops/model-deployments/{deployment_id}

表1 路径参数

参数

是否必选

参数类型

描述

deployment_id

是

String

参数解释：模型部署任务ID，获取方法请参见查询模型部署列表 - ListOpsModelDeployments。

约束限制：不涉及

取值范围：长度为32的部署ID字符串，最小长度32，最大长度32。

默认取值：无

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

id

String

参数解释：

部署任务ID，标识部署任务的唯一标识符。

取值范围：

UUID格式字符串。

task_id

String

参数解释：

关联的模型优化任务ID。

取值范围：

任务ID字符串。

product_id

String

参数解释：

模型优化任务产物ID。

取值范围：

产物ID字符串。

task_name

String

参数解释：

模型优化任务名称。

取值范围：

任务名称字符串。

agent

OpsTuningTargetAgent object

参数解释：

调优目标对象，包含目标智能体的配置信息。

取值范围：

符合OpsTuningTargetAgent定义的对象。

model_name

String

参数解释：

被调优的模型名称。

取值范围：

模型名称字符串，最小长度1，最大长度64。

ma_service_id

String

参数解释：

ModelArts服务ID，关联底层ModelArts平台的服务实例。

取值范围：

ModelArts侧的服务ID字符串，最小长度1，最大长度32。

model_provider_id

String

参数解释：

模型提供商ID，标识模型来源的服务商。

取值范围：

提供商标识字符串。

model_service_id

String

参数解释：

模型服务ID，本平台生成的服务唯一标识。

取值范围：

模型服务唯一标识字符串。

model_service_name

String

参数解释：

模型服务名称。

取值范围：

模型服务显示名称

api_url

String

参数解释：

部署服务API地址。

取值范围：

合法的URL字符串。

status

String

参数解释：

部署服务状态。

取值范围：

deploying：部署中，running：运行中，stopping：停止中，stopped：已停止，starting：启动中，fail：部署失败，deleting：删除中，access_fail：接入失败。

created_at

Long

参数解释：

创建时间，单位：毫秒（13位时间戳）。

取值范围：

13位毫秒级时间戳，最小值0，最大值9223372036854775807。

fail_reason

String

参数解释：

部署错误信息。

取值范围：

无。
表3 OpsTuningTargetAgent

参数

参数类型

描述

type

String

参数解释：

智能体类型，区分优化目标是单智能体还是工作流。

取值范围：

单智能体agent，工作流workflow。

id

String

参数解释：

智能体ID，对应AgentArts平台中的智能体实例。

可在AgentArts平台“开发中心 > 智能体管理”页面获取ID，注意对应的智能体需要是“已提交”状态。

取值范围：

有效标识符字符串，最小长度1，最大长度64。

version

String

参数解释：

智能体版本。

取值范围：

版本号字符串，最小长度0，最大长度32。

node_type

String

参数解释：

工作流节点类型，仅当type为workflow时有效，指定优化工作流中的哪类节点。

取值范围：

意图识别intent_detection，大模型llm。

node_id

String

参数解释：

工作流节点ID，对应工作流中特定节点的唯一标识。

可在AgentArts平台“开发中心 > 智能体管理”页面获取ID，注意对应的工作流需要是“已提交”状态。

取值范围：

有效节点标识符字符串，最小长度0，最大长度64。

状态码：400

表4 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

机器可读的错误代码。

取值范围：

系统错误码字符串。

error_msg

String

参数解释：

人类可读的错误消息。

取值范围：

详细错误说明字符串。

状态码：404

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

机器可读的错误代码。

取值范围：

系统错误码字符串。

error_msg

String

参数解释：

人类可读的错误消息。

取值范围：

详细错误说明字符串。

状态码：500

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

机器可读的错误代码。

取值范围：

系统错误码字符串。

error_msg

String

参数解释：

人类可读的错误消息。

取值范围：

详细错误说明字符串。

请求示例

用于精确获取某个指定部署任务的全景元数据。

GET /v1/ops/model-deployments/deploy-9876543210fedcba

响应示例

状态码：200

{
  "id" : "deploy-9876543210fedcba",
  "task_id" : "57ae91cf2f504899921a50d1c75f0547",
  "product_id" : "prod-1234567890abcdef",
  "task_name" : "数学推理优化任务",
  "agent" : {
    "type" : "agent",
    "id" : "f0fab58d-8285-4c47-b856-1079cad579da",
    "version" : null,
    "node_type" : "intent_detection",
    "node_id" : "node_1773821451705"
  },
  "model_name" : "qwen3_8b",
  "ma_service_id" : "ma-svc-123456",
  "model_provider_id" : "provider-qwen",
  "model_service_id" : "model-svc-789",
  "model_service_name" : "my-math-reasoning-service",
  "api_url" : "https://modelarts-api.example.com/v1/services/my-math-reasoning-service",
  "status" : "running",
  "created_at" : 1704240000000
}

状态码

状态码

描述

200

模型部署详情。

400

无效的请求参数。

404

模型部署未找到。

500

内部服务器错误。

错误码

请参见错误码。

父主题： 模型部署

相关文档