文档首页/ 智果(AgentArts)智能体平台/ API参考/ API/ 智能体优化/ 模型部署/ 查询模型部署列表 - ListOpsModelDeployments
更新时间:2026-11-09 GMT+08:00
分享

查询模型部署列表 - ListOpsModelDeployments

功能介绍

本接口用于分页查询当前租户下的模型优化任务模型部署列表,支持按任务ID、状态、名称等多维度过滤,并返回全局状态统计。

适用场景:

  • 分页浏览所有已部署的模型服务,快速查看服务的运行状态与关联的优化任务。
  • 根据部署状态(如运行中、失败)筛选服务,批量监控在线服务的健康情况,或排查部署失败的任务。

调用方法

请参见如何调用API。

授权信息

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

授权项

访问级别

资源类型(*为必须)

条件键

别名

依赖的授权项

agentarts::listOpsModelDeployments

List

-

-

-

-

URI

GET /v1/ops/model-deployments

表1 Query参数

参数

是否必选

参数类型

描述

offset

否

Integer

参数解释:

索引位置偏移量,用于指定从第几条记录开始返回,单位:条(记录数)。

约束限制:

不涉及

取值范围:

大于等于0且小于等于100000的整数。

默认取值:

0

limit

否

Integer

参数解释:

查询记录数,表示单页返回的最大任务数,单位:条。

约束限制:

不涉及

取值范围:

1到100的正整数。

默认取值:

10

task_id

否

String

参数解释:

模型优化任务ID,标识任务的唯一标识符。获取方法请参考查询模型优化任务列表 - ListOpsModelTuningTasks。

约束限制:

不涉及

取值范围:

真实存在的模型优化任务ID字符串,最小长度0,最大长度32。

默认取值:

无

status

否

String

参数解释:

部署状态,用于根据状态筛选任务。

约束限制:

不涉及

取值范围:

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

默认取值:

无

model_service_name

否

String

参数解释:

模型服务名称。

约束限制:

选填参数,支持模糊匹配。

取值范围:

模型服务名称字符串,最小长度0,最大长度64。长度限制为 url encode 前的长度,单个中文字符仅计算为1个长度。

默认取值:

无

model_name

否

String

参数解释:

模型名称。

约束限制:

选填参数,支持模糊匹配。

取值范围:

模型名称字符串,最小长度0,最大长度255。

默认取值:

无

请求参数

无

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

total

Integer

参数解释:

满足条件的部署记录总数,用于计算分页总页数。

取值范围:

大于等于0的整数。

status_count

DeployTaskStatusCount object

参数解释:

全局任务状态统计对象,包含各状态下的部署任务数量。

取值范围:

符合DeployTaskStatusCount定义的对象。

deployments

Array of OpsModelDeploymentInfo objects

参数解释:

部署任务列表。

取值范围:

符合OpsModelDeploymentInfo定义的对象数组。

表3 DeployTaskStatusCount

参数

参数类型

描述

deploying

Integer

参数解释:

部署中任务个数,单位:个。

取值范围:

0-1000的整数。

running

Integer

参数解释:

运行中任务个数,单位:个。

取值范围:

0-1000的整数。

stopping

Integer

参数解释:

停止中任务个数,单位:个。

取值范围:

0-1000的整数。

stopped

Integer

参数解释:

已停止任务个数,单位:个。

取值范围:

0-1000的整数。

starting

Integer

参数解释:

启动中任务个数,单位:个。

取值范围:

0-1000的整数。

fail

Integer

参数解释:

失败任务个数,单位:个。

取值范围:

0-1000的整数。

deleting

Integer

参数解释:

删除中任务个数,单位:个。

取值范围:

0-1000的整数。

access_fail

Integer

参数解释:

接入失败任务个数,单位:个。

取值范围:

0-1000的整数。

表4 OpsModelDeploymentInfo

参数

参数类型

描述

id

String

参数解释:

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

取值范围:

UUID格式字符串。

task_id

String

参数解释:

关联的模型优化任务ID。

取值范围:

任务ID字符串。

product_id

String

参数解释:

模型优化任务产物ID。

取值范围:

产物ID字符串。

task_name

String

参数解释:

模型优化任务名称。

取值范围:

任务名称字符串。

agent

OpsTuningTargetAgent object

参数解释:

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

取值范围:

符合OpsTuningTargetAgent定义的对象。

model_name

String

参数解释:

被调优的模型名称。

取值范围:

模型名称字符串。

ma_service_id

String

参数解释:

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

取值范围:

ModelArts侧的服务ID字符串。

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删除中。

created_at

Long

参数解释:

创建时间,单位:毫秒(13位时间戳)。

取值范围:

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

fail_reason

String

参数解释:

部署错误信息。

取值范围:

无。

表5 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

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

状态码:500

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

机器可读的错误代码。

取值范围:

系统错误码字符串。

error_msg

String

参数解释:

人类可读的错误消息。

取值范围:

详细错误说明字符串。

请求示例

用于分页查询当前租户下的模型部署任务列表,支持按任务ID、状态、名称等多维度过滤,并返回全局状态统计。

GET /v1/ops/model-deployments?offset=0&limit=10&status=running&model_service_name=test&model_name=qwen3_8b&task_id=12345678901234567890123456789012

响应示例

状态码:200

{
  "total" : 1,
  "status_count" : {
    "deploying" : 0,
    "running" : 1,
    "stopping" : 0,
    "stopped" : 0,
    "starting" : 0,
    "fail" : 0,
    "deleting" : 0,
    "access_fail" : 0
  },
  "deployments" : [ {
    "id" : "deploy-001",
    "task_id" : "12345678901234567890123456789012",
    "product_id" : "prod-001",
    "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-service-456",
    "model_provider_id" : "provider-789",
    "model_service_id" : "model-svc-001",
    "model_service_name" : "test",
    "api_url" : "https://model-api.example.com/v1/chat/completions",
    "status" : "running",
    "created_at" : 1704067200000
  } ]
}

状态码

状态码

描述

200

模型部署列表。

400

无效的请求参数。

500

内部服务器错误。

错误码

请参见错误码。

相关文档