Update DNS zones

This document guides you on how to update previously created public and private DNS zones in Google Distributed Cloud (GDC) air-gapped.

Before you begin

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

• An existing public or private DNS zone. See List DNS zones for guidance on listing your current zones.
• The necessary identity and access roles. To manage DNS zones for your project, ask your Project IAM Admin to grant you the Managed DNS Project Admin (managed-dns-project-admin) role.
• 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.

Update a public or private DNS zone

Note: You can only update the DNS name description field (description). You can't update the DNS zone name (dnsName), or the zone type (visibility) identifying the zone as public or private.

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

kubectl --kubeconfig GLOBAL_API_SERVER apply -f - <<EOF
apiVersion: networking.global.gdc.goog/v1
kind: ManagedDNSZone
metadata:
  name: DNS_ZONE_NAME
  namespace: PROJECT_NAMESPACE
spec:
  dnsName: DOMAIN_NAME
  description: NEW_DESCRIPTION
  visibility: PUBLIC
EOF

Replace the following:

• GLOBAL_API_SERVER: the global API server's kubeconfig path. For more information, see Global and zonal API servers. If you have not yet generated a kubeconfig file for the API server, see Sign in for details.
• DNS_ZONE_NAME: the name of your DNS zone which needs to be updated.
• PROJECT_NAMESPACE: the namespace of your project.
• DOMAIN_NAME: the domain name for your public DNS zone, such as example.com.
• NEW_DESCRIPTION: the updated description for your DNS zone. For example, Public DNS zone for mydomain.com.