domains

DELETE /v1/domains/{domainId}/dns/records/{recordId}

Delete a DNS record.

Всички крайни точки в domains

Всички документи за разработчици

Упълномощаване

Изпратете API ключ като токен за носене. Ключът трябва да притежава разрешението domains.dns.manage; ключ без него се отхвърля с 403, а не с 404.

Този ендпойнт не изисква идентификатор на организация. Вашият ключ вече идентифицира организацията, към която принадлежи, и отговорът е ограничен до нея.

Опитайте

Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.

curl -X DELETE https://api.zinndigital.com/v1/domains/{domainId}/dns/records/{recordId} \
  -H "Authorization: Bearer zdk_live_…"

Влязохте ли в профила си? API конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в API конзолата

Детайли

Removes the record recordId from the domain's hosted zone. Requires domains.dns.manage. As for update, a record hidden from the caller's line 404s rather than confirming it exists. Deleting an apex MX is refused 409 MAIL_CHANGE_REFUSED unless confirm_mail_change=true (issue #622). It fires on any apex MX deletion, not only the last one — "delete every MX one at a time" is the failure mode, and by the time the last one goes three deletions have already happened. The message says whether the domain would stop receiving mail entirely or merely fall back to a remaining host.

Параметри

ИмеТипЗадължителноКакво представлява
domainId (path)UuidДаThe domain's id.
recordId (path)stringДаThe DNS record's provider id.
confirm_mail_change (query)booleanНеSet true to proceed with a record change that would move or remove this domain's inbound email (issue #622). Without it, a write that stops mail reaching a host it reaches today…

Грешки, които този крайpoint може да върне

401 · 403 · 404 · 409 · 429 · 502 · 503