文档首页/ 魔坊（ModelArts）模型训推平台/ API参考/ 模型推理（新版）/ 服务部署生命周期管理/ 更新服务部署配置 - UpdateV2Deployment
更新时间：2026-07-03 GMT+08:00
在线调试
CLI示例
查看PDF
分享

更新服务部署配置 - UpdateV2Deployment

功能介绍

该接口适用于需要动态调整模型服务部署配置的场景

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    modelarts:service:updateDeployment

    Read

    service *

    -

    -

    -

URI

PUT /v2/{project_id}/services/{service_id}/deployments/{deployment_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

用户项目ID。获取方法请参见获取项目ID和名称。

约束限制：

不涉及。

取值范围：

账号的项目ID。

默认取值：

不涉及。

service_id

是

String

参数解释：

服务ID，在创建服务时即可在返回体中获取，也可通过查询服务列表获取当前用户拥有的服务，其中service_id字段即为服务ID。

约束限制：

不涉及。

取值范围：

服务ID。

默认取值：

不涉及。

deployment_id

是

String

参数解释：

部署ID，在创建部署时即可在返回体中获取，也可通过查询服务部署列表获取当前用户拥有的部署，其中deployment_id字段即为部署ID。

约束限制：

不涉及。

取值范围：

部署ID。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。通过调用IAM服务获取用户Token接口获取响应消息头中X-Subject-Token的值。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

Content-Type

是

String

参数解释：

消息体的类型（格式）

约束限制：

不涉及。

取值范围：

  • application/json

  • application/json;charset=utf-8

默认取值：

不涉及。
表3 请求Body参数

参数

是否必选

参数类型

描述

id

否

String

参数解释：

部署ID。

约束限制：

不填保留原有值。

取值范围：

不涉及。

默认取值：

不涉及。

name

是

String

参数解释：

部署名称。

约束限制：

必填参数，不填不保留原有值。

取值范围：

不涉及。

默认取值：

不涉及。

pool_id

否

String

参数解释：

资源池ID，查询指定资源池下的服务，默认不过滤。可通过查询资源池列表获取。

约束限制：

不填保留原有值。

取值范围：

不涉及。

默认取值：

不涉及。

framework

否

String

参数解释：

框架类型。

约束限制：

不填则为默认值。

取值范围：

  • COMMON：普通在线服务

  • VLLM：VLLM框架

  • MINDIE：MINDIE框架

默认取值：

COMMON

count

否

Integer

参数解释：

部署场景下，服务实例数量。

约束限制：

不填则为默认值。

取值范围：

[1, 128]。

默认取值：

1

deploy_type

否

String

参数解释：

部署类型。

约束限制：

不填保留原有值。

取值范围：

  • SINGLE：常规部署

  • MULTI：分布式部署

默认取值：

不涉及

system_log_dump_enable

否

Boolean

参数解释：

系统日志转储开关。

约束限制：

不填则为默认值。

取值范围：

不涉及

默认取值：

false

unit_configs

否

Array of UnitConfig objects

参数解释：

实例单元配置。

约束限制：

  • 单机推理时，个数只会为1；如果是分布式推理时，根据不同框架，实例单元配置可灵活配置。

  • 必填字段。

取值范围：

不涉及

默认取值：

不涉及

weight

是

Integer

参数解释：

权重百分比，分配到此模型的流量权重，仅当模型部署为在线服务时需要配置。

约束限制：

不填保留原有值。

取值范围：

[0, 100]。

默认取值：

不涉及

secret_type

否

String

参数解释：

凭证类型相关配置，用户可以在此处选择使用的凭证类型（dew，agency）

约束限制：

1.使用临时委托凭证类型约束限制:集群已安装CCE容器存储（Everest）v2.4.204及以上版本，且集群版本为v1.28及以上且确保局点已启用IAM5服务。

2.若插件版本不足或集群不支持临时委托凭证，则需通过DEW服务挂载。

3.不填保留原有值。

取值范围：

  • dew：DEW密钥。

  • agency：临时委托凭证。

默认取值：

不涉及。

priority

否

Integer

参数解释：

服务优先级。

约束限制：

  • 如服务处于“运行中”，priority字段为必要参数，且value必须为原版的值；

  • 如服务处于“停止”，priority字段为非必要参数。

  • 不填保留原有值。

取值范围：

[1, 3]。

默认取值：

不涉及。

high_avail_switch

否

Boolean

参数解释：

高可用开关，开启后不同实例的pod将尽量均匀分布到不同的节点上。

约束限制：

不填则为默认值

取值范围：

不涉及

默认取值：

true

description

否

String

参数解释：

部署备注。

约束限制：

不填则将部署描述清空。

取值范围：

长度不可以超过512，不能包含大于号，小于号。

默认取值：

默认为空。

advanced_config

是

AdvancedConfig object

参数解释：

高级配置，服务部署时的配置。

约束限制：

不填保留原有值。

取值范围：

不涉及

默认取值：

不涉及

model

否

GroupModel object

参数解释：

推理单元共用模型相关配置，用户可以在此处选择模型及权重文件配合镜像使用,此配置对所有推理单元生效。

约束限制：

不填保留原有值。

取值范围：

不涉及

默认取值：

不涉及

mirror_traffic_enable

否

Boolean

参数解释：

镜像流量开关。

约束限制：

不填保留原有值

取值范围：

不涉及

默认取值：

不涉及

mirror_traffic_weight

否

Integer

参数解释：

镜像流量权重。

约束限制：

不填保留原有值。

取值范围：

不涉及

默认取值：

不涉及

status

否

String

参数解释：

部署状态。

约束限制：

不填保留原有值。

取值范围：

  • DEPLOYING：部署中

  • FAILED：失败

  • STOPPED：停止

  • RUNNING：运行中

  • DELETING：删除中

  • STOPPING：停止中

  • CONCERNING：存在潜在问题

  • DELETED：删除

  • RESTARTING：重启中

  • UPGRADING：更新中

  • ERROR：错误

  • INTERRUPTING：中断中

默认取值：

不涉及

deployment_task_limit

否

DeploymentTaskLimit object

参数解释：

部署任务限制，异步服务相关配置。

约束限制：

不填保留原有值。

取值范围：

不涉及

默认取值：

不涉及

schedule_strategy

否

String

参数解释：

调度策略。

约束限制：

不涉及。

取值范围：

  • HIGH_AVAILABILITY：高可用调度

  • HIGH_UTILIZATION：紧凑调度

  • HIGH_PERFORMANCE：高性能调度

默认取值：

HIGH_AVAILABILITY。
表4 UnitConfig

参数

是否必选

参数类型

描述

id

否

String

参数解释：

实例单元ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

name

否

String

参数解释：

实例单元角色名称。

约束限制：

最大长度为16字符，且需满足正则：^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

默认取值：

不涉及。

role

否

String

参数解释：

实例单元角色。

约束限制：

不涉及。

取值范围：

mindIe场景下：

  • scheduler：表示调度单元。

  • manager：表示管理单元。

  • worker：表示工作单元。

  • prefill：表示全量单元。

  • decode：表示增量单元。

  • common：表示其他角色。

vllm场景下：

默认取值：

不涉及。

custom_spec

否

CustomSpec object

参数解释：

自定义资源规格配置。

约束限制：

不涉及。

flavor

否

String

参数解释：

资源规格，根据所提供版本选择适合业务的规格。当specification为custom为自定义规格。由custom_spec指定部署的规格配置。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

image

是

Image object

参数解释：

镜像配置信息，包含镜像地址，镜像来源。

约束限制：

不涉及。

models

否

Array of Model objects

参数解释：

废弃参数，推荐使用files替代使用

模型相关配置，用户可以在此处选择模型及权重文件配合镜像使用。

约束限制：

不涉及。

codes

否

Array of Code objects

参数解释：

废弃参数，推荐使用files替代使用

代码相关配置，用户可以在此处选择代码所在的obs路径等。

约束限制：

不涉及。

files

否

Array of File objects

参数解释：

模型和代码相关配置，用户可以在此处选择模型、权重文件以及代码所在的obs路径等配合镜像使用。

约束限制：

不涉及。

count

否

Integer

参数解释：

配置实例个数，单机推理无需配置。

约束限制：

不填保留原有值。

取值范围：

不涉及。

默认取值：

不涉及。

group_count

否

Integer

参数解释：

单元副本数，当部署类型deploy_type为SINGLE时，该参数无效。

约束限制：

不填不会保留原有值。

取值范围：

最小为1，最大为100。

默认取值：

默认值为1。

cmd

否

String

参数解释：

启动命令。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

envs

否

Map<String,String>

参数解释：

环境变量。

约束限制：

变量键长度不大于64，由字母、数字、下划线、中划线、点组成，不能以数字开头。值的输入内容不能存在HTML格式，如：<9>、<^>、<...>。

readiness_health

否

Health object

参数解释：

就绪健康检查。

约束限制：

不涉及。

startup_health

否

Health object

参数解释：

启动健康检查。

约束限制：

不涉及。

liveness_health

否

Health object

参数解释：

存活健康检查。

取值范围：

不涉及。

port

否

Integer

参数解释：

端口。

约束限制：

不涉及。

取值范围：

[1,65535]。

默认取值：

不涉及。

recovery

否

String

参数解释：

自动重建策略，开启后，由于部署配置变更或者故障等原因导致Pod重启时，平台将按策略自动执行重建。若不开启，平台将不会主动干预处理。

取值范围：

  • Instance：部署副本重建，故障时重新拉起整个部署。

  • Role：单元重建，当部署单元内的Pod出现故障时，重启该单元内的所有Pod。

  • Pod：Pod重建，故障时重新拉起故障pod。

默认取值：

不涉及。

npu_reset_enable

否

Boolean

参数解释：

是否开启恢复策略。

约束限制：

不涉及。

取值范围：

  • true：开启恢复策略。

  • false：不开启恢复策略。

默认取值：

不涉及。

affinity

否

Affinity object

参数解释：

节点亲和调度设置。

约束限制：

不涉及。

security_config

否

SecurityConfig object

参数解释：

设置容器用户ID、用户组ID。

dumps

否

Array of Dump objects

参数解释：

产物转储相关配置，用户可以在此处配置产物转储的目的和容器挂载路径。

约束限制：

不涉及。

group_policy

否

UnitGroupPolicy object

参数解释：

单副本资源实例调度约束配置。

约束限制：

不涉及。
表5 CustomSpec

参数

是否必选

参数类型

描述

gpu

否

Number

参数解释：

GPU个数。

约束限制：

不涉及。

取值范围：

支持配置小数，输入值不能小于0（最多支持2位小数，小数点后第3位做四舍五入处理）。

默认取值：

不涉及。

memory

否

Integer

参数解释：

内存，单位为MB。

约束限制：

不涉及。

取值范围：

仅支持整数。

默认取值：

不涉及。

cpu

否

Number

参数解释：

CPU核数。

约束限制：

不涉及。

取值范围：

支持配置小数，输入值不能小于0.01（最多支持2位小数，小数点后第3位做四舍五入处理）。

默认取值：

不涉及。

ascend

否

Integer

参数解释：

Ascend芯片个数。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表6 Image

参数

是否必选

参数类型

描述

id

否

String

参数解释：

镜像id。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

source

是

String

参数解释：

镜像类别，标识镜像来源。

约束限制：

不涉及。

取值范围：

  • swr：软件仓库服务。

  • image：[通用镜像]。

  • ai-gallery：[AI资源库]。

默认取值：

不涉及。

swr_path

是

String

参数解释：

镜像地址，source不同取值时，地址为不同值。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

category

否

String

参数解释：

镜像支持的规格。

约束限制：

不涉及。

取值范围：

  • GPU：图形处理器。

  • CPU：中央处理器。

  • ASCEND：昇腾芯片。

默认取值：

CPU。
表7 Model

参数

是否必选

参数类型

描述

source

是

String

参数解释：

代码来源类别。

约束限制：

不涉及。

取值范围：

如下参数不区分大小写

  • OBS：对象存储服务。

  • OBSFS：OBS的文件系统接口。

  • EFS：弹性文件服务。

  • LOCAL：挂载宿主机本地存储目录。

默认取值：

不涉及。

address

否

String

参数解释：

代码来源地址，格式遵循不同存储系统。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

mount_path

是

String

参数解释：

挂载到容器内的路径，要求以/开头，后面可包含中划线，反斜杠，下划线，点号，字母，数字。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

host_cache

否

Boolean

参数解释：

是否支持模型本地缓存，默认是不支持。

约束限制：

不涉及。

取值范围：

  • true：支持。

  • false：不支持。

默认取值：

false。

efs_sub_path

否

String

参数解释：

当存储类别为EFS时，支持配置子目录。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

read_only

否

Boolean

参数解释：

挂载权限设置，是否只读。

约束限制：

不涉及。

取值范围：

  • true：只读。

  • false：非只读。

默认取值：

不涉及。

os_warm_up

否

Boolean

参数解释：

os预热。

约束限制：

不涉及。

取值范围：

  • true：预热。

  • false：不预热。

默认取值：

不涉及。

source_name

否

String

参数解释：

预热名称。

约束限制：

os_warm_up为true时必填。

取值范围：

支持1-64位字符，可包含字母、中文、数字、中划线、下划线。

默认取值：

不涉及。
表8 Code

参数

是否必选

参数类型

描述

source

是

String

参数解释：

代码来源类别。

约束限制：

不涉及。

取值范围：

  • OBS：对象存储服务。

  • OBSFS：OBS的文件系统接口。

  • EFS：弹性文件服务。

默认取值：

不涉及。

address

否

String

参数解释：

代码来源地址，格式遵循不同存储系统。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

source_id

否

String

参数解释：

代码来源id，与address二选一，当且仅当source为EFS时，可以传入sfs turbo的id。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

mount_path

是

String

参数解释：

挂载到容器内的路径，要求以/开头，后面可包含中划线，反斜杠，下划线，点号，字母，数字。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

efs_sub_path

否

String

参数解释：

sfs 子路径。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

read_only

否

Boolean

参数解释：

是否只读。

约束限制：

不涉及。

取值范围：

  • true：只读。

  • false：非只读。

默认取值：

不涉及。
表9 File

参数

是否必选

参数类型

描述

source

是

String

参数解释：

代码来源类别。

约束限制：

不涉及。

取值范围：

如下参数不区分大小写

  • OBS：对象存储服务。

  • OBSFS：OBS的文件系统接口。

  • EFS：弹性文件服务。

  • LOCAL：挂载宿主机本地存储目录。

默认取值：

不涉及。

address

否

String

参数解释：

代码来源地址，格式遵循不同存储系统。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

mount_path

是

String

参数解释：

挂载到容器内的路径。

约束限制：

不涉及。

取值范围：

以(/)开头和结尾，可包含字母、数字、中划线、下划线，整个挂载路径长度不能超过255位。

默认取值：

不涉及。

host_cache

否

Boolean

参数解释：

是否支持模型本地缓存，默认是不支持。

约束限制：

不涉及。

取值范围：

  • true：支持。

  • false：不支持。

默认取值：

false。

efs_sub_path

否

String

参数解释：

当存储类别为EFS时，支持配置子目录。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

read_only

否

Boolean

参数解释：

挂载权限设置，是否只读。

约束限制：

不涉及。

取值范围：

  • true：只读。

  • false：非只读。

默认取值：

不涉及。

os_warm_up

否

Boolean

参数解释：

OS预热。

约束限制：

不涉及。

取值范围：

  • true：预热。

  • false：不预热。

默认取值：

不涉及。

source_name

否

String

参数解释：

预热名称。

约束限制：

os_warm_up为true时必填。

取值范围：

支持1-64位字符，可包含字母、中文、数字、中划线、下划线。

默认取值：

不涉及。
表10 Health

参数

是否必选

参数类型

描述

check_method

否

String

参数解释：

健康检查方式：HTTP 或者 EXEC（命令行）。

约束限制：

不涉及。

取值范围：

  • HTTP：超文本传输协议。

  • EXEC：命令行。

默认取值：

不涉及。

cmd

否

String

参数解释：

当健康检查方式为EXEC时必填，配置的命令行。

约束限制：

字符长度限制[0, 1024]，不能包含字符：#~^$|%&*<>()'"[]{}

取值范围：

不涉及。

默认取值：

不涉及。

url

否

String

参数解释：

当健康检查方式为HTTP 时必填，配置的请求地址。

约束限制：

字符长度限制[0, 1024]，首字符为/，后续字符可以是：字母 数字 中划线 下划线 / :

取值范围：

不涉及。

默认取值：

不涉及。

protocol

否

String

参数解释：

连接协议。默认HTTP。

约束限制：

不涉及。

取值范围：

  • HTTPS：超文本传输协议安全版。

  • HTTP：超文本传输协议。

  • WSS：网络通信协议安全版。

  • WS：网络通信协议。

  • TCP：传输控制协议。

  • NA：不使用任何协议。

默认取值：

不涉及。

initial_delay_seconds

否

Integer

参数解释：

执行首次探测时，应该等待的时间，默认30秒，最小1秒。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

timeout_seconds

否

Integer

参数解释：

执行探测的超时时间，默认30秒，最小1秒。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

period_seconds

否

Integer

参数解释：

执行健康检查的周期时间，执行探测的频率。默认是10秒，最小1秒。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

failure_threshold

否

Integer

参数解释：

探测成功后，最少连续探测失败多少次才被认定为失败。默认是3。最小值是1。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表11 Affinity

参数

是否必选

参数类型

描述

affinity_type

是

String

参数解释：

节点亲和类型。

约束限制：

不涉及。

取值范围：

  • AFFINITY：亲和。

  • ANTI_AFFINITY：反亲和。

默认取值：

不涉及。

required

是

Boolean

参数解释：

是否设置强亲和。

约束限制：

不涉及。

取值范围：

  • true：设置强亲和。

  • false：不设置强亲和。

默认取值：

不涉及。

selection_mode

是

String

参数解释：

选择节点方式。

约束限制：

不涉及。

取值范围：

IP

默认取值：

不涉及。

targets

是

Map<String,String>

参数解释：

通过上述方式选择的列表，长度不能超过20。

约束限制：

不涉及。
表12 SecurityConfig

参数

是否必选

参数类型

描述

user_id

否

String

参数解释：

设置容器用户ID。

group_id

否

String

参数解释：

设置容器用户组ID。
表13 Dump

参数

是否必选

参数类型

描述

source

是

String

参数解释：

产物转储目的类别。

约束限制：

不涉及。

取值范围：

如下参数不区分大小写

  • OBSFS：OBS并行文件系统。

默认取值：

不涉及。

mount_path

是

String

参数解释：

挂载到容器内的路径。

约束限制：

不涉及。

取值范围：

以(/)开头和结尾，可包含字母、数字、中划线、下划线，整个挂载路径长度不能超过255位。

默认取值：

不涉及。

address

是

String

参数解释：

产物转储目的地址，格式遵循OBSFS系统。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表14 UnitGroupPolicy

参数

是否必选

参数类型

描述

schedule_scope

否

String

参数解释：

调度范围。

取值范围：

  • HYPERNODE：超节点调度

  • SLICE：柜级调度
表15 AdvancedConfig

参数

是否必选

参数类型

描述

deploy_timeout_minutes

否

String

参数解释：

部署超时时间

upgrade_config

是

UpgradeConfig object

参数解释：

滚动升级配置

service_secret

否

ServiceSecret object

参数解释：

服务密钥

dynamic_routing_enable

否

Boolean

参数解释：

智能路由开关

strategy

否

String

参数解释：

智能路由策略

ems_enable

否

Boolean

参数解释：

EMS加速开关

metric_api_scheme

否

String

参数解释：

智能路由指标采集scheme

metric_api_port

否

String

参数解释：

智能路由指标采集端口

metric_api_path

否

String

参数解释：

智能路由指标采集地址

custom_metrics_path

否

String

参数解释：

自定义监控采集指标地址

port

是

Integer

参数解释：

容器端口

protocol

是

String

参数解释：

容器请求协议。当选择WSS与WS时，服务接口会升级为WebSocket。开启WebSocket时，不支持同时设置“服务流量限制”。

取值范围：

  • HTTP：HTTP协议。

  • HTTPS：HTTPS协议。

  • WSS：WebSocket Secure协议。

  • WS：WebSocket协议。

  • TCP：传输控制协议。

  • NA：不使用任何协议。
表16 UpgradeConfig

参数

是否必选

参数类型

描述

type

否

String

参数解释：

升级类型。

约束限制：

不涉及。

取值范围：

  • ROLLING：滚动升级，默认值。

  • REPLACE：替换升级。

默认取值：

不涉及。

rolling_update

否

RollingUpdate object

参数解释：

滚动更新配置。

约束限制：

不涉及。
表17 RollingUpdate

参数

是否必选

参数类型

描述

max_surge

否

String

参数解释：

滚动更新时最多可以启动多少个Pod。

约束限制：

百分数类型字符串。

取值范围：

1%-100%。

默认取值：

1%。

max_unavailable

否

String

参数解释：

滚动更新时最多可以删除多少个Pod。

约束限制：

百分数类型字符串。

取值范围：

1%-100%。

默认取值：

1%。
表18 ServiceSecret

参数

是否必选

参数类型

描述

secret_enable

否

Boolean

参数解释：

是否启用密钥。

约束限制：

不涉及。

取值范围：

  • true：启用密钥。

  • false：不启用密钥。

默认取值：

false。

secret_type

否

String

参数解释：

密钥类型。

约束限制：

不涉及。

取值范围：

  • custom：自定义密钥。

  • dew：DEW密钥。

默认取值：

不涉及。

secret_volumes

否

SecretVolume object

参数解释：

密钥挂载。

约束限制：

上限30个。

group_enable

否

Boolean

参数解释：

是否启用镜像的用户组。

约束限制：

不涉及。

取值范围：

  • true：启用镜像的用户组。

  • false：不启用镜像的用户组。

默认取值：

false。

group_id

否

Long

参数解释：

镜像的用户组id。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表19 SecretVolume

参数

是否必选

参数类型

描述

secret_name

否

String

参数解释：

密钥名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

secret_key

否

String

参数解释：

密钥key。

约束限制：

长度不大于63。

取值范围：

不涉及。

默认取值：

不涉及。

secret_value

否

String

参数解释：

密钥值。

约束限制：

长度不大于32768。

取值范围：

不涉及。

默认取值：

不涉及。

mount_path

是

String

参数解释：

挂载路径。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表20 GroupModel

参数

是否必选

参数类型

描述

source

是

String

参数解释：

代码来源类别。

约束限制：

不涉及。

取值范围：

如下参数不区分大小写

  • OBS：对象存储服务。

  • OBSFS：OBS的文件系统接口。

  • EFS：弹性文件服务。

  • LOCAL：挂载宿主机本地存储目录。

默认取值：

不涉及。

address

否

String

参数解释：

代码来源地址，格式遵循不同存储系统。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

mount_path

是

String

参数解释：

挂载到容器内的路径，要求以/开头，后面可包含中划线，反斜杠，下划线，点号，字母，数字。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

host_cache

否

Boolean

参数解释：

是否支持模型本地缓存，默认是不支持。

约束限制：

不涉及。

取值范围：

  • true：支持。

  • false：不支持。

默认取值：

false。

efs_sub_path

否

String

参数解释：

当存储类别为EFS时，支持配置子目录。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

read_only

否

Boolean

参数解释：

挂载权限设置，是否只读。

约束限制：

不涉及。

取值范围：

  • true：只读。

  • false：非只读。

默认取值：

不涉及。

os_warm_up

否

Boolean

参数解释：

os预热。

约束限制：

不涉及。

取值范围：

  • true：预热。

  • false：不预热。

默认取值：

不涉及。

source_name

否

String

参数解释：

预热名称。

约束限制：

os_warm_up为true时必填。

取值范围：

支持1-64位字符，可包含字母、中文、数字、中划线、下划线。

默认取值：

不涉及。

asset_id

否

String

参数解释：

预置资产id。

取值范围：

支持1-64位字符，可包含字母、中文、数字、中划线、下划线。
表21 DeploymentTaskLimit

参数

是否必选

参数类型

描述

max_concurrent_task

否

Integer

参数解释：

最大并发任务数

约束限制：

不填保留原有值。

取值范围：

[1, 100]。

默认取值：

不涉及

响应参数

状态码：200

表22 响应Body参数

参数

参数类型

描述

id

String

参数解释：

服务ID，在创建服务时即可在返回体中获取，也可通过查询服务列表获取当前用户拥有的服务，其中service_id字段即为服务ID。

取值范围：

不涉及。

name

String

参数解释：

服务名，用户在创建服务时自定义的名称。

取值范围：

支持1-128个字符，可以包含字母、汉字、数字、连字符和下划线。

dispatcher_group_id

String

参数解释：

服务绑定的dispatcher组ID。

取值范围：

不涉及。

workspace_id

String

参数解释：

工作空间ID。

取值范围：

  • 0：默认空间ID。

  • 由数字和小写字母组成的32位字符：其他空间ID，可参考工作空间创建。

type

String

参数解释：

推理服务类型。

取值范围：

  • REAL_TIME：在线服务。

deploy_type

String

参数解释：

部署方式。

取值范围：

  • SINGLE：单机单卡。

  • MULTI：多机多卡。

status

String

参数解释：

服务当前状态。

取值范围：

  • DEPLOYING：部署中 。

  • FAILED：失败 。

  • STOPPED：停止。

  • RUNNING：运行中。

  • DELETING：删除中 。

  • STOPPING：停止中 。

  • CONCERNING：告警 。

  • UPGRADING：升级中 。

  • ERROR：异常 。

  • INTERRUPTING：中断中。

failure_reason

String

参数解释：

在线服务失败原因。

取值范围：

不涉及。

version

String

参数解释：

当前服务版本信息。

predict_url

Array of PredictUrlResponse objects

参数解释：

在线服务访问地址。

tags

Array of TmsTagResponse objects

参数解释：

TMS对接标签类。

create_at

String

参数解释：

创建时间，根据创建时的当前时间自动生成。

取值范围：

毫秒级时间戳，13位数字，如1609459200000。

update_at

String

参数解释：

更新时间，根据更新时的当前时间自动生成。

取值范围：

毫秒级时间戳，13位数字，如1609459200000。

schedule

Array of ScheduleConfigResponse objects

参数解释：

定时停止配置。
表23 PredictUrlResponse

参数

参数类型

描述

type

String

参数解释：

访问方式。

取值范围：

  • CONSOLE：通过控制台界面访问。

  • PUBLIC：通过公网访问。

  • INTERNAL：通过内网访问。

urls

Array of strings

参数解释：

推理请求的访问地址，仅当type为real-time时，且服务部署完成后才会确保该字段有值。
表24 TmsTagResponse

参数

参数类型

描述

key

String

参数解释：

标签键字段。

取值范围：

长度为128，字母、数字、下划线、点、等号、加号、减号和@符号，且不能以空格或"sys"开头，不能以空格结尾。

value

String

参数解释：

标签值字段。

取值范围：

长度为255，包括字母、数字、下划线、点、斜杠、等号、加号、减号和@符号。
表25 ScheduleConfigResponse

参数

参数类型

描述

due_time

Long

参数解释：

触发时间，13位时间戳。

取值范围：

不涉及。

duration

Integer

参数解释：

对应的时间单位的数值。

取值范围：

不涉及。

time_unit

String

参数解释：

调度时间单位。

取值范围：

  • MINUTES：分钟。

  • HOURS：小时。

  • DAYS：天。

type

String

参数解释：

调度类型，当前仅支持取值为stop。

取值范围：

  • STOP：停止。

processed

Boolean

参数解释：

表示是否处理完成。

取值范围：

  • true：该定时任务已经执行过。

  • false：该定时任务尚未执行。

请求示例

修改服务配置。

PUT https://{endpoint}/v2/{project_id}/services/{service_id}/deployments/{deployment_id}

{
  "description" : null,
  "name" : "deployment-example",
  "weight" : 100,
  "pool_id" : "pool-example",
  "count" : 1,
  "advanced_config" : {
    "upgrade_config" : {
      "rolling_update" : {
        "max_surge" : "1%",
        "max_unavailable" : "1%"
      },
      "type" : "ROLLING"
    },
    "port" : 0,
    "protocol" : "HTTPS"
  }
}

响应示例

状态码：200

修改服务配置成功。

{
  "id" : "8a927efb-43f6-4a0b-8222-a1b87d2d2fa8",
  "name" : "deployment-example",
  "version" : "0.0.1",
  "status" : "DEPLOYING"
}

状态码

状态码

描述

200

修改服务配置成功。

错误码

请参见错误码。