compute

PUT `/v1/compute/servers/{serverId}/firewall`

Replace a server's firewall rules.

Doğrulama

API açarını bearer token kimi göndərin. Açar sites.restart icazəsinə malik olmalıdır; bu icazəsi olmayan açar 404 deyil, 403 xətası ilə rədd edilir.

Bu endpoint heç bir təşkilat ID-si tələb etmir. Sizin açarınız artıq aid olduğu təşkilatı müəyyən edir və cavab həmin təşkilat üçün məhdudlaşdırılır.

Sınaqdan keçir

Bucaqlı mötərizələrdə olan hór şeyi öz qiymətlərinizlə, açar yertutucusunu isə idarə panelinizdən bir açarla əvəz edin.

curl -X PUT https://api.zinndigital.com/v1/compute/servers/{serverId}/firewall \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "rules": <ComputeFirewallRule[]> }'

Sistemə daxil olmusunuz? İdarə panelinizdəki API konsolu real təşkilatınızın identifikatorunu və öz açarınızı avtomatik doldurur, sorğunu canlı API-yə qarşı icra edir ki, siz faktiki cavabı görə biləsiniz. Bu son nöqtəni API konsolunda açın

Təfərrüatlar

⭐ **PUT, and the verb is the contract**: this replaces the entire rule set. The provider's write is atomic, and an add/remove surface layered over an atomic replace is how two people editing at once discard each other's rule with both requests reporting success. ⛔⛔ **This can lock the customer out of their own machine.** A set with no inbound SSH is applied exactly as asked and their next connection is refused. That is why `openComputeServerConsole` exists, and why a client should say so beside this control. Refused when more than one firewall is applied to the machine: the effective policy is their union, so editing one and reporting the result would be false in the dangerous direction. The whole rule set is audit-logged, not a count — when a customer reports being locked out, "12 rules were set" answers nothing. Requires `sites.restart`.

Parametrlər

Ad	Tip	Tələb olunur	Nədir
`serverId (path)`	`Uuid`	Bəli	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.

Sorğu gövdəsi

Ad	Tip	Tələb olunur	Nədir
`rules`	`ComputeFirewallRule[]`	Bəli	—

Cavab

Ad	Tip	Tələb olunur	Nədir
`id`	`string`	Bəli	The provider's firewall id
`name`	`string`	Bəli	Its name at the provider
`attached`	`boolean`	Bəli	Whether a firewall resource is actually applied to this machine.
`rules`	`ComputeFirewallRule[]`	Bəli	—

Bu son nöqtənin qaytara biləcəyi xətalar

401 · 403 · 404 · 422 · 429 · 503

PUT /v1/compute/servers/{serverId}/firewall