# 查询在线服务部署版本详情 - ShowInferDeploymentVersion #### 功能介绍 此接口用于获取指定服务部署版本的详细信息，适用于需要查看特定版本的详细配置和状态的场景，例如确认版本的功能、性能参数或发布历史。请求需包含有效的服务ID、部署ID及版本号。用户必须具有对目标服务部署的查看权限。请求成功后，返回该版本的详细信息，包括版本号、发布时间、配置参数和状态。若服务ID、部署ID无效、版本号不存在或用户无权限，则返回400 Bad Request或403 Forbidden；若服务部署无该版本信息，则返回404 Not Found。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ModelArts/doc?api=ShowInferDeploymentVersion)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-modelarts/modelarts_03_0138.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | modelarts:service:getDeploymentVersion | Read | service \* | - | - | - | #### URI GET /v2/{project_id}/services/{service_id}/deployments/{deployment_id}/versions/{version} 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 用户项目ID。获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-modelarts/modelarts_03_0147.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | service_id | 是 | String | **参数解释：** 服务ID，在创建服务时即可在返回体中获取，也可通过查询服务列表接口获取当前用户拥有的服务，其中service_id字段即为服务ID。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | | version | 是 | String | 版本 | | deployment_id | 是 | String | 部署id | #### 请求参数 表2请求Header参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | X-Auth-Token | 否 | String | **参数解释：** 用户Token。通过调用IAM服务获取用户Token接口获取响应消息头中X-Subject-Token的值。获取方法请参见[获取IAM用户Token（使用密码）](https://support.huaweicloud.com/api-modelarts/modelarts_03_0004.html)。 **约束限制：** 不涉及。 **取值范围：** 不涉及。 **默认取值：** 不涉及。 | #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 参数解释： 部署ID，在[添加部署](https://support.huaweicloud.com/api-modelarts/CreateInferDeployment.html#ZH-CN_TOPIC_0000002723741832)时即可在返回体中获取，也可通过[查询服务部署列表](https://support.huaweicloud.com/api-modelarts/ListInferDeployments.html#ZH-CN_TOPIC_0000002723901750)获取当前用户拥有的部署，其中deployment_id字段即为部署ID。 约束限制： 不涉及。 取值范围： 部署ID。 默认取值： 不涉及。 | | name | String | **参数解释：** 服务部署名字 | | infer_name | String | 参数解释： 部署id（废弃字段）。 取值范围： 不涉及。 | | create_at | String | **参数解释：** 创建时间，根据创建时的当前时间自动生成。 **取值范围：** 毫秒级时间戳，13位数字 | | description | String | 参数解释： 描述 取值范围： 不涉及。 | | pool_id | String | **参数解释：** 专属资源池ID。 **取值范围：** 不涉及。 | | framework | String | **参数解释：** 算法框架。 **取值范围：** - COMMON： 普通在线服务。 | | priority | String | **参数解释：** 服务优先级。 **取值范围：** \[1, 3\]。 | | secret_type | String | **参数解释：** 凭证类型相关配置，用户可以在此处选择使用的凭证类型（dew，agency） **取值范围：** - dew：DEW密钥。 - agency：临时委托凭证。 | | status | String | **参数解释：** 服务部署状态 | | count | Integer | **参数解释：** 服务实例数 | | high_avail_switch | String | **参数解释：** 高可用开关，开启后不同实例的pod将尽量均匀分布到不同的节点上。 **取值范围：** 不涉及 | | system_log_dump_enable | String | **参数解释：** 系统日志转储开关。 **取值范围：** 不涉及 | | unit_configs | Array of [UnitConfig] objects | **参数解释：** 实例单元配置。 | | update_at | String | **参数解释：** 更新时间，根据更新时的当前时间自动生成。 **取值范围：** 毫秒级时间戳，13位数字。 | | version | String | **参数解释：** 当前服务版本信息。 | | version_count | Integer | **参数解释：** 服务版本数量。 **取值范围：** 不涉及。 | | weight | Integer | **参数解释：** 权重百分比，分配到此模型的流量权重，仅当模型部署为在线服务时需要配置。 **取值范围：** \[0, 100\]。 | | advanced_config | [AdvancedConfig] object | **参数解释：** 高级配置，服务部署时的配置。 | | job_id | String | **参数解释：** 巫山工作流ID。 **取值范围：** 不涉及。 | | deployment_name | String | 参数解释： 服务部署名字。 | | frozen_infos | Array of [FrozenInfo] objects | **参数解释：** 当服务或者部署被冻结时返回的冻结类型信息。 | 表4UnitConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 实例单元ID。 **取值范围：** 不涉及。 | | name | String | **参数解释：** 实例单元角色名称。 | | role | String | **参数解释：** 实例单元角色。 **取值范围：** - COMMON：表示其他角色。 | | custom_spec | [CustomResourceSpec] object | **参数解释：** 自定义资源规格配置。 **参数示例：** "custom_spec": { "arch": "x86", "cpu": 0.51, "memory": 1024.0 }, | | flavor | String | **参数解释：** 资源规格，根据所提供版本选择适合业务的规格。当specification为custom为自定义规格。由custom_spec指定部署的规格配置。 **取值范围：** 不涉及。 | | flavor_display_name | String | **参数解释：** 资源规格的显示名称。 **取值范围：** 不涉及。 | | image | [ImageInfo] object | **参数解释：** 镜像配置信息，包含镜像地址，镜像来源。 | | models | Array of [ModelResource] objects | **参数解释：** 废弃参数，推荐使用files进行模型相关配置。 模型相关配置，用户可以在此处选择模型及权重文件配合镜像使用。 | | codes | Array of [Code] objects | **参数解释：** 废弃参数，推荐使用files进行代码相关配置。 代码相关配置，用户可以在此处选择代码所在的obs路径等。 | | files | Array of [FileInfo] objects | **参数解释：** 模型和代码相关配置，用户可以在此处选择模型及权重文件配合镜像使用以及代码所在的obs路径等。 | | dumps | Array of [Dump] objects | **参数解释：** 用户转储配置，用户可以在此处选择要转储的目的obs。 | | count | Integer | **参数解释：** 配置实例个数。 **取值范围：** 不涉及。 | | cmd | String | **参数解释：** 启动命令。 **取值范围：** 不涉及。 | | termination_grace | [TerminationGrace] object | **参数解释：** 优雅终止配置。 | | envs | Map\ | **参数解释：** 环境变量。 | | 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：不开启恢复策略。 | | group_count | Integer | **参数解释：** 单元副本数，当部署类型deploy_type为SINGLE或工作负载类型workload_type为DEPLOYMENT时，该参数无效。 **取值范围：** \[1, 100\] 或者为空。 | | affinity | [Affinity] object | **参数解释：** 节点亲和调度设置。 | | security_config | [ServiceSecurityConfig] object | **参数解释：** 容器用户ID/用户组ID配置。 | | pool_resource_flavor | String | **参数解释：** 节点池资源规格。 **取值范围：** 长度不超过128字符。 | 表5CustomResourceSpec | 参数 | 参数类型 | 描述 | |:---|:---|:---| | gpu | Float | **参数解释：** GPU个数。 **取值范围：** 支持配置小数，输入值不能小于0（最多支持2位小数，小数点后第3位做四舍五入处理）。 | | memory | Integer | **参数解释：** 内存，单位为MB。 **取值范围：** 仅支持整数。 | | cpu | Float | **参数解释：** CPU核数。 **取值范围：** 支持配置小数，输入值不能小于0.01（最多支持2位小数，小数点后第3位做四舍五入处理）。 | | ascend | Integer | **参数解释：** Ascend芯片个数。 **取值范围：** 不涉及。 | | arch | String | **参数解释：** 架构类型。 **取值范围：** 枚举值：x86 \| arm64。 | 表6ImageInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | **参数解释：** 镜像ID。 **取值范围：** 不涉及。 | | source | String | **参数解释：** 镜像类别，标识镜像来源。 **取值范围：** - SWR：软件仓库服务。 - IMAGE：\[通用镜像\]。 | | swr_path | String | **参数解释：** 镜像地址，source不同取值时，地址为不同值。 **取值范围：** 不涉及。 | | category | String | **参数解释：** 镜像支持的规格。 **取值范围：** - GPU：图形处理器。 - CPU：中央处理器。 - ASCEND：昇腾芯片。 | 表7ModelResource | 参数 | 参数类型 | 描述 | |:---|:---|:---| | source | String | **参数解释：** 代码来源类别。 **取值范围：** 如下参数不区分大小写 - OBS：对象存储服务。 - OBSFS：OBS的文件系统接口。 - EFS：弹性文件服务。 - LOCAL：挂载宿主机本地存储目录。 | | address | String | **参数解释：** 代码来源地址，格式遵循不同存储系统。 **取值范围：** 不涉及。 | | mount_path | String | **参数解释：** 挂载到容器内的路径，要求以/开头，后面可包含中划线、反斜杠、下划线、点号、字母、数字。 **取值范围：** 以(/)开头和结尾，可包含字母、数字、中划线、下划线，整个挂载路径长度不能超过255位。 | | host_cache | Boolean | **参数解释：** 是否支持模型本地缓存，默认是不支持。 **取值范围：** - true：支持。 - false：不支持。 | | efs_sub_path | String | **参数解释：** 当存储类别为EFS时，支持配置子目录。 **取值范围：** 不涉及。 | | read_only | Boolean | **参数解释：** 挂载权限设置，是否只读。 **取值范围：** - true：只读。 - false：非只读。 | | os_warm_up | Boolean | **参数解释：** OS预热。 **取值范围：** - true：预热。 - false：不预热。 | | source_name | String | **参数解释：** 预热名称。 **取值范围：** 支持1-64位字符，可包含字母、中文、数字、中划线、下划线。 | | asset_id | String | **参数解释：** 预置资产id。 **取值范围：** 支持1-64位字符，可包含字母、中文、数字、中划线、下划线。 | 表8Code | 参数 | 参数类型 | 描述 | |:---|:---|:---| | source | String | **参数解释：** 代码来源类别。 **取值范围：** - OBS：对象存储服务。 - OBSFS：OBS的文件系统接口。 - EFS：弹性文件服务。 | | address | String | **参数解释：** 代码来源地址，格式遵循不同存储系统。 **取值范围：** 不涉及。 | | source_id | String | **参数解释：** 代码来源ID，与address二选一，当且仅当source为EFS时，可以传入sfs turbo的ID。 **取值范围：** 不涉及。 | | mount_path | String | **参数解释：** 挂载到容器内的路径。 **取值范围：** 以(/)开头和结尾，可包含字母、数字、中划线、下划线，整个挂载路径长度不能超过255位。 | | efs_sub_path | String | **参数解释：** EFS子路径。 **取值范围：** 不涉及。 | | read_only | Boolean | **参数解释：** 挂载权限设置, 是否只读。 **取值范围：** - true：只读。 - false：非只读。 | 表9FileInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | source | String | **参数解释：** 代码来源类别。 **取值范围：** 如下参数不区分大小写 - OBS：对象存储服务。 - OBSFS：OBS的文件系统接口。 - EFS：弹性文件服务。 - LOCAL：挂载宿主机本地存储目录。 | | address | String | **参数解释：** 代码来源地址，格式遵循不同存储系统。 **取值范围：** 不涉及。 | | mount_path | String | **参数解释：** 挂载到容器内的路径。 **取值范围：** 以(/)开头和结尾，可包含字母、数字、中划线、下划线，整个挂载路径长度不能超过255位。 | | host_cache | Boolean | **参数解释：** 是否支持模型本地缓存，默认是不支持。 **取值范围：** - true：支持。 - false：不支持。 | | efs_sub_path | String | **参数解释：** 当存储类别为EFS时，支持配置子目录。 **取值范围：** 不涉及。 | | read_only | Boolean | **参数解释：** 挂载权限设置，是否只读。 **取值范围：** - true：只读。 - false：非只读。 | | os_warm_up | Boolean | **参数解释：** OS预热。 **取值范围：** - true：预热。 - false：不预热。 | | source_name | String | **参数解释：** 预热名称。 **取值范围：** 支持1-64位字符，可包含字母、中文、数字、中划线、下划线。 | 表10Dump | 参数 | 参数类型 | 描述 | |:---|:---|:---| | source | String | **参数解释：** 转储挂载目录来源类别。 **取值范围：** - OBS：对象存储服务。 - OBSFS：OBS的文件系统接口。 | | address | String | **参数解释：** 转储挂载目录来源地址，支持https或obs协议的obs地址。 **取值范围：** 不涉及。 | | mount_path | String | **参数解释：** 挂载到容器内的路径，要求以/开头，后面可包含中划线，反斜杠，下划线，点号，字母，数字。 **取值范围：** 不涉及。 | 表11TerminationGrace | 参数 | 参数类型 | 描述 | |:---|:---|:---| | pre_stop_cmd | String | **参数解释：** 停机命令在容器收到停止信号时触发，但必须在停机时间的宽限期内完成，否则容器会被强制停止。您可以通过该命令精细化操作，如关闭数据库连接、释放文件句柄、停止子进程等。 **取值范围：** - 协议范围：http/https。 - 端口范围：1-65535。 - 地址范围：仅包含字母、数字、点号（.）、中划线（-)、下划线（_）、斜杠（/）的路径，非斜杠（/）开头。 | | termination_grace_period_seconds | Integer | **参数解释：** 该参数表示 Pod 收到停止信号到强制停止的最大时间窗口，用于 Pod 执行清理操作（如关闭连接、释放资源、保存状态等）。 **取值范围：** - 协议范围：http/https。 - 端口范围：1-65535。 - 地址范围：仅包含字母、数字、点号（.）、中划线（-)、下划线（_）、斜杠（/）的路径，非斜杠（/）开头。 | 表12Health | 参数 | 参数类型 | 描述 | |:---|:---|:---| | check_method | String | **参数解释：** 健康检查方式：HTTP 或者 EXEC（命令行）。 **取值范围：** - HTTP：超文本传输协议。 - EXEC：命令行。 | | cmd | String | **参数解释：** 当健康检查方式为EXEC时必填，配置的命令行。 **取值范围：** 不涉及。 | | url | String | **参数解释：** 当健康检查方式为HTTP 时必填，配置的请求地址。 **取值范围：** 不涉及。 | | protocol | String | **参数解释：** 连接协议。默认HTTP。 **取值范围：** - HTTPS：超文本传输协议安全版。 - HTTP：超文本传输协议。 - WSS：网络通信协议安全版。 - WS：网络通信协议。 | | initial_delay_seconds | Integer | **参数解释：** 执行首次探测时，应该等待的时间，默认30秒，最小1秒。 **取值范围：** 不涉及。 | | timeout_seconds | Integer | **参数解释：** 执行探测的超时时间，默认30秒，最小1秒。 **取值范围：** 最小值为1秒。 | | period_seconds | Integer | **参数解释：** 执行健康检查的周期时间，执行探测的频率。默认是10秒，最小1秒。 **取值范围：** 最小值为1秒。 | | failure_threshold | Integer | **参数解释：** 探测成功后，至少连续探测失败多少次才被认定为失败。默认是3。最小值是1。 **取值范围：** 最小值为1。 | 表13Affinity | 参数 | 参数类型 | 描述 | |:---|:---|:---| | affinity_type | String | **参数解释：** 节点亲和类型。 **取值范围：** - AFFINITY：亲和。 - ANTI_AFFINITY：反亲和。 | | required | Boolean | **参数解释：** 是否设置强亲和。 **取值范围：** - true：设置强亲和。 - false：不设置强亲和。 | | selection_mode | String | **参数解释：** 选择节点方式。 **取值范围：** IP | | targets | Map\ | **参数解释：** 通过上述方式选择的列表，长度不能超过20。 | 表14ServiceSecurityConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | user_id | Long | **参数解释：** 启动业务容器时设置的user_id，默认可为空。 **取值范围：** \[1, 60000\]。 | | group_id | Long | **参数解释：** 启动业务容器时设置的group_id，默认可为空。 **取值范围：** \[1, 60000\]。 | 表15AdvancedConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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：不使用任何协议。 | 表16UpgradeConfig | 参数 | 参数类型 | 描述 | |:---|:---|:---| | type | String | **参数解释：** 升级类型。 **取值范围：** - ROLLING：滚动升级，默认值。 | | rolling_update | [RollingUpdate] object | **参数解释：** 滚动更新配置。 | 表17RollingUpdate | 参数 | 参数类型 | 描述 | |:---|:---|:---| | max_surge | String | **参数解释：** 滚动更新时最多可以启动多少个Pod。 **取值范围：** 1%-100%。 | | max_unavailable | String | **参数解释：** 滚动更新时最多可以删除多少个Pod。 **取值范围：** 1%-100%。 | 表18ServiceSecret | 参数 | 参数类型 | 描述 | |:---|:---|:---| | secret_enable | Boolean | **参数解释：** 是否启用密钥。 **取值范围：** - true：启用密钥。 - false：不启用密钥。 | | secret_type | String | **参数解释：** 密钥类型。 **取值范围：** - custom：自定义密钥。 - dew：DEW密钥。 | | secret_volumes | Array of [SecretVolume] objects | **参数解释：** 密钥挂载。 | | group_enable | Boolean | **参数解释：** 是否启用镜像的用户组。 **取值范围：** - true：启用镜像的用户组。 - false：不启用镜像的用户组。 | | group_id | Long | **参数解释：** 镜像的用户组ID。 **取值范围：** 1000\~4294967294。 | 表19SecretVolume | 参数 | 参数类型 | 描述 | |:---|:---|:---| | secret_name | String | **参数解释：** 密钥名称。 **取值范围：** 不涉及。 | | secret_key | String | **参数解释：** 密钥key。 **取值范围：** 不涉及。 | | secret_value | String | **参数解释：** 密钥值。 **取值范围：** 不涉及。 | | mount_path | String | **参数解释：** 挂载路径。 **取值范围：** 以(/)开头和结尾，可包含字母、数字、中划线、下划线，整个挂载路径长度不能超过255位。 | 表20FrozenInfo | 参数 | 参数类型 | 描述 | |:---|:---|:---| | scene | String | 冻结场景。可选值如下： - ARREAR：欠费冻结 - POLICE：公安冻结 - ILLEGAL：违规冻结 | | effect | Integer | 冻结后的影响。可选值如下： - 1：冻结后可释放 - 2：冻结后不可释放 | #### 请求示例 查询特定部署的特定版本信息。 ``` GET https://{end_point}/v2/{project_id}/services/{service_id}/deployments/{deployment_id}/versions/{version} ``` #### 响应示例 **状态码：200** ``` { "advanced_config" : { "deploy_timeout_minutes" : 60, "dynamic_routing_enable" : false, "ems_enable" : false, "port" : 9876, "protocol" : "HTTPS", "service_secret" : { "group_enable" : false, "secret_enable" : false }, "upgrade_config" : { "rolling_update" : { "max_surge" : "25%", "max_unavailable" : "25%" }, "type" : "ROLLING" } }, "count" : 1, "create_at" : "2025-12-01 16:37:24", "description" : "", "framework" : "COMMON", "high_avail_switch" : true, "id" : "a07f5c03-547c-40cc-814b-312284779ebf", "infer_name" : "a07f5c03-547c-40cc-814b-312284779ebf", "job_id" : "db:infer-deployment-onlineUpdateDeploymentJob:5fc855f7-4f75-4961-9efc-6cfa52680471", "name" : "deploy-f066", "pool_id" : "pool-id***example", "priority" : 1, "secret_type" : "dew", "status" : "UPGRADING", "system_log_dump_enable" : false, "unit_configs" : [ { "cmd" : "", "codes" : [ ], "count" : 1, "custom_spec" : { "cpu" : 0.1, "memory" : 40 }, "id" : "2c9080da9ad9e11e019ada05d2cb0068", "image" : { "category" : "CPU", "id" : "a8e0bca47a25356abe87f426b8ef890db205163ff126475c7eb011d2e5643198", "source" : "SWR", "swr_path" : "swr.cn-north-7.myhuaweicloud.com/example/helloworld-example:0.0.1" }, "models" : [ ], "npu_reset_enable" : false, "recovery" : "Instance", "role" : "COMMON" } ], "update_at" : "2025-12-01 16:37:24", "version" : "1.0.1", "version_count" : 2, "weight" : 100 } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | 该部署某版本详情信息。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-modelarts/modelarts_03_0095.html)。