Creare, modificare ed eliminare le zone

Questa pagina fornisce le 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 anche creare un ID client OAuth 2.0.

1. Se non ne hai ancora uno, registrati per aprire un Account Google.
2. Abilita l'API Cloud DNS nella Trusted Cloud console. 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 la pagina Configurare OAuth 2.0.
4. Nel progetto, prendi nota delle seguenti informazioni che devi 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 Trusted 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 questo comando per specificare il nome del progetto ed eseguire l'autenticazione con la console Trusted Cloud :

gcloud auth login

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

Creare zone gestite

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

Creare una zona privata

Per creare una nuova zona privata gestita con record DNS privati gestiti da Cloud DNS, completa i seguenti passaggi. Per ulteriori informazioni, consulta Best practice per le zone private Cloud DNS.

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

resource "google_dns_managed_zone" "private_zone" {
  name        = "private-zone"
  dns_name    = "private.example.com."
  description = "Example private DNS zone"
  labels = {
    foo = "bar"
  }

  visibility = "private"

  private_visibility_config {
    networks {
      network_url = google_compute_network.network_1.id
    }
    networks {
      network_url = google_compute_network.network_2.id
    }
  }
}

resource "google_compute_network" "network_1" {
  name                    = "network-1"
  auto_create_subnetworks = false
}

resource "google_compute_network" "network_2" {
  name                    = "network-2"
  auto_create_subnetworks = false
}

POST https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones
{

  "name": "NAME",
  "description": "DESCRIPTION",
  "dnsName": "DNS_NAME",
  "visibility": "private",
  "privateVisibilityConfig": {
    "kind": "dns#managedZonePrivateVisibilityConfig",
    "networks": [
      {
        "kind": "dns#managedZonePrivateVisibilityConfigNetwork",
        "networkUrl": "VPC_NETWORK_1"
      },
      {
        "kind": "dns#managedZonePrivateVisibilityConfigNetwork",
        "networkUrl": "VPC_NETWORK_2"
      },
      ....
    ]
  }
}

Crea una zona con autorizzazioni IAM specifiche

L'autorizzazione Identity and Access Management (IAM) per la zona gestita di una singola risorsa consente di configurare autorizzazioni di lettura, scrittura o amministratore specifiche per diverse zone gestite nello stesso progetto.

Per istruzioni su come creare una zona con autorizzazioni Identity and Access Management (IAM) specifiche, consulta Creare una zona con autorizzazioni IAM specifiche.

Crea una zona DNS di Service Directory

Puoi creare una zona Service Directory che consenta ai tuoi servizi basati su Trusted Cloud di eseguire query nello spazio dei nomi di Service Directory tramite DNS.

Per istruzioni dettagliate su come creare una zona DNS di Service Directory, vedi Configurazione di una zona DNS di Service Directory.

Per istruzioni su come utilizzare DNS per eseguire query nella tua Service Directory, consulta Esecuzione di query utilizzando DNS.

resource "google_dns_managed_zone" "private_zone" {
  name        = "private-zone"
  dns_name    = "private.example.com."
  description = "Example private DNS zone"
  labels = {
    foo = "bar"
  }

  visibility = "private"

  private_visibility_config {
    networks {
      network_url = google_compute_network.network_1.id
    }
    networks {
      network_url = google_compute_network.network_2.id
    }
  }
}

resource "google_compute_network" "network_1" {
  name                    = "network-1"
  auto_create_subnetworks = false
}

resource "google_compute_network" "network_2" {
  name                    = "network-2"
  auto_create_subnetworks = false
}

Crea una zona di inoltro

Le zone di inoltro ti consentono di scegliere come target i server dei nomi per zone private specifiche. Per istruzioni su come creare una nuova zona di inoltro privato gestito, consulta Creare una zona di inoltro.

Crea una zona di peering

Il peering DNS consente di inviare richieste di record provenienti dallo spazio dei nomi di una zona a un'altra rete VPC. Per istruzioni su come creare una zona di peering, consulta Creare una zona di peering.

Creazione di una zona di associazione tra progetti

Crea una zona privata gestita che può essere associata a una rete di proprietà di un progetto diverso all'interno della stessa organizzazione. Per istruzioni su come creare una zona di associazione tra progetti, consulta Zone di associazione tra progetti.

Aggiorna zone gestite

Cloud DNS ti consente di modificare determinati attributi della tua zona gestita privata gestita.

Aggiorna etichette

Per aggiungere nuove etichette, modificare quelle esistenti, rimuovere quelle selezionate o cancellare tutte le etichette in una zona gestita, completa i seguenti passaggi.

gcloud dns managed-zones update NAME \
    --update-labels=LABELS

gcloud dns managed-zones update NAME \
    --remove-labels=LABELS

gcloud dns managed-zones update NAME \
    --clear-labels

Elenca e descrivi le zone gestite

Le sezioni seguenti mostrano come elencare o descrivere una zona gestita.

Elenca zone gestite

Per elencare tutte le zone gestite all'interno di un progetto, completa i seguenti passaggi.

gcloud dns managed-zones list

gcloud dns managed-zones list \
   --filter="visibility=private"

Descrivere una zona gestita

Per visualizzare gli attributi di una zona gestita, completa i seguenti passaggi.

gcloud dns managed-zones describe NAME

Eliminare una zona gestita

Quando elimini una zona, i relativi record DNS vengono rimossi definitivamente e non possono essere recuperati. Per evitare di perdere i record DNS, esporta i dati della zona prima dell'eliminazione. Per informazioni su come esportare i dati di zona, consulta Importare ed esportare set di record di risorse.

Per eliminare una zona gestita, completa i seguenti passaggi.

Passaggi successivi

• Per trovare soluzioni ai problemi comuni che potresti riscontrare durante l'utilizzo di Cloud DNS, consulta la sezione Risoluzione dei problemi.
• Per configurare i criteri dei server Cloud DNS e utilizzarli con le reti VPC, consulta Applica i criteri dei server Cloud DNS.
• Per utilizzare i nomi di dominio internazionalizzati con Cloud DNS, vedi Creazione di zone con nomi di dominio internazionalizzati.
• Per visualizzare un log di controllo delle operazioni, vedi Visualizzare le operazioni sulle zone gestite.