List deployments - Alibaba Cloud Model Studio - Alibaba Cloud Documentation Center

Lists all model deployments in your account.

Prerequisites

Read Model deployment overview and Deploy models by using the API. Make sure you understand how model deployment works and the basic steps to deploy a model on the Model Studio platform.
Configure a Model Studio API key. For more information, see Get an API key.

List deployment tasks

Endpoint

GET https://dashscope-intl.aliyuncs.com/api/v1/deployments

Request example

Run the following command to retrieve a list of your deployments:

curl "https://dashscope-intl.aliyuncs.com/api/v1/deployments?page_no=1&page_size=100" \
    --header "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
    --header 'Content-Type: application/json'

Request parameters

Parameter	Type	Location	Required	Description
page_no	Number	query	Optional	The page number. Default value: 1.
page_size	Number	query	Optional	The number of entries per page. Default: 50. Value range: 1 to 200.

Response example

A successful request returns the following response:

{
  "request_id": "7efdd3a7-a90d-96c6-b477-70055d59edf7",
  "output": {
    "page_no": 1,
    "page_size": 10,
    "total": 1,
    "deployments": [
      {
        "deployed_model": "emo-35b3f106-sample01",
        "gmt_create": "2025-06-17T11:00:38",
        "gmt_modified": "2025-06-17T11:06:13",
        "status": "RUNNING",
        "model_name": "emo",
        "base_model": "emo",
        "base_capacity": 1,
        "capacity": 1,
        "ready_capacity": 1,
        "workspace_id": "llm-v71tlv3d***",
        "charge_type": "post_paid",
        "creator": "175805416***",
        "modifier": "175805416***"
      }
    ]
  }
}

Response parameters

See the response parameters in Create a model deployment task.

Error responses

Response example

{
    "request_id": "ca218d57-b91b-46b2-bd35-c41c6287bcf4",
    "message": "Model: qwen-plus-20230703-cx7f not found!",
    "code": "NotFound"
}

Response parameters

Field	Type	Description
request_id	String	The unique request ID.
code	String	The error code.
message	String	The error message.

The request can fail with the following errors:

Error code	Error message	Cause
NotFound	Model: xxx not found!	You specified a non-existent model when creating a deployment. You specified a non-existent model when querying, updating, or deleting a deployment.
Conflict	Deployed model xxx already exists, please specify a suffix.	The specified deployment suffix is already in use.
InvalidParameter	Invalid capacity (xx), capacity must be larger than or equal to 0 and multiples of 1 and less than 1000!	The specified number of compute units is invalid. This error can occur when you create or update a deployment.