Method: managedZones.delete

Deletes a previously created ManagedZone.

HTTP request

DELETE https://dns.googleapis.com/dns/v1/projects/{project}/managedZones/{managedZone}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
project

string

Identifies the project addressed by this request.
managedZone

string

Identifies the managed zone addressed by this request. Can be the managed zone name or ID.

Query parameters

Parameters
clientOperationId

string

For mutating operation requests only. An optional identifier specified by the client. Must be unique for operation resources in the Operations collection.

Request body

The request body must be empty.

Response body

If successful, the response body is empty.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ndev.clouddns.readwrite

For more information, see the Authentication Overview.

Examples

C#GoJavaNode.jsPHPPythonRuby

Uses the .NET client library.

// BEFORE RUNNING:
// ---------------
// 1. If not already done, enable the Google Cloud DNS API
//    and check the quota for your project at
//    https://console.developers.google.com/apis/api/dns
// 2. This sample uses Application Default Credentials for authentication.
//    If not already done, install the gcloud CLI from
//    https://cloud.google.com/sdk and run
//    `gcloud beta auth application-default login`.
//    For more information, see
//    https://developers.google.com/identity/protocols/application-default-credentials
// 3. Install the C# client library by adding a dependency on the relevant NuGet
//    package. Libraries published by Google are owned by google-apis-packages:
//    https://www.nuget.org/profiles/google-apis-packages

using Google.Apis.Auth.OAuth2;
using Google.Apis.Dns.v1;
using Google.Apis.Services;
using Newtonsoft.Json;
using System.Threading.Tasks;

namespace DnsSample
{
    public class DnsExample
    {
        public static void Main(string[] args)
        {
            DnsService dnsService = new DnsService(new BaseClientService.Initializer
            {
                HttpClientInitializer = GetCredential(),
                ApplicationName = "Google-DnsSample/0.1",
            });

            // Identifies the project addressed by this request.
            string project = "my-project";  // TODO: Update placeholder value.

            // Identifies the managed zone addressed by this request. Can be the managed zone name or id.
            string managedZone = "my-managed-zone";  // TODO: Update placeholder value.

            ManagedZonesResource.DeleteRequest request = dnsService.ManagedZones.Delete(project, managedZone);

            // To execute asynchronously in an async method, replace `request.Execute()` as shown:
            request.Execute();
            // await request.ExecuteAsync();
        }

        public static GoogleCredential GetCredential()
        {
            GoogleCredential credential = Task.Run(() => GoogleCredential.GetApplicationDefaultAsync()).Result;
            if (credential.IsCreateScopedRequired)
            {
                credential = credential.CreateScoped("https://www.googleapis.com/auth/cloud-platform");
            }
           return credential;
        }
    }
}

Uses the Go client library.

package main

// BEFORE RUNNING:
// ---------------
// 1. If not already done, enable the Google Cloud DNS API
//    and check the quota for your project at
//    https://console.developers.google.com/apis/api/dns
// 2. This sample uses Application Default Credentials for authentication.
//    If not already done, install the gcloud CLI from
//    https://cloud.google.com/sdk/ and run
//    `gcloud beta auth application-default login`.
//    For more information, see
//    https://developers.google.com/identity/protocols/application-default-credentials
// 3. Install and update the Go dependencies by running `go get -u` in the
//    project directory.

import (
        "log"

        "golang.org/x/net/context"
        "golang.org/x/oauth2/google"
        "google.golang.org/api/dns/v1"
)

func main() {
        ctx := context.Background()

        c, err := google.DefaultClient(ctx, dns.CloudPlatformScope)
        if err != nil {
                log.Fatal(err)
        }

        dnsService, err := dns.New(c)
        if err != nil {
                log.Fatal(err)
        }

        // Identifies the project addressed by this request.
        project := "my-project" // TODO: Update placeholder value.

        // Identifies the managed zone addressed by this request. Can be the managed zone name or id.
        managedZone := "my-managed-zone" // TODO: Update placeholder value.

        if err := dnsService.ManagedZones.Delete(project, managedZone).Context(ctx).Do(); err != nil {
                log.Fatal(err)
        }
}

Uses the Java client library.

/*
 * BEFORE RUNNING:
 * ---------------
 * 1. If not already done, enable the Google Cloud DNS API
 *    and check the quota for your project at
 *    https://console.developers.google.com/apis/api/dns
 * 2. This sample uses Application Default Credentials for authentication.
 *    If not already done, install the gcloud CLI from
 *    https://cloud.google.com/sdk and run
 *    `gcloud beta auth application-default login`.
 *    For more information, see
 *    https://developers.google.com/identity/protocols/application-default-credentials
 * 3. Install the Java client library on Maven or Gradle. Check installation
 *    instructions at https://github.com/google/google-api-java-client.
 *    On other build systems, you can add the jar files to your project from
 *    https://developers.google.com/resources/api-libraries/download/dns/v1/java
 */
import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.json.JsonFactory;
import com.google.api.client.json.jackson2.JacksonFactory;
import com.google.api.services.dns.Dns;
import java.io.IOException;
import java.security.GeneralSecurityException;
import java.util.Arrays;

public class DnsExample {
  public static void main(String args[]) throws IOException, GeneralSecurityException {
    // Identifies the project addressed by this request.
    String project = "my-project"; // TODO: Update placeholder value.

    // Identifies the managed zone addressed by this request. Can be the managed zone name or id.
    String managedZone = "my-managed-zone"; // TODO: Update placeholder value.

    Dns dnsService = createDnsService();
    Dns.ManagedZones.Delete request = dnsService.managedZones().delete(project, managedZone);

    request.execute();
  }

