Help Center/ ModelArts/ API Reference/ DevServer Management/ Obtaining Lite Server Service Details

Updated on 2026-01-30 GMT+08:00

View PDF

Obtaining Lite Server Service Details

Function

This API is used to obtain Lite Server deployment service details based on the service ID. It is used when you need to view the details of a deployed service, such as the status and APIs of the service. Before using this API, ensure that you have the permission to view services. After the query, the API returns the details of the deployed service, including the name, status, description, used model, and instance details. If you do not have the required permission or the ID does not exist, the API returns an error message.

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, no identity policy-based permission required for calling this API.

URI

GET /v1/{project_id}/dev-servers/jobs/services/{id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition: Project ID. For details, see Obtaining a Project ID and Name. Constraints: The value can contain 1 to 64 characters. Letters, digits, and hyphens (-) are allowed. Range: N/A Default Value: N/A
id	Yes	String	Definition: ID of the deployed service. Constraints: The value can contain letters, digits, and hyphens (-). Range: N/A Default Value: N/A

Request Parameters

None

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
id	String	Definition: ID of the deployed service. Range: N/A.
name	String	Definition: Name of the deployed service. Range: N/A.
status	String	Definition: Status of the deployed instance. Range: CREATING, RUNNING, FAILED, DELETED, or ERROR.
spec	Map<String,String>	Definition: Feature parameter of the deployed service. Range: N/A.
instances	Array of AIServiceInstance objects	Definition: Instance of the deployed service.
model	Model object	Definition: Model used by the deployed service.

**Table 3** AIServiceInstance
Parameter	Type	Description
id	String	Definition: ID of the deployed instance. Range: N/A.
status	String	Definition: Status of the deployed instance. Range: CREATING, RUNNING, FAILED, DELETED, or ERROR.
endpoints	String	Definition: Call method information. Range: N/A.

**Table 4** Model
Parameter	Type	Description
name	String	Definition: Model name. Range: N/A.
url	String	Definition: OBS path of the model. Range: N/A.
quant_type	String	Description: Quantization data type. Range: w8A8 and fp16

Example Requests

GET https://{endpoint}/v1/{project_id}/dev-servers/job/services/{id}

{ }

Example Responses

Status code: 200

{
  "id" : "da126646-035a-4c74-a4ff-5ef77bbb2881",
  "name" : "k8s_SERVICE_DEPLOY",
  "status" : "CREATING",
  "spec" : {
    "model_name" : "DeepSeek-V3",
    "mount_path" : "/mnt/aiserver/model",
    "sfs_turbo_id" : "",
    "instance_num" : "1",
    "deploy_openwebui" : "false"
  },
  "instances" : [ {
    "id" : "da126646-0576-4a7d-8957-462bb8687e10",
    "status" : "CREATING",
    "endpoints" : "api:http://192.168.0.37:8080/v1/chat/completions,open_web_ui:http://192.168.0.37:30000"
  } ],
  "model" : {
    "name" : "DeepSeek-R1",
    "url" : "https://models-jl.obs.cn-north-7.ulanqab.huawei.com/DeepSeek-R1-w8a8-vllm-fusion",
    "quant_type" : "w8a8"
  }
}