Obtaining the List of Instance Flavors

Function

This API is used to query and display the IDs of supported instance flavors.

URI

GET /v1.0/{project_id}/flavors
Table 1 Parameter description

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. For details, see Obtaining a Project ID and Name.

Request

None

Response

Table 2 describes the response parameters.

Table 2 Parameter description

Parameter

Type

Description

versions

Array of versions objects

List of engine versions.

Table 3 versions field description

Parameter

Type

Description

version

String

Engine version.

type

String

Instance type. The options are ess, ess-cold, ess-master, and ess-client.

flavors

Array of flavors objects

Flavor list

Table 4 flavors field description

Parameter

Type

Description

ram

Integer

Memory size of an instance. Unit: GB

cpu

Integer

Number of vCPUs of an instance.

name

String

Flavor name.

region

String

AZ

diskrange

String

Disk capacity range of an instance.

flavor_id

String

ID of a flavor.

Examples

Example request

GET /v1.0/6204a5bd270343b5885144cf9c8c158d/flavors

Example response

{
  "versions": [
    {
      "version": "6.2.3",
      "flavors": [
        {
          "cpu": 1,
          "ram": 8,
          "name": "css.medium.8",
          "region": "eu-de",
          "diskrange": "40,640",
          "flavor_id": "6b6c0bcf-750d-4f8a-b6f5-c45a143f5198"

        },
        {
          "cpu": 2,
          "ram": 16,
          "name": "css.large.8",
          "region": "eu-de",
          "diskrange": "40,1280",
          "flavor_id": "d373e339-3cf4-4c00-9739-2259e9f3ec16"

        },
        {
          "cpu": 4,
          "ram": 32,
          "name": "css.xlarge.8",
          "region": "eu-de",
          "diskrange": "40,2560",
          "flavor_id": "2d8daf1b-873f-4c2e-a7b9-2f9cbcf2f213"

        },
        {
          "cpu": 8,
          "ram": 64,
          "name": "css.2xlarge.8",
          "region": "eu-de",
          "diskrange": "80,5120",
          "flavor_id": "b3d33ec6-d58a-40f0-aa51-4f671ce64b2a"

        },
        {
          "cpu": 16,
          "ram": 128,
          "name": "css.4xlarge.8",
          "region": "eu-de",
          "diskrange": "160,10240",
          "flavor_id": "f74419ca-bc91-4558-b4e2-90eeefb37c6e"
        }
      ]
    }
  ]
}

Status Code

Table 5 describes the status code.

Table 5 Status codes

Status Code

Message

Description

400

BadRequest

Invalid request.

Modify the request instead of retrying.

404

NotFound

The requested resource cannot be found.

Modify the request instead of retrying.

200

OK

The request is processed.