  public static Dns createDnsService() throws IOException, GeneralSecurityException {
    HttpTransport httpTransport = GoogleNetHttpTransport.newTrustedTransport();
    JsonFactory jsonFactory = JacksonFactory.getDefaultInstance();

    GoogleCredential credential = GoogleCredential.getApplicationDefault();
    if (credential.createScopedRequired()) {
      credential =
          credential.createScoped(Arrays.asList("https://www.googleapis.com/auth/cloud-platform"));
    }

    return new Dns.Builder(httpTransport, jsonFactory, credential)
        .setApplicationName("Google-DnsSample/0.1")
        .build();
  }
}

Uses the Node.js client library.

// BEFORE RUNNING:
// ---------------
// 1. If not already done, enable the Google Cloud DNS API
//    and check the quota for your project at
//    https://console.developers.google.com/apis/api/dns
// 2. This sample uses Application Default Credentials for authentication.
//    If not already done, install the gcloud CLI from
//    https://cloud.google.com/sdk and run
//    `gcloud beta auth application-default login`.
//    For more information, see
//    https://developers.google.com/identity/protocols/application-default-credentials
// 3. Install the Node.js client library by running
//    `npm install googleapis --save`

const {google} = require('googleapis');
const dns = google.dns('v1');

async function main () {
  const authClient = await authorize();
  const request = {
    // Identifies the project addressed by this request.
    project: 'my-project',  // TODO: Update placeholder value.

    // Identifies the managed zone addressed by this request. Can be the managed zone name or id.
    managedZone: 'my-managed-zone',  // TODO: Update placeholder value.

    auth: authClient,
  };

  try {
    await dns.managedZones.delete(request);
  } catch (err) {
    console.error(err);
  }
}
main();

async function authorize() {
  const auth = new google.auth.GoogleAuth({
    scopes: ['https://www.googleapis.com/auth/cloud-platform']
  });
  return await auth.getClient();
}

Uses the PHP client library.

<?php
/*
 * BEFORE RUNNING:
 * ---------------
 * 1. If not already done, enable the Google Cloud DNS API
 *    and check the quota for your project at
 *    https://console.developers.google.com/apis/api/dns
 * 2. This sample uses Application Default Credentials for authentication.
 *    If not already done, install the gcloud CLI from
 *    https://cloud.google.com/sdk and run
 *    `gcloud beta auth application-default login`.
 *    For more information, see
 *    https://developers.google.com/identity/protocols/application-default-credentials
 * 3. Install the PHP client library with Composer. Check installation
 *    instructions at https://github.com/google/google-api-php-client.
 */

// Autoload Composer.
require_once __DIR__ . '/vendor/autoload.php';

$client = new Google_Client();
$client->setApplicationName('Google-DnsSample/0.1');
$client->useApplicationDefaultCredentials();
$client->addScope('https://www.googleapis.com/auth/cloud-platform');

$service = new Google_Service_Dns($client);

// Identifies the project addressed by this request.
$project = 'my-project';  // TODO: Update placeholder value.

// Identifies the managed zone addressed by this request. Can be the managed zone name or id.
$managedZone = 'my-managed-zone';  // TODO: Update placeholder value.

$service->managedZones->delete($project, $managedZone);
?>

Uses the Python client library.

"""
BEFORE RUNNING:
---------------
1. If not already done, enable the Google Cloud DNS API
   and check the quota for your project at
   https://console.developers.google.com/apis/api/dns
2. This sample uses Application Default Credentials for authentication.
   If not already done, install the gcloud CLI from
   https://cloud.google.com/sdk and run
   `gcloud beta auth application-default login`.
   For more information, see
   https://developers.google.com/identity/protocols/application-default-credentials
3. Install the Python client library for Google APIs by running
   `pip install --upgrade google-api-python-client`
"""

from googleapiclient import discovery
from oauth2client.client import GoogleCredentials

credentials = GoogleCredentials.get_application_default()

service = discovery.build('dns', 'v1', credentials=credentials)

# Identifies the project addressed by this request.
project = 'my-project'  # TODO: Update placeholder value.

# Identifies the managed zone addressed by this request. Can be the managed zone name or id.
managed_zone = 'my-managed-zone'  # TODO: Update placeholder value.

request = service.managedZones().delete(project=project, managedZone=managed_zone)
request.execute()

Uses the Ruby client library.

# BEFORE RUNNING:
# ---------------
# 1. If not already done, enable the Google Cloud DNS API
#    and check the quota for your project at
#    https://console.developers.google.com/apis/api/dns
# 2. This sample uses Application Default Credentials for authentication.
#    If not already done, install the gcloud CLI from
#    https://cloud.google.com/sdk and run
#    `gcloud beta auth application-default login`.
#    For more information, see
#    https://developers.google.com/identity/protocols/application-default-credentials
# 3. Install the Ruby client library and Application Default Credentials
#    library by running `gem install google-api-client` and
#    `gem install googleauth`

require 'googleauth'
require 'google/apis/dns_v1'

service = Google::Apis::DnsV1::DnsService.new

service.authorization = \
    Google::Auth.get_application_default(['https://www.googleapis.com/auth/cloud-platform'])

# Identifies the project addressed by this request.
project = 'my-project'  # TODO: Update placeholder value.

# Identifies the managed zone addressed by this request. Can be the managed zone name or id.
managed_zone = 'my-managed-zone'  # TODO: Update placeholder value.

service.delete_managed_zone(project, managed_zone)