Obtaining the Deployment Version Details of a Real-Time Service

Function

This API is used to obtain details about a specified service deployment version. It is applicable to scenarios where you need to view the detailed configuration and status of a specified version, for example, confirming the functions, performance parameters, or release history of the version. The request must contain a valid service ID, deployment ID, and version number. You must have the permission to view the target service deployment. After the request is successful, the detailed information about the version is returned, including the version number, release time, configuration parameters, and status. If the service ID and deployment ID are invalid, the version number does not exist, or you do not have the permission, "400 Bad Request" or "403 Forbidden" is returned. If the service deployment does not have the version information, "404 Not Found" is returned.

Debugging

You can debug this API through automatic authentication in API Explorer or use the SDK sample code generated by API Explorer.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, the following identity policy-based permissions are required.

Action

Access Level

Resource Type (*: required)

Condition Key

Alias

Dependencies

modelarts:service:getDeploymentVersion

Read

service *

-

-

-

Action	Access Level	Resource Type (*: required)	Condition Key	Alias	Dependencies
modelarts:service:getDeploymentVersion	Read	service *	-	-	-

URI

GET /v2/{project_id}/services/{service_id}/deployments/{deployment_id}/versions/{version}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition Project ID. For details, see Obtaining a Project ID. Constraints N/A Range N/A Default Value N/A
service_id	Yes	String	Definition Service ID, which can be obtained from the response body during service creation or by querying the services owned by the current user. The service_id field is the service ID. Constraints N/A Range N/A Default Value N/A
version	Yes	String	Version
deployment_id	Yes	String	Deployment ID.

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	No	String	Definition User token. It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is the user token. For details about how to obtain the token, see Obtaining a User Token Through Password Authentication. Constraints N/A Range N/A Default Value N/A

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
id	String	Definition Deployment ID, which you can obtain from the response body when adding the deployment or by obtaining service deployments. The deployment_id field indicates the deployment ID. Constraints N/A Range Deployment ID. Default Value N/A
name	String	Definition Service deployment name.
infer_name	String	Definition Deployment ID (deprecated field). Range N/A
create_at	String	Definition Creation time, which is automatically generated. Range Millisecond-level timestamp, which is a 13-digit number.
description	String	Definition Description. Range N/A
pool_id	String	Definition Dedicated resource pool ID. Range N/A
framework	String	Definition Algorithm framework. Range COMMON: common real-time service.
priority	String	Definition Service priority. Constraints N/A Range [1, 3] Default Value N/A
secret_type	String	Definition Secret type. You can select the secret type (dew or agency) to be used here. Constraints N/A Range [dew: DEW secret.] (tag:hws,hws_hk,fcs) agency: temporary agency credential. Default Value N/A
status	String	Definition Service deployment status
count	Integer	Definition Number of service instances.
high_avail_switch	String	Definition Specifies whether to enable HA. Once enabled, pods of different instances are evenly distributed to different nodes. Constraints N/A Range N/A Default Value true
system_log_dump_enable	String	Definition Specifies whether to enable system log dump. Constraints This parameter is only available for NPU resource pools. Range N/A Default Value false
unit_configs	Array of UnitConfig objects	Definition Instance unit configuration. Constraints For single-node inference, the number of instance units is 1. For distributed inference, the number of instances can be configured based on the framework.
update_at	String	Definition Update time, which is automatically generated. Range Millisecond-level timestamp, which is a 13-digit number.
version	String	Definition Current service version.
version_count	Integer	Definition Number of service versions. Range N/A
weight	Integer	Definition Weight percentage of the traffic allocated to the model. This parameter is mandatory only when the model is deployed as a real-time service. Constraints N/A Range [0,100] Default Value N/A
advanced_config	AdvancedConfig object	Definition Advanced service deployment settings.
job_id	String	Definition Wushan workflow ID. Range N/A
deployment_name	String	Definition Service deployment name.
frozen_infos	Array of FrozenInfo objects	Definition Freezing type returned when a service or deployment is frozen.

