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"
                }
            ]
        }
    ]
}