You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: source/adminguide/networking/dns_framework.rst
+51-2Lines changed: 51 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -232,6 +232,55 @@ Using the API:
232
232
.. note:: Updating ``nameservers`` only affects new DNS zones created through this server. Existing DNS zones and their current NS records are not modified.
233
233
234
234
235
+
Deleting a DNS Server
236
+
---------------------
237
+
238
+
A DNS server can be deleted from CloudStack using the UI or API.
239
+
240
+
By default, all DNS zones associated with the server are also deleted. To retain them, set ``cleanup`` to ``false``.
241
+
242
+
When cleanup is enabled, you can use ``unmanage`` to remove DNS zones only from CloudStack without deleting them in the external DNS provider.
243
+
244
+
From UI:
245
+
246
+
Quick action buttons are available in the UI to delete a DNS server.
- If false, DNS zones associated with this server will not be deleted. **Default**: ``true``
279
+
* - ``unmanage``
280
+
- No
281
+
- Applicable only when ``cleanup: true``. If set to true, associated DNS zones are removed only from CloudStack and not from the external DNS provider. **Default**: ``false``
282
+
283
+
235
284
DNS Zone Management
236
285
^^^^^^^^^^^^^^^^^^^
237
286
@@ -278,7 +327,7 @@ Using the API:
278
327
- The description of the DNS zone
279
328
* - ``existing``
280
329
- No
281
-
- If true, imports an existing DNS zone from the external DNS provider into CloudStack; if false, creates a new DNS zone in both CloudStack and the DNS provider. **Default**: ``false``
330
+
- If true, imports an existing DNS zone from the external DNS provider into CloudStack; if false, creates the zone in the DNS provider and registers it in CloudStack. **Default**: ``false``
282
331
283
332
284
333
Listing DNS Zones
@@ -342,7 +391,7 @@ Using the API:
342
391
- The ID of the DNS zone
343
392
* - ``unmanage``
344
393
- No
345
-
- If false, removes it from both CloudStack and the DNS provider, if true, removes the DNS zone only from CloudStack. **Default**: ``false``
394
+
- If true, removes the DNS zone only from CloudStack (unmanaged); if false, removes it from CloudStack and deletes it from the DNS provider. **Default**: ``false``
346
395
347
396
348
397
.. note:: Deleting a DNS zone will also delete all DNS records within that zone.
0 commit comments