doc-exports/docs/css/api-ref/ListFlavors.html

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.

Parent topic: Cluster Management APIs