Only Linux and Windows computers can choose where they run. Asking for a location with
os macos, android or ios returns 400.Pick a location in the dashboard
In the New computer sheet, the Location row says Auto (US). Press the row to see its choices: Auto (US) and each city with a server for the system you picked, each with its flag. A city with no room says Full and can’t be picked. The row shows for Linux and Windows computers without a GPU, once a city has a server for that system.Location values
Send one of these asregion when you create a computer.
Case does not matter. Full names work too, such as
london, sydney, new york, europe or asia pacific.
A city takes new computers only while it has a server for that system. To see which cities do right now, read locations, as described in See which cities have room.
Leaving region out, or sending null or "", is the same as us, with one difference: when every US server is full, the error is FLEET_CAPACITY_FULL rather than REGION_UNAVAILABLE.
See which cities have room
GET /billing/compute-limits?workspace_id= lists the cities this workspace can use now, in locations. The key needs Read on the Billing group. Replace $WORKSPACE_ID with your workspace ID.
locations part looks like this:
id: the code to send asregion.name: the city’s name.region: its group,us,euorapac.linuxandwindows:"available"when a server there has room for that system,"full"when its servers are full, andnullwhen the city has no server for it.
"available" comes from each server’s last check, so a create can still find the city full. When the list can’t be read, it is empty, and Auto (US) still works.
Create a computer in a city
Sendregion with the create. Replace $WORKSPACE_ID with your workspace ID.
--region:
201 says where the computer runs:
Read where a computer runs
Create computer and Get computer return two fields:region: the group,"us","eu"or"apac".location: the city code, such as"chi","lon"or"syd".
null before the computer is placed. location can be null for a computer in the US whose city Orgo does not record.
A computer stays where it was asked to run
A computer keeps the location it asked for. A start after a stop, a restore, and a wake from storage bring it back to the same place. Copies keep the location of the computer they copy: a clone, a fork, and a backup or snapshot restored as a new computer.When a city has no room
Orgo never puts a computer somewhere other than where you asked. When no server there has room, the create returns503 with code REGION_UNAVAILABLE and a Retry-After: 60 header. Nothing is made.
regionis the location you asked for.locationslists each city with a server for the system you asked for, withstock"available"or"full".
error says Try again in a few minutes.
Values that are refused
400 with code INVALID_REGION:
- A word Orgo does not know, such as
"mars", or a value that is not a string:region must be "us", "eu", "apac" or a city code: "nyc", "ash", "mia", "chi", "dal", "lax", "sjc", "lon" or "syd". - Any location with
osmacos,androidorios:A region can be chosen for Linux and Windows computers.
"dfw" or "sjc,lax". A three letter code that is not a city above, or a comma separated list, is read as no choice, so those clients keep working. Send one value: "lon,syd" is a list, so it is read as no choice too.