| 方法 | 路径 | 摘要 | 认证 |
|---|---|---|---|
| GET | /v1/dns/platform-config | Read the installation-wide DNS configuration (节点管理 > DNS配置, platform administrator) | 登录会话 |
| PUT | /v1/dns/platform-config | Save the installation-wide DNS configuration and synchronise every tenant copy | 登录会话 |
| POST | /v1/dns/platform-config/{kind} | Start 记录修复 (repair) or 清除CDN无关解析 (cleanup) as background jobs | 登录会话 |
| GET | /v1/dns/platform-zones | List the CNAME domains (CNAME域名) | 登录会话 |
| POST | /v1/dns/platform-zones | Add a CNAME domain (copied into every tenant; the first is the default allocation zone) | 登录会话 |
| PATCH | /v1/dns/platform-zones/{id} | Edit a CNAME domain; renaming one with allocated CNAMEs is refused (dns_zone_in_use) | 登录会话 |
| DELETE | /v1/dns/platform-zones/{id} | Delete a CNAME domain and its tenant copies; refused while sites use it (dns_zone_in_use) | 登录会话 |
| GET | /v1/dns/providers | List DNS provider configurations | 登录会话 |
| POST | /v1/dns/providers | Store an encrypted DNS provider configuration | 登录会话 |
| PATCH | /v1/dns/providers/{id} | Update provider metadata or replace encrypted credentials | 登录会话 |
| DELETE | /v1/dns/providers/{id} | Delete an unreferenced DNS provider configuration | 登录会话 |
| POST | /v1/dns/providers/{id}/verify | Verify a DNS provider credential against its upstream API | 登录会话 |
| GET | /v1/dns/records | List structured records in a zone | 登录会话 |
| POST | /v1/dns/records | Create a validated draft DNS record | 登录会话 |
| PATCH | /v1/dns/records/{id} | Update a validated draft DNS record | 登录会话 |
| DELETE | /v1/dns/records/{id} | Delete a draft DNS record | 登录会话 |
| GET | /v1/dns/settings | Read the DNS settings for the active tenant scope | 登录会话 |
| PATCH | /v1/dns/settings | Update the compatibility DNS TTL with compare-and-swap semantics | 登录会话 |
| GET | /v1/dns/settings/operations/{operation_id} | Read a DNS DNS operation status | 登录会话 |
| POST | /v1/dns/settings/{kind} | Enqueue record repair or CDN-unrelated record cleanup | 登录会话 |
| GET | /v1/dns/zones | List DNS zones | 登录会话 |
| POST | /v1/dns/zones | Create a draft DNS zone | 登录会话 |
| DELETE | /v1/dns/zones/{id} | Delete an unreferenced draft DNS zone | 登录会话 |
契约文件：api/openapi/v1/control.yaml api/openapi/v1/dns-acme.yaml