compute
GET /v1/compute/regions
List the cloud regions a machine can be bought in right now.
Автентифікація
Надішліть ключ API як маркер носія (bearer token). Ключ повинен мати дозвіл sites.view; ключ без нього відхиляється з кодом 403, а не 404.
Де вказується ідентифікатор вашої організації
Цей ендпоїнт приймає org_id як параметр запиту. Залиште його порожнім, і виклик охопить увесь ваше дерево орендарів; надішліть його, щоб звузити виклик до однієї організації.
Ідентифікатор вашої організації знаходиться на екрані API-ключів у вашій панелі керування, поруч із самим ключем. Це той самий ідентифікатор у кожному вашому запиті.
Спробувати
Замініть усе в кутових дужках власними значеннями, а заповнювач ключа — ключем із вашої панелі керування.
curl -X GET https://api.zinndigital.com/v1/compute/regions \
-H "Authorization: Bearer zdk_live_…"Увійшли в систему? Консоль API у вашій панелі керування автоматично підставляє ваш реальний ідентифікатор організації та ваш власний ключ, а також виконує запит до робочого API, щоб ви могли побачити справжню відповідь. Відкрийте цю кінцеву точку в консолі API
Деталі
Every region of the Zinn® Cloud range that is both buildable (the live catalogue lists a machine size there) and sold (an orderable size carries a price there). Either alone is a region a customer could choose and then not buy, so neither is enough on its own. A region is a city identified by slug; the client translates it. zone and provider are echoed only so an order form can send the choice back to POST /v1/compute/servers. Requires sites.view.
Параметри
| Назва | Тип | Обов'язкове | Що це таке |
|---|---|---|---|
org_id (query) | Uuid | Ні | The organisation to read for. Required only when the caller belongs to more than one; omitted, it is their own. |
Відповідь
| Назва | Тип | Обов'язкове | Що це таке |
|---|---|---|---|
data | ComputeRegion[] | Так | — |
Помилки, які може повертати ця кінцева точка
401 · 403 · 422 · 429 · 503