Skip to content

List Hardware Configurations ​

Retrieve available hardware configurations (flavors) for GPU-enabled virtual machine instances. Each configuration represents a specific combination of computational resources including GPUs, CPUs, memory, and storage capacity.

HTTP Request ​

GET {API_URL}/flavors

Query Parameters ​

ParameterRequirementTypeDescription
region_idOptionalstringFilter configurations by specific region availability

Response Structure ​

status boolean ​

Operation result indicator. Returns true for successful execution, false when encountering an error.

message string ​

Descriptive response indicating the outcome of the configuration retrieval request.

data array ​

Collection of available configurations organized by GPU model and geographical region.

Configuration attributes include:

  • region string: Geographical location of hardware availability
  • products array: Detailed hardware configurations containing:
    • id string: Configuration unique identifier
    • name string: Configuration designation
    • region_name string: Deployment region designation
    • region_id string: Region unique identifier
    • price number: Hourly rate for resource utilization
    • cpu integer: Available CPU cores
    • disk integer: Primary storage capacity in gigabytes (GB)
    • ephemeral integer: Temporary storage allocation in gigabytes (GB)
    • ram integer: Available memory capacity in gigabytes (GB)
    • gpu string: GPU model specification
    • gpu_count integer: Number of GPU units
    • stock_available boolean: Current availability status
    • cycle string: Billing interval (default: hourly)

Implementation Example ​

Request ​

bash
curl -X GET '{API_URL}flavors' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'refresh-token: {REFRESH_TOKEN}' \
-H 'Content-Type: application/json'

Response ​

json
{
    "status": true,
    "message": "Hardware configurations retrieved successfully",
    "data": [
        {
            "region": "DALLAS",
            "products": [
                {
                    "id": "6705f8fb906a954599a47821",
                    "name": "1 x RTX4090",
                    "region_name": "DALLAS",
                    "price": 1.56,
                    "cpu": 32,
                    "disk": 500,
                    "ram": 256,
                    "gpu": "RTX4090",
                    "gpu_count": 4,
                    "bandwidth": "100 Mbps",
                    "cycle": "hourly"
                }
            ]
        }
    ]
}