**Table 4** UnitConfig
Parameter	Type	Description
id	String	Definition Instance unit ID. Constraints N/A Range N/A Default Value N/A
name	String	Definition Role name of the instance unit. Constraints The value can contain a maximum of 16 characters and must meet the regular expression ^[a-z0-9]([-a-z0-9][a-z0-9])?$. Default Value* N/A
role	String	Definition Instance unit role. Constraints N/A Range COMMON: other roles Default Value N/A
custom_spec	CustomResourceSpec object	Definition Custom resource specifications. Constraints N/A Example "custom_spec": { "arch": "x86", "cpu": 0.51, "memory": 1024.0 },
flavor	String	Definition Resource specifications. Select specifications based on service requirements. When specification is set to custom, the custom specifications are used. custom_spec specifies deployment specifications. Constraints N/A Range N/A Default Value N/A
flavor_display_name	String	Definition Display name of a resource specification. Constraints N/A Range N/A Default Value N/A
image	ImageInfo object	Definition Image configuration information, including the image path and image source. Constraints N/A
models	Array of ModelResource objects	Definition This parameter is discarded. You are advised to use files to configure models. Model configuration. You can select a model and weight file to use with the image. Constraints N/A
codes	Array of Code objects	Definition This parameter is discarded. You are advised to use files to configure code. Code configuration. You can select the OBS path where the code is stored. Constraints N/A
files	Array of FileInfo objects	Definition Model and code configuration. You can select the model and weight file to work with the image and the OBS path where the code is stored. Constraints N/A
dumps	Array of Dump objects	Definition Dump configuration. You can select the OBS bucket where the data is to be dumped. Constraints A maximum of 20 groups can be configured.
count	Integer	Definition Number of configuration instances. Constraints N/A Range N/A Default Value N/A
cmd	String	Definition Startup command. Constraints N/A Range N/A Default Value N/A
termination_grace	TerminationGrace object	Definition Graceful shutdown configuration. Constraints N/A
envs	Map<String,String>	Definition Environment variable. Constraints The length of a variable key cannot exceed 64 characters. The key can only contain letters, digits, underscores (_), hyphens (-), and periods (.), and cannot start with a digit. The value cannot contain HTML tags, including <^>.
readiness_health	Health object	Definition Readiness health check. Constraints N/A
startup_health	Health object	Definition Health checks are enabled. Constraints N/A
liveness_health	Health object	Definition Liveness health check. Range N/A
port	Integer	Definition Port. Constraints N/A Range [1, 65535] Default Value N/A
recovery	String	Definition Auto-rebuild policy. When enabled, the platform will automatically rebuild pods according to the policy if they restart due to deployment configuration changes or hardware failures. If disabled, the platform will not intervene. Constraints N/A Range Instance: Deployment replica rebuilding. Restarts the entire deployment when a fault occurs. Role: Unit rebuilding. Restarts all pods within a deployment unit if any pod in that unit fails. Pod: Pod rebuilding. Restarts the faulty pod if it fails. Default Value N/A
npu_reset_enable	Boolean	Definition Specifies whether to enable the recovery policy. Constraints N/A Range true: The recovery policy is enabled. false: The recovery policy is disabled. Default Value N/A
group_count	Integer	Definition Number of replicas in a unit. This parameter is invalid when deploy_type is set to SINGLE or workload_type is set to DEPLOYMENT. Constraints N/A Range [1, 100] or left empty. Default Value 1
affinity	Affinity object	Definition Node affinity scheduling. Constraints N/A
security_config	ServiceSecurityConfig object	Definition Container user ID/user group ID. Constraints N/A
pool_resource_flavor	String	Definition Node pool resource specifications. Constraints The value can contain only letters, digits, periods (.), hyphens (-), and underscores (_). Range The value can contain a maximum of 128 characters. Default Value N/A

**Table 5** CustomResourceSpec
Parameter	Type	Description
gpu	Float	Definition Number of GPUs. Constraints N/A Range The value can be a decimal. It cannot be smaller than 0, with the third decimal place is rounded off. Default Value N/A
memory	Integer	Definition Memory size, in MB. Constraints N/A Range Only integers are supported. Default Value N/A
cpu	Float	Definition CPU cores. Constraints N/A Range The value can be a decimal. It cannot be smaller than 0.01, with the third decimal place is rounded off. Default Value N/A
ascend	Integer	Definition Number of Ascend chips. Constraints N/A Range N/A Default Value N/A
arch	String	Definition Architecture type. Constraints N/A Range x86/arm64. Default Value N/A

