Delete DNS zones

This document guides you on how to delete a previously created public and private DNS zone in Google Distributed Cloud (GDC) air-gapped, when it is empty and no longer needed. The intended audience for this document is platform administrators and application operators responsible for managing DNS records within a project.

Before you begin

To delete DNS zones in GDC, you must have the following:

An existing DNS zone to delete. See List DNS zones for guidance on listing your current zones.
The necessary identity and access roles. To manage DNS records for your project, ask your Project IAM Admin to grant you the Managed DNS Project Admin (managed-dns-project-admin) role.
To use the gdcloud CLI, ensure you have it installed. For more information, see Install the gdcloud CLI.
If you are using kubectl, a kubeconfig file for the global API server. If you have not yet generated this file, see Sign in. For more information, see Global and zonal API servers.

Delete a public or private DNS zone

You can delete a public or private DNS zone using the gdcloud CLI or the Kubernetes API.

gdcloud

To delete a DNS zone, use the gdcloud dns managed-zones delete command:

gdcloud dns managed-zones delete DNS_ZONE_NAME \
    [--project=PROJECT_NAMESPACE] \
    [--async]

Replace the following:

DNS_ZONE_NAME: the name of your DNS zone to delete.
PROJECT_NAMESPACE: the namespace of your project. This flag is optional if you have set a default project globally using gdcloud config set project.
--async: Specify this if you want the command to return immediately, rather than wait for the operation to complete. You can use describe to check on the status of the operation.

API

Use the Kubernetes API in GDC to delete a public or private DNS zone:

kubectl --kubeconfig GLOBAL_API_SERVER \
delete manageddnszones.networking.global.gdc.goog/v1 DNS_ZONE_NAME \
-n PROJECT_NAMESPACE