Instance SKUs
List grouped instance-SKU availability
⚠️ This endpoint is in public preview.
Aggregate availability across instance SKUs that match requirements, grouped by the given property keys. Each group exposes a summed total schedule plus a per-SKU breakdown.
get/preview/v2/availability
Query parameters
requirementsstring
Filter SKUs before grouping. Semicolon-separated key:value[,value...] pairs (e.g. accelerator:H100). Use keys and values from /v2/instance_sku_property_catalog.
group_bySfcApiName[]
Property keys to group by. Repeatable: ?group_by=accelerator. Each key must be a public registry key. Empty group_by → a single aggregate group.
[ "my-resource-name" ]
Response
Grouped availability schedules.
Example response
{
"object": "list",
"data": [
{
"group": [
{
"key": {
"name": "my-resource-name",
"stable_at": 1738972800,
"deprecated_at": 1738972800
},
"value": {
"name": "my-resource-name",
"stable_at": 1738972800,
"deprecated_at": 1738972800
}
}
],
"allocation_schedule": {
"total": [
{
"start_at": 1738972800,
"end_at": 1738972800
}
]
}
}
]
}