**Table 6** ImageInfo
Parameter	Type	Description
id	String	Definition Image ID. Constraints N/A Range N/A Default Value N/A
source	String	Definition Image type, which indicates the image source. Constraints N/A Range SWR: SoftWare Repository for Container (SWR) [IMAGE: [general image].] Default Value N/A
swr_path	String	Definition Image path. The address is different when the source value is different. Constraints N/A Range N/A Default Value N/A
category	String	Definition Flavors supported by the image. Constraints N/A Range GPU: graphics processing unit. CPU: central processing unit. ASCEND: Ascend chip. Default Value CPU

**Table 7** ModelResource
Parameter	Type	Description
source	String	Definition Code source type. Constraints N/A Range The value is case-insensitive. OBS: Object Storage Service OBSFS: OBS file system API EFS: Scalable File Service LOCAL: local storage directory to which the host machine is mounted. Default Value N/A
address	String	Definition Code source address, which complies with the format of different storage systems. Constraints N/A Range N/A Default Value N/A
mount_path	String	Definition Path mounted to the container. The value must start with a slash (/) and can contain hyphens (-), backslashes (), underscores (), periods (.), letters, and digits. Constraints N/A Range The value must start and end with a slash (/) and can contain at most 255 characters. Only letters, digits, hyphens (-), and underscores () are allowed. Default Value N/A
host_cache	Boolean	Definition Specifies whether the model can be cached locally. This function is disabled by default. Constraints N/A Range true: supported. false: not supported. Default Value false
efs_sub_path	String	Definition When the storage type is EFS, subdirectories can be configured. Constraints N/A Range N/A Default Value N/A
read_only	Boolean	Definition Specifies whether the mount permission is read-only. Constraints N/A Range true: read only false: non-read-only Default Value N/A
os_warm_up	Boolean	Definition OS warmup. Constraints N/A Range true: Warmup enabled. false: Warmup disabled. Default Value N/A
source_name	String	Definition Warmup name. Constraints This parameter is mandatory when os_warm_up is set to true. Range The value can contain at most 64 characters. Only letters, digits, hyphens (-), and underscores (_) are allowed. Default Value N/A
asset_id	String	Definition Preset asset ID. Constraints This parameter is mandatory when preset assets are used. Range The value can contain at most 64 characters. Only letters, digits, hyphens (-), and underscores (_) are allowed. Default Value N/A

**Table 8** Code
Parameter	Type	Description
source	String	Definition Code source type. Constraints N/A Range OBS: Object Storage Service OBSFS: OBS file system API EFS: Scalable File Service Default Value N/A
address	String	Definition Code source address, which complies with the format of different storage systems. Constraints N/A Range N/A Default Value N/A
source_id	String	Definition Code source ID. Either this parameter or address must be specified. The SFS Turbo ID can be input only when source is set to EFS. Constraints N/A Range N/A Default Value N/A
mount_path	String	Definition Path mounted to the container. Constraints N/A Range The value must start and end with a slash (/) and can contain at most 255 characters. Only letters, digits, hyphens (-), and underscores (_) are allowed. Default Value N/A
efs_sub_path	String	Definition EFS subpath. Constraints N/A Range N/A Default Value N/A
read_only	Boolean	Definition Specifies whether the mount permission is read-only. Constraints N/A Range true: read only false: non-read-only Default Value N/A

**Table 9** FileInfo
Parameter	Type	Description
source	String	Definition Code source type. Constraints N/A Range The value is case-insensitive. OBS: Object Storage Service OBSFS: OBS file system API EFS: Scalable File Service LOCAL: local storage directory to which the host machine is mounted. Default Value N/A
address	String	Definition Code source address, which complies with the format of different storage systems. Constraints N/A Range N/A Default Value N/A
mount_path	String	Definition Path mounted to the container. Constraints N/A Range The value must start and end with a slash (/) and can contain at most 255 characters. Only letters, digits, hyphens (-), and underscores (_) are allowed. Default Value N/A
host_cache	Boolean	Definition Specifies whether the model can be cached locally. This function is disabled by default. Constraints N/A Range true: supported. false: not supported. Default Value false
efs_sub_path	String	Definition When the storage type is EFS, subdirectories can be configured. Constraints N/A Range N/A Default Value N/A
read_only	Boolean	Definition Specifies whether the mount permission is read-only. Constraints N/A Range true: read only false: non-read-only Default Value N/A
os_warm_up	Boolean	Definition OS warmup. Constraints N/A Range true: Warmup enabled. false: Warmup disabled. Default Value N/A
source_name	String	Definition Warmup name. Constraints This parameter is mandatory when os_warm_up is set to true. Range The value can contain at most 64 characters. Only letters, digits, hyphens (-), and underscores (_) are allowed. Default Value N/A

