Crea, modifica ed elimina zone

Questa pagina fornisce istruzioni per creare, aggiornare, elencare ed eliminare le zone gestite di Cloud DNS. Prima di utilizzare questa pagina, familiarizza con la panoramica di Cloud DNS e con i termini chiave.

Prima di iniziare

L'API Cloud DNS richiede la creazione di un progetto Cloud DNS e l'abilitazione dell'API Cloud DNS.

Se stai creando un'applicazione che utilizza l'API REST, devi creare anche un ID client OAuth 2.0.

  1. Se non ne hai già uno, registrati per creare un Account Google.
  2. Abilita l'API Cloud DNS nella console Google Cloud . Puoi scegliere un progetto Compute Engine o App Engine esistente oppure crearne uno nuovo.
  3. Se devi effettuare richieste all'API REST, devi creare un ID OAuth 2.0. Consulta come configurare OAuth 2.0.
  4. Nel progetto, prendi nota delle informazioni seguenti che dovrai inserire nei passaggi successivi:
    • L'ID client (xxxxxx.apps.googleusercontent.com).
    • L'ID progetto che vuoi utilizzare. Puoi trovare l'ID nella parte superiore della pagina Panoramica della console Google Cloud . Puoi anche chiedere all'utente di fornire il nome del progetto che vuole utilizzare nella tua app.

Se non hai mai eseguito Google Cloud CLI, devi eseguire il comando seguente per specificare il nome del progetto e autenticarti con la console Google Cloud :

gcloud auth login

Se vuoi eseguire un comando gcloud sulle risorse Google Cloud in un altro progetto, specifica l'opzione --project per questo comando e per gli altri comandi gcloud in questa pagina.

Crea zone gestite

Ogni zona gestita che crei è associata a un progettoGoogle Cloud . Le sezioni seguenti descrivono come creare il tipo di zona gestita supportato da Cloud DNS.

Crea una zona pubblica

Per creare una nuova zona gestita, completa i seguenti passaggi.

Console

  1. Nella console Google Cloud , vai alla pagina Crea una zona DNS.

    Vai a Crea una zona DNS

  2. Per Tipo di zona, seleziona Pubblica.

  3. Inserisci un Nome zona, ad esempio my-new-zone.

  4. Inserisci un suffisso del Nome DNS per la zona utilizzando un nome di dominio di tua proprietà. Tutti i record nella zona condividono questo suffisso, ad esempio: example.com.

  5. In DNSSEC, seleziona Off, On o Trasferimento. Per saperne di più, consulta Abilita DNSSEC per le zone gestite esistenti.

  6. Fai clic su Crea. Viene visualizzata la pagina Dettagli zona.

gcloud

Esegui il comando dns managed-zones create:

gcloud dns managed-zones create NAME \
    --description=DESCRIPTION \
    --dns-name=DNS_SUFFIX \
    --labels=LABELS \
    --visibility=public

Sostituisci quanto segue:

  • NAME: un nome per la zona
  • DESCRIPTION: una descrizione per la zona
  • DNS_SUFFIX: il suffisso DNS per la zona, ad esempio example.com
  • LABELS: un elenco facoltativo separato da virgole di coppie chiave/valore come dept=marketing o project=project1; per saperne di più, consulta la documentazione dell'SDK

Terraform

resource "google_dns_managed_zone" "example_zone" {
  name        = "example-zone"
  dns_name    = "example-${random_id.rnd.hex}.com."
  description = "Example DNS zone"
  labels = {
    name = "value"
  }
}

resource "random_id" "rnd" {
  byte_length = 4
}

API

Invia una richiesta POST utilizzando il metodo managedZones.create:

POST https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones
{
  "name": "NAME",
  "description": "DESCRIPTION",
  "dnsName": "DNS_NAME",
  "visibility": "public"
}

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui viene creata la zona gestita
  • NAME: un nome per la zona
  • DESCRIPTION: una descrizione per la zona
  • DNS_NAME: il suffisso DNS per la zona, ad esempio example.com