Preview — pending review
This reference is generated from the platform API contract and is still under review. Operations, fields, and descriptions can change before publication.
The published images of a region (the image picker source)
The operator-PUBLISHED, still-present catalog images of the region, recommended first. name
is the operator display name when set, else the Glance image name. imageId is the Glance
image id an instance create takes. licenseSlugs are the licenses the image
carries -- billed on every VM booted from it.
Any authenticated principal may read it.
Validation: region is not resolved against the region registry: an unknown region
answers an empty images list, not 404.
Async & state: Synchronous read; no state change.
Errors: 401 unauthenticated; 500.
Idempotency/Concurrency: Safe.
bearerTokenAuthorizationBearer <token>An API token (pc_live_…) or a service-account key (sak_live_…), created in Identity & Access Management and sent as Authorization: Bearer <token>. Requests are rate limited per credential and per tenant: every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset, and a refused request gets 429 RATE_LIMITED with Retry-After.
region*stringThe platform region code.
The region's published images.
application/json- response
images*array<>curl -X GET "https://example.com/regions/string/images"{ "images": [ { "id": "string", "imageId": "string", "name": "string", "description": "string", "osIcon": "string", "isRecommended": true, "region": "string", "minDiskGb": 0, "minRamMb": 0, "sizeBytes": 0, "licenseSlugs": [ "string" ] } ]}