Skip to main content
A capacity is a named container that holds a compute allocation schedule across one or more zones. You buy compute time into a capacity with orders, and nodes on the capacity run during the scheduled time slots. Buy orders add time to the schedule, sell orders remove it.

​
Create a capacity

sf capacities create --zone richmond --name dev
A capacity must target at least one zone. You can target multiple zones so the system can place your nodes in whichever has availability. 
sf capacities create --zone richmond --zone marina --name multi-zone
Run sf zones ls to see available zones.

​
List capacities

sf capacities ls

NAME  ZONE      NODES  PERIOD
dev   richmond      -  -

​
View a capacity

sf capacities get dev

│ CAPACITY ID  cap_nuO4nVSM8O3NnsRE7udBe
│ NAME         dev
│ ZONES        richmond
│ CREATED      Feb 17, 5:23pm PDT
│ SCHEDULE     Today, 5:00pm: 1 node
│              Tomorrow, 5:00pm: 0 nodes
└ PROCUREMENTS dev-proc

​
Allocation schedule

The allocation schedule shows how many nodes you have over time on this capacity. Each time a buy order fills, the schedule gains time. Each time a sell order fills, it loses time. Nodes on the capacity can be created before there is allocation. They start running when allocation becomes available and are terminated when it runs out.

​
Update a capacity

Change the zones a capacity targets. 
sf capacities set dev --zone marina
Rename a capacity. 
sf capacities set dev --name production

​
Delete a capacity

sf capacities delete dev

​
API reference

See the Capacities API for programmatic access.