Help Center/ ModelArts/ API Reference/ DevServer Management/ Querying the Specification List
Updated on 2025-11-19 GMT+08:00
View PDF
Share

Querying the Specification List

Function

This API is used to query the specification list.

Debugging

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

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

DevServer flavor list.

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: 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: DevServer Management