# 创建模型部署 - CreateOpsModelDeployment #### 功能介绍 本接口用于将模型优化任务的模型产物发布为在线推理服务，需指定底层ModelArts资源（资源池、规格、实例数）与鉴权配置。 适用场景： - 在模型训练完成后，将选定的模型产物一键部署为在线服务，使其具备实时的对外推理能力。 - 根据业务并发需求，灵活配置专属或公共资源池及实例数量，实现高性能推理服务的快速上线。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-agentarts/agentarts_07_0003.html)。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-agentarts/Permission.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | agentarts:modelTuningTask:createOpsModelDeployment | Write | modelTuningTask \* | g:ResourceTag/\ | - | - | #### URI POST /v1/ops/model-deployments #### 请求参数 表1请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | product_id | 是 | String | **参数解释：** 模型优化任务产物ID，获取方法请参见[查询模型优化任务产物列表 - ListOpsModelTuningTaskProducts](https://support.huaweicloud.com/api-agentarts/ListOpsModelTuningTaskProducts.html)。 **约束限制：** 不涉及 **取值范围：** 真实存在的产物ID字符串，最小长度1，最大长度32。 **默认取值：** 无 | | ma_pool_type | 是 | String | **参数解释：** ModelArts资源池类型。 **约束限制：** 不涉及 **取值范围：** public（公共资源池）或 dedicated（专属资源池）等支持的类型字符串，最小长度1，最大长度32。 **默认取值：** 无 | | ma_pool_id | 否 | String | **参数解释：** ModelArts资源池ID。在AgentArts平台模型优化功能中，在部署并接入模型页面，按F12通过开发者工具可查看资源池的规格信息。 图1查看资源池规格 ![](https://support.huaweicloud.com/api-agentarts/zh-cn_image_0000002555672008.png "点击放大") **约束限制：** ma_pool_type为专属资源池时必填。 **取值范围：** 真实存在的资源池ID字符串，最小长度1，最大长度32。 **默认取值：** 无 | | ma_instance_flavor | 是 | String | **参数解释：** ModelArts实例规格。 AgentArts平台模型优化功能中，在部署并接入模型页面，按F12通过开发者工具可查看资源池的规格信息。 图2查看资源池规格 ![](https://support.huaweicloud.com/api-agentarts/zh-cn_image_0000002555831790.png "点击放大") **约束限制：** 不涉及 **取值范围：** ModelArts支持的计算实例规格字符串。 **默认取值：** 无 | | ma_instance_count | 是 | Integer | **参数解释：** ModelArts实例数，单位：个。 **约束限制：** 不涉及 **取值范围：** 1到20的正整数。 **默认取值：** 无 | | model_name | 是 | String | **参数解释：** 模型名称。 **约束限制：** 不涉及 **取值范围：** 部署模型的名称字符串，最小长度2，最大长度64。默认与模型优化任务训练完成后，产出的模型快照名称一致。 **默认取值：** 无 | | model_service_name | 是 | String | **参数解释：** 模型服务名称。 **约束限制：** 不涉及 **取值范围：** 可自定义，长度2-64个字符的字符串。 **默认取值：** 无 | | secret_name | 是 | String | **参数解释：** 认证凭据名称，在AgentArts平台模型优化功能中，部署并接入模型时所填写的认证凭据名称。 图3模型部署与接入 ![](https://support.huaweicloud.com/api-agentarts/zh-cn_image_0000002555104814.png "点击放大") **约束限制：** 不涉及 **取值范围：** 真实存在的凭据名称字符串，最小长度2，最大长度255。 **默认取值：** 无 | | agency_name | 是 | String | **参数解释：** 委托名称，赋予服务访问用户资源的权限，在AgentArts平台模型优化功能中，部署并接入模型时所填写的委托名称。 图4模型部署与接入 ![](https://support.huaweicloud.com/api-agentarts/zh-cn_image_0000002585825161.png "点击放大") **约束限制：** 不涉及 **取值范围：** 具有ModelArts部署权限的IAM委托名称。 **默认取值：** 无 | #### 响应参数 **状态码：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 | **参数解释：** 调优模型名称。 **取值范围：** 模型名称字符串。 | | 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：删除中，access_fail：接入失败。 | | created_at | Long | **参数解释：** 创建时间，单位：毫秒（13位时间戳）。 **取值范围：** 13位毫秒级时间戳，最小值0，最大值9223372036854775807。 | | fail_reason | String | **参数解释：** 部署错误信息。 **取值范围：** 无。 | 表3OpsTuningTargetAgent | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 | **参数解释：** 人类可读的错误消息。 **取值范围：** 详细错误说明字符串。 | **状态码：403** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：**机器可读的错误代码。 **取值范围：**系统错误码字符串。 | | error_msg | String | **参数解释：**人类可读的错误消息。 **取值范围：**详细错误说明字符串。 | | encoded_authorization_message | String | **参数解释：**编码后的授权失败信息。 **取值范围：**字符串。 | | details | Array of [OpsRLCommonError] objects | **参数解释：**依赖的下游服务错误信息列表。 **取值范围：**包含error_code和error_msg的对象数组。 | 表6OpsRLCommonError | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 机器可读的错误代码。 **取值范围：** 系统错误码字符串。 | | error_msg | String | **参数解释：** 人类可读的错误消息。 **取值范围：** 详细错误说明字符串。 | **状态码：404** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 机器可读的错误代码。 **取值范围：** 系统错误码字符串。 | | error_msg | String | **参数解释：** 人类可读的错误消息。 **取值范围：** 详细错误说明字符串。 | **状态码：500** 表8响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释：** 机器可读的错误代码。 **取值范围：** 系统错误码字符串。 | | error_msg | String | **参数解释：** 人类可读的错误消息。 **取值范围：** 详细错误说明字符串。 | #### 请求示例 用于将模型产物发布为在线推理服务。 ``` POST /v1/ops/model-deployments { "product_id": "prod-1234567890abcdef", "model_name": "qwen3_8b", "model_service_name": "my-math-reasoning-service", "ma_pool_type": "public", "ma_instance_flavor": "modelarts.vm.gpu.p4.2xlarge", "ma_instance_count": 2, "secret_name": "my-obs-secret", "agency_name": "rl-trust" } ``` #### 响应示例 **状态码：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" : "deploying", "created_at" : 1704240000000 } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 模型部署详情。 | | 400 | 无效的请求体。 | | 403 | 权限不足，拒绝访问。 | | 404 | 模型优化任务产物未找到。 | | 500 | 内部服务器错误。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-agentarts/ErrorCode.html)。