**Table 10** Dump
Parameter	Type	Description
source	String	Definition Source type of the dump mount directory. Constraints N/A Range OBS: Object Storage Service OBSFS: OBS file system API Default Value N/A
address	String	Definition Source address of the dump mount directory. The value can be an HTTPS or OBS address. Constraints N/A Range N/A Default Value N/A
mount_path	String	Definition Path mounted to the container. The value must start with a slash (/) and can contain hyphens (-), backslashes (), underscores (_), periods (.), letters, and digits. Constraints N/A Range N/A Default Value N/A

**Table 11** TerminationGrace
Parameter	Type	Description
pre_stop_cmd	String	Definition: The shutdown command is triggered when the container receives a stop signal, but it must be completed within the grace period or the shutdown times out. If this happens, the container will be forcefully stopped. You can use this command to perform operations such as closing database connections, releasing file handles, and stopping child processes. Constraints The value can contain up to 255 characters. Range Protocol: http or https Port: 1 to 65535 Address: Only letters, digits, periods (.), hyphens (-), underscores (_), and slashes (/) are allowed. The value cannot start with a slash (/). Default Value N/A
termination_grace_period_seconds	Integer	Definition This parameter indicates the maximum length of time that can pass between when a Pod receives a stop signal to when it is forcefully stopped. It is used for the Pod to perform cleanup operations (such as closing connections, releasing resources, and saving states). Constraints The value can contain up to 255 characters. Range Protocol: http or https Port: 1 to 65535 Address: Only letters, digits, periods (.), hyphens (-), underscores (_), and slashes (/) are allowed. The value cannot start with a slash (/). Default Value N/A

**Table 12** Health
Parameter	Type	Description
check_method	String	Definition Health check method, which can be HTTP or EXEC (commands). Constraints N/A Range HTTP: Hypertext Transfer Protocol EXEC: commands Default Value During creation, if check_method is not specified, the default value is check_method. During update, if check_method is not specified, an error will be reported.
cmd	String	Definition Command line mandatory when the health check method is EXEC. Constraints The value can contain 0 to 1,024 characters and cannot contain the following characters: #~^$\|%&<>()'"[]{} Range* N/A Default Value N/A
url	String	Definition Request address mandatory when the health check mode is HTTP. Constraints The value can contain 0 to 1,024 characters. The first character must be a slash (/), and the subsequent characters can be letters, digits, hyphens (-), underscores (_), slashes (/), and colons (:). Range N/A Default Value N/A
protocol	String	Definition Connection protocol. The default value is HTTP. Constraints N/A Range HTTPS: Hypertext Transfer Protocol Secure HTTP: Hypertext Transfer Protocol WSS: WebSocket Secure WS: WebSocket Default Value N/A
initial_delay_seconds	Integer	Definition Waiting time before the first detection. The default value is 30 and the minimum value is 1. Constraints N/A Range N/A Default Value 30
timeout_seconds	Integer	Definition Timeout interval of the detection. The default value is 30 seconds, and the minimum value is 1 second. Constraints N/A Range The minimum value is 1 second. Default Value 30s
period_seconds	Integer	Definition Interval at which the health check is performed. The default value is 10 seconds, and the minimum value is 1 second. Constraints N/A Range The minimum value is 1 second. Default Value 10s
failure_threshold	Integer	Definition The minimum number of consecutive detection failures required after a successful detection. Detection is considered failed only when this threshold is reached. The default value is 3. The minimum value is 1. Constraints N/A Range The minimum value is 1. Default Value 3

**Table 13** Affinity
Parameter	Type	Description
affinity_type	String	Definition Node affinity type. Constraints N/A Range AFFINITY: affinity ANTI_AFFINITY: anti-affinity Default Value N/A
required	Boolean	Definition Specifies whether to set strong affinity. Constraints N/A Range true: Strong affinity is set. false: Strong affinity is not set. Default Value N/A
selection_mode	String	Definition Node selection mode. Constraints N/A Range IP Default Value N/A
targets	Map<String,String>	Definition List selected using the preceding method, whose length cannot exceed 20. Constraints N/A

