查询模型部署列表 - ListOpsModelDeployments
功能介绍
本接口用于分页查询当前租户下的模型优化任务模型部署列表,支持按任务ID、状态、名称等多维度过滤,并返回全局状态统计。
适用场景:
- 分页浏览所有已部署的模型服务,快速查看服务的运行状态与关联的优化任务。
- 根据部署状态(如运行中、失败)筛选服务,批量监控在线服务的健康情况,或排查部署失败的任务。
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| agentarts::listOpsModelDeployments | List | - | - | - | - |
URI
GET /v1/ops/model-deployments
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| 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
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total | Integer | 参数解释: 满足条件的部署记录总数,用于计算分页总页数。 取值范围: 大于等于0的整数。 |
| status_count | DeployTaskStatusCount object | 参数解释: 全局任务状态统计对象,包含各状态下的部署任务数量。 取值范围: 符合DeployTaskStatusCount定义的对象。 |
| deployments | Array of OpsModelDeploymentInfo objects | 参数解释: 部署任务列表。 取值范围: 符合OpsModelDeploymentInfo定义的对象数组。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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的整数。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 参数解释: 部署错误信息。 取值范围: 无。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 机器可读的错误代码。 取值范围: 系统错误码字符串。 |
| error_msg | String | 参数解释: 人类可读的错误消息。 取值范围: 详细错误说明字符串。 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| 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 | 内部服务器错误。 |
错误码
请参见错误码。