domains

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

Update a DNS record.

Uthibitishaji

Tuma ufunguo wa API kama tokeni ya kubeba. Ufunguo lazima uwe na ruhusa ya domains.dns.manage; ufunguo usio nayo unakataliwa kwa 403, si 404.

Endpoint hii haichukui kitambulisho cha shirika. Ufunguo wako tayari unalitambua shirika linalohusika, na jibu limewekewa kikomo kwa shirika hilo pekee.

Jaribu

Badilisha chochote kilicho ndani ya mabano ya pembe na maadili yako mwenyewe, na kishikiliaji cha ufunguo na ufunguo kutoka kwa dashibodi yako.

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> }'

Umeingia kwenye akaunti? Dashibodi yako ya kiweko cha API inajaza kitambulisho chako halisi cha shirika na ufunguo wako mwenyewe, na kuendesha ombi dhidi ya API ya moja kwa moja ili uweze kuona jibu halisi. Fungua sehemu hii ya mwisho (endpoint) kwenye konsole ya API

Maelezo

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.

Vigezo

Jina	Aina	Inayohitajika	Kilicho hiki
`domainId (path)`	`Uuid`	Ndiyo	The domain's id.
`recordId (path)`	`string`	Ndiyo	The DNS record's provider id.
`confirm_mail_change (query)`	`boolean`	Hapana	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…

Mwili wa ombi

Jina	Aina	Inayohitajika	Kilicho hiki
`name`	`string`	Ndiyo	The record name — `@`/empty for the apex, or a relative/absolute host.
`type`	`DnsRecordType`	Ndiyo	A DNS resource-record type the shared editor supports (docs/31 §5.2).
`value`	`string`	Ndiyo	—
`ttl`	`integer`	Hapana	—
`priority`	`object`	Hapana	—
`proxied`	`object`	Hapana	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…

Majibu

Jina	Aina	Inayohitajika	Kilicho hiki
`id`	`string`	Ndiyo	The provider-assigned record id.
`name`	`string`	Ndiyo	The record name — `@` for the apex, or a relative/absolute host.
`type`	`DnsRecordType`	Ndiyo	A DNS resource-record type the shared editor supports (docs/31 §5.2).
`value`	`string`	Ndiyo	The record value (target/content).
`ttl`	`integer`	Ndiyo	Time-to-live in seconds.
`priority`	`object`	Hapana	Priority for MX/SRV records; null otherwise.
`proxied`	`object`	Hapana	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`	Ndiyo	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`	Hapana	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…

Hitilafu ambazo mwisho huu unaweza kurudisha

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

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