**Table 14** ServiceSecurityConfig
Parameter	Type	Description
user_id	Long	Definition user_id set during service container startup. This parameter can be left empty by default. Range [1, 60000]
group_id	Long	Definition group_id set during service container startup. This parameter can be left empty by default. Range [1, 60000]

**Table 15** AdvancedConfig
Parameter	Type	Description
deploy_timeout_minutes	String	Definition Deployment timeout.
upgrade_config	UpgradeConfig object	Definition Rolling upgrade configuration.
service_secret	ServiceSecret object	Definition Service secret.
dynamic_routing_enable	Boolean	Definition Intelligent routing switch.
strategy	String	Definition Intelligent routing policy.
ems_enable	Boolean	Definition EMS acceleration switch.
metric_api_scheme	String	Definition Intelligent routing metric collection scheme.
metric_api_port	String	Definition Intelligent routing metric collection port.
metric_api_path	String	Definition Intelligent routing metric collection URL.
custom_metrics_path	String	Definition Custom metric collection URL.
port	Integer	Definition Container port.
protocol	String	Definition Container request protocol. When WSS or WS is selected, the service API is upgraded to WebSocket. WebSocket cannot be enabled together with Traffic Limit. Range HTTP: HTTP protocol HTTPS: HTTPS protocol WSS: WebSocket Secure protocol WS: WebSocket protocol TCP: Transmission Control Protocol NA: No protocol used

**Table 16** UpgradeConfig
Parameter	Type	Description
type	String	Definition Upgrade type. Constraints N/A Range ROLLING: rolling upgrade (default value) Default Value N/A
rolling_update	RollingUpdate object	Definition Rolling update configuration. Constraints N/A

**Table 17** RollingUpdate
Parameter	Type	Description
max_surge	String	Definition Maximum number of pods that can be started during rolling update. Constraints A percentage-type string. Range 1/ %to 100% Default Value 1%.
max_unavailable	String	Definition Maximum number of pods that can be deleted during rolling update. Constraints A percentage-type string. Range 1/ %to 100% Default Value 1%.

**Table 18** ServiceSecret
Parameter	Type	Description
secret_enable	Boolean	Definition Specifies whether to enable the key. Constraints N/A Range true: The secret is enabled. false: The secret is disabled. Default Value false
secret_type	String	Definition Secret type. Constraints N/A Range custom: custom secret. [dew: DEW secret.] (tag:hws,hws_hk,fcs) Default Value N/A
secret_volumes	Array of SecretVolume objects	Definition Secret volume mounting. Constraints Maximum: 30
group_enable	Boolean	Definition Specifies whether to enable the image user group. Constraints N/A Range true: The user group of the image is enabled. false: The user group of the image is not enabled. Default Value false
group_id	Long	Definition User group ID of the image. Constraints N/A Range 1000 to 4294967294 Default Value N/A

**Table 19** SecretVolume
Parameter	Type	Description
secret_name	String	Definition Secret name. Constraints N/A Range N/A Default Value N/A
secret_key	String	Definition Secret key. Constraints A string of 1 to 63 characters is matched. Only letters, digits, dots (.), underscores (_), and hyphens (-) are allowed. The string cannot start with two consecutive dots (..). Range N/A Default Value N/A
secret_value	String	Definition Secret value. Constraints The value is a Base64-encoded secret value and contains 1 to 32,768 characters. Range N/A Default Value N/A
mount_path	String	Definition Mount path. Constraints N/A Range The value must start and end with a slash (/) and can contain at most 255 characters. Only letters, digits, hyphens (-), and underscores (_) are allowed. Default Value N/A

**Table 20** FrozenInfo
Parameter	Type	Description
scene	String	Freezing scenario. Options: ARREAR: frozen due to arrears POLICE: frozen due to public security issues ILLEGAL: frozen due to abuse
effect	Integer	Impacts of freezing. Options: 1: can be released after being frozen 2: cannot be released after being frozen

Example Requests

Obtain a specific version of a specific deployment.

GET https://{end_point}/v2/{project_id}/services/{service_id}/deployments/{deployment_id}/versions/{version}

Example Responses

Status code: 200

Details about a deployment version.

{
  "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
}