Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
  • Blog
  • Pricing
  • Documentation
Yandex project
© 2025 Yandex.Cloud LLC
Yandex Cloud DNS
  • Getting started
    • All guides
      • Creating a private DNS zone
      • Creating a public DNS zone
      • Updating a DNS zone
      • Configuring DNS zone access permissions
      • Viewing operations with DNS zones
      • Deleting a DNS zone
  • Access management
  • Pricing policy
  • Terraform reference
  • Monitoring metrics
  • Audit Trails events
  • Release notes
  • FAQ
  1. Step-by-step guides
  2. Zones
  3. Deleting a DNS zone

Deleting a DNS zone

Written by
Yandex Cloud
Updated at May 5, 2025

To delete a DNS zone:

Management console
CLI
Terraform
API
  1. In the management console, select the folder to delete a DNS zone from.
  2. Select Cloud DNS.
  3. Click in the row of the zone to delete.
  4. In the menu that opens, click Delete.
  5. In the window that opens, click Delete.

If you do not have the Yandex Cloud CLI yet, install and initialize it.

The folder specified when creating the CLI profile is used by default. To change the default folder, use the yc config set folder-id <folder_ID> command. You can specify a different folder using the --folder-name or --folder-id parameter.

  1. View a description of the CLI delete zone command:

    yc dns zone delete --help
    
  2. Get a list of all DNS zones in the default folder:

    yc dns zone list
    
  3. Select the ID or NAME of the zone.

  4. Delete the zone from the default folder:

    yc dns zone delete <zone_name_or_ID>
    

If you do not have Terraform yet, install it and configure its Yandex Cloud provider.

To delete a DNS zone created using Terraform:

  1. Open the Terraform configuration file and delete the fragment with the DNS zone description.

    Example DNS zone description in the Terraform configuration
    resource "yandex_vpc_network" "foo" {}
    
    resource "yandex_dns_zone" "zone1" {
      name        = "my-public-zone"
      description = "Test public zone"
    
      labels = {
        label1 = "test-public"
      }
    
      zone = "test.example-public2.com."
    }
    
  2. In the command line, go to the directory with the Terraform configuration file.

  3. Check the configuration using this command:

    terraform validate
    

    If the configuration is correct, you will get this message:

    Success! The configuration is valid.
    
  4. Run this command:

    terraform plan
    

    The terminal will display a list of resources with parameters. No changes will be made at this step. If the configuration contains any errors, Terraform will point them out.

  5. Apply the configuration changes:

    terraform apply
    
  6. Confirm the changes: type yes into the terminal and press Enter.

    You can check the DNS zone deletion using the management console or this CLI command:

    yc dns zone list
    

To delete a DNS zone, use the delete REST API method for the DnsZone resource or the DnsZoneService/Delete gRPC API call.

Was the article helpful?

Previous
Viewing operations with DNS zones
Next
Getting a list of DNS zones
Yandex project
© 2025 Yandex.Cloud LLC