Get capacity availability
Find which Availability Zones are most likely to support the instance types and Node counts you request.
Authorization: Bearer [API-ACCESS-TOKEN] header. Capacity Finder requires
an authenticated organization but no additional Capacity Finder-specific
role or permission.
Send at least one selection and exactly one capacity plan,
CAPACITY_PLAN_SPOT, the only supported plan. Each selection must use
a distinct instance type and a positive whole-number Node count.
Encode requestedCount as a JSON integer, such as 8, up to
2147483647.
Scores reflect cached capacity and go up to 0.95. Higher scores
indicate more favorable availability. They do not reserve Nodes or
guarantee provisioning. Results include only Zones with available
capacity for the instance type.Autorisations
Use a CoreWeave API access token for your organization.
Corps
GetCapacityAvailabilityRequest defines the capacity options to evaluate.
Exactly one capacity plan is required. Send CAPACITY_PLAN_SPOT, the only supported plan.
CAPACITY_PLAN_SPOT At least one instance type and requested node count is required. Each instance type must occur at most once, even when the requested counts differ.
Limits the evaluation to these availability zones. Omit the list or send an empty list to evaluate all eligible zones. Ineligible zones are ignored and duplicate zones are evaluated once. No eligible matches is a successful empty result.
Réponse
OK
GetCapacityAvailabilityResponse contains ranked availability results.
Ordered by descending score, then by instance type and zone. Each result represents one zone, instance type, and capacity plan. A selection without positive cached capacity contributes no results. An empty result is successful. Do not expect a result for every requested zone and instance type.