compute

DELETE /v1/compute/servers/{serverId}/console/allow

Revoke every address's console access.

Wszystkie punkty końcowe compute

Wszystkie dokumentacje dla programistów

Uwierzytelnianie

Wyślij klucz API jako token bearer. Klucz musi posiadać uprawnienie sites.restart; klucz bez niego jest odrzucany z kodem 403, a nie 404.

Ten punkt końcowy nie wymaga identyfikatora organizacji. Twój klucz już identyfikuje organizację, do której należy, a odpowiedź jest do niej ograniczona.

Wypróbuj

Zastąp wszystko w nawiasach ostrych własnymi wartościami, a zastępczy znacznik klucza kluczem ze swojego pulpitu nawigacyjnego.

curl -X DELETE https://api.zinndigital.com/v1/compute/servers/{serverId}/console/allow \
  -H "Authorization: Bearer zdk_live_…"

Zalogowany? Konsola API w Twoim panelu uzupełnia rzeczywiste identyfikator organizacji oraz Twój własny klucz i wykonuje żądanie względem aktywnego API, dzięki czemu możesz zobaczyć rzeczywistą odpowiedź. Otwórz ten punkt końcowy w konsoli API

Szczegóły

Revokes ALL of them, not one. The provider publishes no per-entry removal, so this is "shut the console" rather than "revoke that laptop" — a caller expecting the second gets the first, including their own access. Requires sites.restart.

Parametry

NazwaTypWymaganeCo to jest
serverId (path)UuidTakThe server's id, as listComputeServers reports it. Ours (UUIDv7), minted when the order row was written — never the provider's own identifier for the machine.

Odpowiedź

NazwaTypWymaganeCo to jest
urlstringTakThe console address, for kind: url (a page a browser opens) and kind: wss (a WebSocket endpoint a VNC client connects to). ⛔…
passwordstringTakThe password the console asks for, when the provider issues one alongside the URL. "" when the URL alone authenticates.
expires_atstringTakWhen it stops working, ISO-8601, or "" when the provider does not say. ⛔ Blank does not mean "never" — these last minutes by design. A url and a wss console are both…
kindstring<url, wss, vnc>Tak⛔⛔ THREE genuinely different consoles, not three spellings of one, and wss was missing (W22-B, D10906). url is a page a browser opens. wss is a one-shot WebSocket…
hoststringTakThe VNC host, for kind: vnc. ⛔ May be blank, and that is a refusal rather than a gap: where the only hostname a supplier states is its own branded one, we do not pass it on.
portintegerTakThe VNC port, 0 when the provider does not state one.
allowed_ipsstring[]TakThe addresses currently permitted to reach the console. ⛔⛔ An empty list on an IP-restricted console means NOBODY may connect — the exact opposite of the "no restriction" an…
ip_restrictedbooleanTakWhether the caller's address must be allow-listed before anything can connect. false means the credential alone is enough.

Błędy, które ten punkt końcowy może zwrócić

401 · 403 · 404 · 429 · 503