compute

GET /v1/compute/servers

List the servers in scope.

ყველა compute ენდპოინტი

ავტორიზაცია

API გასაღები გაგზავნეთ როგორც მატარებელი ტოკენი (bearer token). გასაღებს უნდა ჰქონდეს sites.view ნებართვა; ამის გარეშე გასაღები უარყოფილი იქნება 403 და არა 404 სტატუსით.

სwhere your organisation id goes-ის ადგილი

ეს ენდპოინტი იყენებს პარამეტრად org_id. მისი გამოტოვების შემთხვევაში ზარი ფარავს თქვენი იჯარის მთელ ქვეხეს, ხოლო გაგზავნისას ზარი შეიზღუდება მხოლოდ ერთ ორგანიზაციამდე.

თქვენი ორგანიზაციის ID მითითებულია თქვენი სამართავი პანელის API გასაღებების ეკრანზე, თავად გასაღებთან ახლოს. ის ერთნაირია თქვენ მიერ განხორციელებულ ყველა გამოძახებაში.

სცადეთ

შეSubstituted any value inside angle brackets with your own and the key placeholder with a key from your dashboard.

curl -X GET https://api.zinndigital.com/v1/compute/servers \
  -H "Authorization: Bearer zdk_live_…"

შესული ხართ? თქვენი სამართავ პანელში არსებული API კონსოლი ავტომატურად ამატებს თქვენი რეალური ორგანიზაციის ID-სა და საკუთარ გასაღებს და ატარებს მოთხოვნას ცოცხალ API-ს წინააღმდეგ, რათა იხილოთ რეალური პასუხი. გაAღით ეს ენდპოინტი API კონსოლში

დეტალები

Every machine the caller can see, or — with `?org_id=` — one organisation's. The scoped form is what a reseller's console sends. An organisation outside the readable scope narrows to nothing rather than `403`-ing, exactly as `listSites` does: a `403` would confirm the organisation exists. ⛔ **Resolved from our own rows, not from the provider's listing**, which is every customer on the reseller account. `status` is ours (how far the order got) and `power_state` is the machine's (what it is doing now); they are separate facts and rounding the provider's word into ours would silently make an unrecognised state `active`, which is what unlocks the power and resize controls. `operable` is read rather than re-derived from `status`, so a screen never offers a control the engine refuses. Requires `sites.view`.

პარამეტრები

სახელიტიპისავალდებულორა არის ეს
org_id (query)UuidარაNarrow the list to one organisation the caller can read.

პასუხი

სახელიტიპისავალდებულორა არის ეს
dataComputeServer[]დიახThe machines, across every organisation the caller can read.

შეცდომები, რომლებიც ამ ენდპოინტს შეუძლია დააბრუნოს

401 · 403 · 404 · 422 · 429 · 503