Help Center/ ModelArts/ API Reference/ Lite Server Management/ Querying the Specification List
Updated on 2026-01-30 GMT+08:00
Online Debugging
CLI Examples
View PDF
Share

Querying the Specification List

Function

This API is used to obtain information about all available resource specifications in the system. It is used when you need to know the available resource specifications so that you can select proper configurations when creating or adjusting a Lite Server instance. Before using this API, ensure that you have logged in to the system and have the permission to query specifications. After the query, the API returns information about all available resource specifications, including the specification ID, CPU, memory, and storage. If you do not have the required permission or the system does not have available resource specifications, 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/flavors

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
Table 2 Query Parameters

Parameter

Mandatory

Type

Description

server_type

No

String

Definition: Service type

Constraints: N/A

Range:

  • bms: The resource type is Bare Metal Server (BMS).

  • ecs: The resource type is Elastic Cloud Server (ECS)

  • hps: The resource type is supernode server.

Default Value: N/A

arch

No

String

Definition: The CPU architecture of the specification

Constraints: N/A

Range:

  • X86

  • ARM

Default Value: N/A

charging_mode

No

String

Definition: The billing mode

Constraints: N/A

Range:

  • PRE_PAID: Yearly/Monthly

  • POST_PAID: Pay-per-use

Default Value: N/A

Request Parameters

None

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

current

Integer

Definition: Current page number.

Constraints: N/A

Default Value: N/A

data

Array of ServerFlavorinstanceResponse objects

Lite Server specifications.

pages

Integer

Definition: Total number of pages.

Constraints: N/A

Default Value: N/A

size

Integer

Definition: Number of records on each page.

Constraints: N/A

Default Value: N/A

total

Long

Definition: Total number of records.

Constraints: N/A

Default Value: N/A
Table 4 ServerFlavorinstanceResponse

Parameter

Type

Description

arch

String

Definition: CPU architecture.

Constraints: N/A

Range:

  • X86: The CPU architecture is x86.

  • ARM: The CPU architecture is Arm.

Default Value: N/A

availability_zone

String

Definition: Partition name.

Constraints: N/A

Range: N/A

Default Value: N/A

charging_mode

String

Definition: Billing mode.

Constraints: N/A

Range:

  • PRE_PAID: yearly/monthly

  • POST_PAID: pay-per-use

Default Value: N/A

count

Integer

Definition: Quantity.

Constraints: N/A

Default Value: N/A

flavor

String

Definition: Specification name.

Constraints: N/A

Default Value: N/A

flavor_type

String

Definition: Flavor type.

Constraints: N/A

Default Value: N/A

roce_num

Integer

Definition: Number of RoCEs.

Constraints: N/A

Default Value: N/A

server_type

String

Definition: Service type.

Constraints: N/A

Range:

  • bms: The resource type is Bare Metal Server (BMS).

  • ecs: The resource type is Elastic Cloud Server (ECS)

  • hps: The resource type is supernode server.

Default Value: N/A

sku_code

String

Definition: Billing code.

Constraints: N/A

Default Value: N/A

specification

String

Definition: Flavor details.

Constraints: N/A

Default Value: N/A

status

String

Definition: Status.

Constraints: N/A

Default Value: N/A

is_sold_out

Boolean

Definition: Specifies whether it is sold out.

Constraints: N/A.

Range:

  • true: Sold out

  • false: Not sold out

Default Value: false.

Status code: 400

Table 5 Response body parameters

Parameter

Type

Description

error_code

String

  • Definition: ModelArts error code.

Range: N/A

error_msg

String

Definition: Error message.

Range: N/A

Status code: 401

Table 6 Response body parameters

Parameter

Type

Description

error_code

String

  • Definition: ModelArts error code.

Range: N/A

error_msg

String

Definition: Error message.

Range: N/A

Status code: 403

Table 7 Response body parameters

Parameter

Type

Description

error_code

String

  • Definition: ModelArts error code.

Range: N/A

error_msg

String

Definition: Error message.

Range: N/A

Status code: 500

Table 8 Response body parameters

Parameter

Type

Description

error_code

String

  • Definition: ModelArts error code.

Range: N/A

error_msg

String

Definition: Error message.

Range: N/A

Example Requests

GET https://{endpoint}/v1/{project_id}/dev-servers/flavors

Example Responses

None

Status Codes

Status Code

Description

200

Accepted

400

Bad Request

401

Unauthorized

403

Forbidden

500

Server Internal Error

Error Codes

See Error Codes.

Parent topic: Lite Server Management