domains

PUT `/v1/domains/{domainId}/dns/records/{recordId}`

Update a DNS record.

احراز هویت

یک کلید API را به عنوان یک توکن حامل ارسال کنید. این کلید باید دارای مجوز domains.dns.manage باشد؛ کلیدی که فاقد آن باشد با خطای 403 رد می‌شود، نه 404.

این نقطه پایانی هیچ شناسه سازمانی را دریافت نمی‌کند. کلید شما در حال حاضر سازمان مربوطه را مشخص می‌کند و پاسخ در همان محدوده ارائه می‌شود.

امتحان کنید

هر چیزی را که داخل براکت‌های زاویه‌دار قرار دارد با مقادیر خودتان جایگزین کنید، و نگهدارنده کلید را با کلیدی از داشبورد خود جایگزین نمایید.

curl -X PUT https://api.zinndigital.com/v1/domains/{domainId}/dns/records/{recordId} \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "name": <string>, "type": <DnsRecordType>, "value": <string> }'

وارد شده‌اید؟ کنسول API در داشبورد شما شناسه سازمان واقعی و کلید خودتان را پر می‌کند و درخواست را روی API زنده اجرا می‌کند تا بتوانید پاسخ واقعی را ببینید. این نقطه پایانی را در کنسول API باز کنید

جزئیات

Replaces the record `recordId` in the domain's hosted zone. Requires `domains.dns.manage`. A record hidden from the caller's product line (an A/AAAA on the Footprint-Free line) is indistinguishable from an absent one — a 404 — so it cannot be probed by id (register #93). **Repointing a live apex `MX` is refused** `409 MAIL_CHANGE_REFUSED` unless `confirm_mail_change=true` (issue #622) — it silently stops the customer's email reaching the mailboxes it reaches today, which is data loss rather than a configuration change. So is moving the only apex `MX` onto a subdomain: the record survives, the domain's mail does not. A change that alters only TTL or preference is not refused, because mail still arrives at the same 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 tod…

بدنه درخواست

نام	نوع	الزامی	چیست
`name`	`string`	بله	The record name — `@`/empty for the apex, or a relative/absolute host.
`type`	`DnsRecordType`	بله	A DNS resource-record type the shared editor supports (docs/31 §5.2).
`value`	`string`	بله	—
`ttl`	`integer`	خیر	—
`priority`	`object`	خیر	—
`proxied`	`object`	خیر	Serve this record through the provider's HTTP proxy — Cloudflare's orange cloud. `A` and `AAAA` only; sending it on any other type is a `422` rather than a silent drop, beca…

پاسخ

نام	نوع	الزامی	چیست
`id`	`string`	بله	The provider-assigned record id.
`name`	`string`	بله	The record name — `@` for the apex, or a relative/absolute host.
`type`	`DnsRecordType`	بله	A DNS resource-record type the shared editor supports (docs/31 §5.2).
`value`	`string`	بله	The record value (target/content).
`ttl`	`integer`	بله	Time-to-live in seconds.
`priority`	`object`	خیر	Priority for MX/SRV records; null otherwise.
`proxied`	`object`	خیر	Whether this record is served through the provider's HTTP proxy — Cloudflare's orange cloud. Applies to `A` and `AAAA`; providers without a proxy ignore it. ⛔⛔ **Three state…
`owner`	`DnsRecordOwner`	بله	Who may change this record. `platform` means the platform created it and converges it — the A/AAAA record at the apex or `www` that points the domain at the hosting we run for i…
`drift`	`DnsRecordDrift`	خیر	What the last reconcile found about a platform-owned record at the provider, or `null` when the provider agrees with us (the overwhelmingly common case). `changed` — a recor…

خطاهایی که این نقطه پایانی می‌تواند برگرداند

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

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