compute

PUT /v1/compute/servers/{serverId}/reverse-dns

Point one address's PTR at a hostname, or reset it.

Všechny koncové body compute

Autentizace

Zašlete API klíč jako nosný token (bearer token). Klíč musí mít oprávnění sites.restart; klíč bez něj je odmítnut s kódem 403, nikoli 404.

Tento koncový bod nevyžaduje žádné ID organizace. Váš klíč již identifikuje organizaci, ke které patří, a odpověď je na ni omezena.

Vyzvednout

Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.

curl -X PUT https://api.zinndigital.com/v1/compute/servers/{serverId}/reverse-dns \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "ip": <string> }'

Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API

Podrobnosti

⛔ `ip` is required and is never inferred from the machine: a machine has an IPv4 and an IPv6 address with **different** default states, so "set the PTR of this server" is not a well-formed request. An empty `hostname` resets that address to the provider's own default, which is a real thing to want and is not the same as leaving it alone. ⛔⛔ **The hostname must resolve forward to this address, and that is checked before anything is written.** Receiving mail servers check forward-confirmed reverse DNS, so a PTR whose name does not point back is *worse* than the supplier's default: it looks configured on the screen and still fails delivery. A name that does not resolve at all is refused too — "we could not look it up" is not evidence the record exists. An `ip` the machine does not hold is `422`, and that refusal is the tenancy boundary: the provider would happily set a PTR for any address on the account, including another customer's. Requires `sites.restart`.

Parametry

NázevTypPožadovánoCo to je
serverId (path)UuidAnoThe 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.

Tělo požadavku

NázevTypPožadovánoCo to je
ipstringAnoWhich address to set. ⛔ Required and never inferred: a machine has an IPv4 and an IPv6 with different default states, so "set the PTR of this server" is not a well-formed reques…
hostnamestringNeThe name to point at. **Empty resets the address to the provider's own default**, which is a real thing to want and is not the same as leaving it alone. ⛔ A non-empty name must…

Odpověď

NázevTypPožadovánoCo to je
dataComputeReverseDnsRecord[]Ano

Chyby, které může tento koncový bod vrátit

401 · 403 · 404 · 422 · 429 · 503