List availability zones across all regions.

GET

/v1/availability-zones

Shell / cURL

curl --request GET \
  --url https://stratum.example.com/v1/availability-zones \
  --header 'Authorization: Bearer <token>'

Ordered by name ascending. This catalog is stable and small, so the order is part of the contract: a client may rely on it rather than re-sorting defensively.

Returns every zone in one response — nextPageToken is never populated.

Authorizations

bearerAuth

Responses

200

AZs.

application/json

object

items

required

Array<object>

object

name

required

string

/^[a-z][a-z0-9-]+[a-z]$/

region

required

string

/^[a-z][a-z0-9]+(-[a-z0-9]+)*$/

displayName

required

string

description

string

state

required

active accepts new resources. draining is an operator’s maintenance state: no new resources, existing ones continue. unavailable means no node that can run workloads is in this zone any more — derived from the nodes by the control plane, never set by hand, and back to active as soon as a node claims the zone again; do not place new resources here. deleted is terminal.

string

Allowed values: active draining unavailable deleted

createdAt

required

string format: date-time

updatedAt

required

string format: date-time

nextPageToken

string

Example

{
  "items": [
    {
      "state": "active"
    }
  ]
}