hosting
POST /v1/sites/{siteId}/edge-domains/{hostname}/dns
Publish this domain's DNS records for the customer.
Упълномощаване
Изпратете API ключ като токен за носене. Ключът трябва да притежава разрешението hosting.deploy.manage; ключ без него се отхвърля с 403, а не с 404.
Този ендпойнт не изисква идентификатор на организация. Вашият ключ вече идентифицира организацията, към която принадлежи, и отговорът е ограничен до нея.
Опитайте
Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.
curl -X POST https://api.zinndigital.com/v1/sites/{siteId}/edge-domains/{hostname}/dns \
-H "Authorization: Bearer zdk_live_…"Влязохте ли в профила си? API конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в API конзолата
Детайли
Writes the records and then resolves them, so the answer is what the internet says rather than what we did. Three tiers in order — the customer's own connected DNS provider, then our nameservers with the zone pre-built, then the records to publish by hand — and the tier that was actually used comes back as mode. In nameservers mode the nameservers array is the one thing left for the customer to do. Requires hosting.deploy.manage.
Параметри
| Име | Тип | Задължително | Какво представлява |
|---|---|---|---|
siteId (path) | Uuid | Да | Site ID (UUIDv7). |
hostname (path) | string | Да | The bound hostname, lower-cased and without a trailing dot. |
Отговор
| Име | Тип | Задължително | Какво представлява |
|---|---|---|---|
hostname | string | Да | — |
mode | string<unknown, our_zone, byo_dns, nameservers, manual> | Да | — |
zone | string | Да | — |
vendor | string | Да | — |
detail | string | Да | — |
nameservers | string[] | Да | Populated only in nameservers mode — the zone is built and the records are in it, and setting these at the registrar is the one thing left to do. |
records | DnsRecordPlan[] | Да | — |
checks | DnsRecordCheck[] | Да | — |
resolves | boolean | Да | — |
Грешки, които този крайpoint може да върне
401 · 403 · 404 · 422 · 429