compute
DELETE /v1/compute/servers/{serverId}/console/allow
Revoke every address's console access.
Kimlik Doğrulama
Bearer token olarak bir API anahtarı gönderin. Anahtar sites.restart iznine sahip olmalıdır; bu izne sahip olmayan bir anahtar 404 ile değil, 403 ile reddedilir.
Bu uç nokta hiçbir organizasyon kimliği almaz. Anahtarınız zaten ait olduğu organizasyonu tanımlar ve yanıt bu organizasyonla sınırlandırılır.
Dene
Köşeli parantez içindeki her şeyi kendi değerlerinizle ve anahtar yer tutucusunu panonuzdan bir anahtarla değiştirin.
curl -X DELETE https://api.zinndigital.com/v1/compute/servers/{serverId}/console/allow \
-H "Authorization: Bearer zdk_live_…"Oturum açtınız mı? Panonuzdaki API konsolu, gerçek organizasyon kimliğinizi ve kendi anahtarınızı otomatik olarak doldurur ve isteği canlı API üzerinde çalıştırarak gerçek yanıtı görmenizi sağlar. Bu uç noktayı API konsolunda açın
Ayrıntılar
⛔ **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`.
Parametreler
| Ad | Tür | Zorunlu | Ne olduğu |
|---|---|---|---|
serverId (path) | Uuid | Evet | The 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. |
Yanıt
| Ad | Tür | Zorunlu | Ne olduğu |
|---|---|---|---|
url | string | Evet | The console address, for `kind: url` (a page a browser opens) and `kind: wss` (a WebSocket endpoint a VNC client connects to). ⛔ **Blank on a `vnc` console, and that is not a fa… |
password | string | Evet | The password the console asks for, when the provider issues one alongside the URL. `""` when the URL alone authenticates. |
expires_at | string | Evet | When 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 o… |
kind | string<url, wss, vnc> | Evet | ⛔⛔ **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 endp… |
host | string | Evet | The 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. |
port | integer | Evet | The VNC port, `0` when the provider does not state one. |
allowed_ips | string[] | Evet | The 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_restricted | boolean | Evet | Whether the caller's address must be allow-listed before anything can connect. `false` means the credential alone is enough. |
Bu uç noktanın dönderebileceği hatalar
401 · 403 · 404 · 429 · 503