DNS ゾーン

GET /v1/orgs/{orgSlug}/dns/zones

この org が runlot ネームサーバー上で運用している DNS ゾーンです。rrsets はここでは省略され、単一のゾーンを取得したときのみ返されます。viewer 以上の権限が必要です。

operationId listZones

POST /v1/orgs/{orgSlug}/dns/zones

冪等 — 既存のゾーンは変更されずに返されます。新しいゾーンは SOA レコードと apex の NS rrset とともに作成されます。この NS rrset は runlot によって管理されており編集できません。これがなければドメインはまったく解決されません。

ゾーンを作成しただけでは、いずれの名前も runlot 経由で解決されるようになるわけではありません。委任を有効にするには、レジストラの NS レコードを nameservers の値に変更してください — delegation フィールドはその状態を反映します。admin 以上が必要です。audit log には dns.zone.create として記録されます。

operationId createZone

リクエストボディ: application/json ・ object

GET /v1/orgs/{orgSlug}/dns/zones/{zone}

viewer 以上が必要です。

operationId getZone

DELETE /v1/orgs/{orgSlug}/dns/zones/{zone}

すべてのレコードとゾーン自体を削除します。委任が runlot のネームサーバーを指したままの場合、ドメインは解決されなくなります — 削除する前にレジストラの NS レコードを変更してください。admin 以上が必要です。audit log には dns.zone.delete として記録されます。

operationId deleteZone

PUT /v1/orgs/{orgSlug}/dns/zones/{zone}/rrsets/{name}/{type}

rrset（name + type）全体を1つ置き換えます。単一の値を追加するわけではありません — records はその rrset の新しい内容全体になります。

保存時に値が検証されます: CNAME は apex に置くことができず、同じ name の他のタイプと共存できません。また A/AAAA、MX、SRV、CAA は形式がチェックされます。255 バイトを超える TXT レコードはゾーンファイル内でチャンクに分割されます。runlot が管理するレコード（プロジェクトの連携、証明書の発行、ゾーンの NS）は 409 managed_rrset を返します。

member 以上が必要です。audit log には dns.rrset.set として記録されます。

operationId putRRset

リクエストボディ: application/json ・ object

DELETE /v1/orgs/{orgSlug}/dns/zones/{zone}/rrsets/{name}/{type}

member 以上が必要です。Runlot が代わりに管理しているレコードは 409 managed_rrset を返します — 削除するには、ここでレコードを削除するのではなく、Domains 画面からプロジェクトの接続を解除してください。audit イベントは dns.rrset.delete です。

operationId deleteRRset

POST /v1/orgs/{orgSlug}/dns/zones/{zone}/dnssec

ゾーンを off から signing に移行します。署名はネームサーバーによって行われ、鍵情報は Runlot に保存されることはありません。DNSSEC を無効にすると、記録された DS もクリアされます。古い鍵の DS を親ゾーンに登録したままにすると、ドメインの検証ができなくなります。admin 以上が必要です。

operationId setZoneDNSSEC

リクエストボディ: application/json ・ object

PUT /v1/orgs/{orgSlug}/dns/zones/{zone}/dnssec/ds

Runlot は親ゾーンに問い合わせを行いません。親ゾーンに DS レコードが存在するようになった時点でこの値を送信してください。すると、ゾーンは signing から ds_pending に移行します。空のリストは「まだない」ことを意味し、状態を進めません。admin 以上が必要です。

operationId setZoneDS

リクエストボディ: application/json ・ object