Help Center/ Cloud Service Engine/ API Reference/ CSE API/ Engine Management/ Querying the Flavor List of a Microservice Engine
Updated on 2025-04-25 GMT+08:00

Querying the Flavor List of a Microservice Engine

Function

This API is used to query the flavor list of a microservice engine, including exclusive ServiceComb engines and registry/configuration centers.

URI

GET /v2/{project_id}/enginemgr/flavors

Table 1 Path parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID, which must be unique. The value contains 1 to 64 characters.

Table 2 Query parameters

Parameter

Mandatory

Type

Description

specType

No

String

Deployment type of a microservice engine.

  • To query an exclusive ServiceComb engine, set it to CSE2.
  • To query a registry/configuration center, set it to Nacos2.

Request

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token.

Content-Type

Yes

String

Set it to application/json;charset=UTF-8.

Accept

Yes

String

Set it to application/json.

Response

Status code: 200
Table 4 Response body parameters

Parameter

Type

Description

total

Integer

Total number of microservice engine flavors.

data

Array of FlavorBrief objects

Microservice engine flavor details.

Table 5 FlavorBrief

Parameter

Type

Description

flavor

String

Microservice engine flavor.

description

String

Microservice engine flavor description.

spec

EngineSpec object

Parameters about an exclusive microservice engine.

Table 6 EngineSpec

Parameter

Type

Description

availableCpuMemory

String

CPU and memory.

linear

String

linear flavor or not.

availablePrefix

String

Prefix of the available node flavor type.

Status code: 400
Table 7 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

detail

String

Location details.

Status code: 500
Table 8 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

detail

String

Location details.

Example Request

GET https://{endpoint}/v2/{project_id}/enginemgr/flavors?specType=CSE2

Example Response

Status code: 200

Response struct for querying the flavor list of a microservice engine.

{
  "total" : 0,
  "data" : [ {
    "flavor" : "cse.s1.small2",
    "description" : "string",
    "spec" : [ {
      "availableCpuMemory" : "2-4",
      "linear" : false,
      "availablePrefix" : "s,c,t"
    } ]
  } ]
}

Status Code

Status Code

Description

200

OK

400

Bad Request

500

Internal Server Error

Error Code

See Error Codes.