compute
PUT /v1/compute/servers/{serverId}/reverse-dns
Point one address's PTR at a hostname, or reset it.
Аутентификация
Отправьте ключ API в качестве токена носителя (bearer token). Ключ должен иметь разрешение sites.restart; ключ без него отклоняется с кодом 403, а не 404.
Этот эндпоинт не принимает идентификатор организации. Ваш ключ уже определяет организацию, к которой он принадлежит, и ответ ограничивается ее рамками.
Попробовать
Замените всё в угловых скобках на собственные значения, а плейсхолдер ключа — на ключ из вашей панели управления.
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> }'Вошли в систему? Консоль API в вашей панели управления автоматически подставляет реальный идентификатор вашей организации и ваш собственный ключ, а также выполняет запрос к работающему API, чтобы вы могли увидеть актуальный ответ. Откройте эту конечную точку в API-консоли
Подробнее
⛔ 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.
Параметры
| Имя | Тип | Обязательно | Что это |
|---|---|---|---|
serverId (path) | Uuid | Да | 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. |
Тело запроса
| Имя | Тип | Обязательно | Что это |
|---|---|---|---|
ip | string | Да | Which 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 request.… |
hostname | string | Нет | The 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… |
Ответ
| Имя | Тип | Обязательно | Что это |
|---|---|---|---|
data | ComputeReverseDnsRecord[] | Да | — |
Ошибки, которые может возвращать этот эндпоинт
401 · 403 · 404 · 422 · 429 · 503