Adicione, atualize e elimine registos

Esta página descreve como adicionar, atualizar e eliminar conjuntos de registos de recursos.

Para ver a lista de tipos de registos de recursos compatíveis, consulte o artigo Tipos de registos de recursos compatíveis.

Antes de começar

  1. Crie uma zona gerida. Conclua os pré-requisitos para criar uma zona gerida e crie uma zona gerida.

  2. Selecione um tipo de registo de recurso suportado. Escolha um tipo de registo de recurso para o seu conjunto de registos de recursos.

Adicione um conjunto de registos de recursos

Para adicionar um conjunto de registos de recursos, siga estes passos:

Consola

  1. Na Google Cloud consola, aceda à página Zonas de DNS na nuvem.

    Aceda às zonas do Cloud DNS

  2. Clique no nome da zona gerida à qual quer adicionar o registo.

  3. Na página Detalhes da zona, clique em Adicionar padrão.

  4. Na página Criar conjunto de registos, no campo Nome DNS, introduza o subdomínio da zona de DNS, por exemplo, mail. O ponto final é adicionado automaticamente no final.

    Para criar um registo de DNS de caráter universal, introduza um asterisco, por exemplo, *.example.com.

    O símbolo arroba (@) não cria automaticamente um registo de nível superior. Para criar um registo de recurso no vértice do domínio, deixe o campo Nome de DNS em branco.

  5. Selecione o Tipo de registo de recurso, por exemplo, MX.

  6. No campo TTL, introduza um valor numérico para o tempo de vida do registo de recursos, que é o tempo durante o qual pode ser armazenado em cache. Este valor tem de ser um número inteiro positivo.

  7. No menu Unidade de TTL, selecione a unidade de tempo, por exemplo, minutes.

  8. Consoante o tipo de registo de recursos que selecionou, preencha os campos restantes.

  9. Para introduzir informações adicionais, clique em Adicionar item.

  10. Clique em Criar.

gcloud

Para adicionar um conjunto de registos de recursos, use o comando gcloud dns record-sets create:

gcloud dns record-sets create RRSET_NAME \
    --rrdatas=RR_DATA \
    --ttl=TTL \
    --type=RRSET_TYPE \
    --zone=MANAGED_ZONE

Substitua o seguinte:

  • RRSET_NAME: o nome DNS que corresponde às consultas recebidas com o nome DNS desta zona como sufixo, por exemplo, test.example.com
  • RR_DATA: um valor arbitrário associado ao conjunto de registos de recursos, por exemplo, 198.51.100.5; também pode introduzir vários valores, rrdata1 rrdata2 rrdata3, por exemplo, 198.51.100.5 10.2.3.4...
  • TTL: o TTL em segundos que o resolvedor armazena em cache este conjunto de registos de recursos, por exemplo, 30
  • RRSET_TYPE: o tipo de registo de recurso deste conjunto de registos de recursos, por exemplo, A.
  • MANAGED_ZONE: a zona gerida à qual este conjunto de registos de recursos está afiliado, por exemplo, my-zone-name; o nome deste conjunto de registos de recursos tem de ter o nome DNS da zona gerida como sufixo

API

Para adicionar um conjunto de registos de recursos, use o método resourceRecordSets.create:

POST https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets
{
    "name": "RRSET_NAME",
    "type": "RRSET_TYPE",
    "ttl": TTL,
    "rrdatas": [ RR_DATA ]
}

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto
  • MANAGED_ZONE: a zona gerida à qual este conjunto de registos de recursos está afiliado, por exemplo, my-zone-name; o nome deste conjunto de registos de recursos tem de ter o nome DNS da zona gerida como sufixo
  • RRSET_NAME: o nome DNS que corresponde às consultas recebidas com o nome DNS desta zona como sufixo, por exemplo, test.example.com
  • RRSET_TYPE: o tipo de registo de recurso deste conjunto de registos de recursos, por exemplo, A
  • TTL: o TTL em segundos que o resolvedor armazena em cache este conjunto de registos de recursos, por exemplo, 30
  • RR_DATA: um valor arbitrário associado ao conjunto de registos do recurso, por exemplo, "198.51.100.5". Também pode introduzir vários valores numa lista separada por vírgulas, por exemplo, "198.51.100.5","10.2.3.4".

Terraform 

resource "google_dns_managed_zone" "parent_zone" {
  name        = "sample-zone"
  dns_name    = "sample-zone.hashicorptest.com."
  description = "Test Description"
}

resource "google_dns_record_set" "default" {
  managed_zone = google_dns_managed_zone.parent_zone.name
  name         = "test-record.sample-zone.hashicorptest.com."
  type         = "A"
  rrdatas      = ["10.0.0.1", "10.1.0.1"]
  ttl          = 86400
}

Adicione uma coleção de conjuntos de registos de recursos numa transação

Pode adicionar vários conjuntos de registos de recursos criando uma transação que especifique as alterações. Uma transação é um grupo de uma ou mais alterações de registos DNS que têm de ser aplicadas como uma unidade. Toda a transação é bem-sucedida ou falha, o que garante que os seus dados nunca ficam num estado inconsistente. Só pode criar uma transação através da CLI gcloud ou da API Cloud DNS.

Para criar uma transação, siga estes passos:

gcloud

  1. Para iniciar uma transação, use o comando gcloud dns record-sets transaction start:

    gcloud dns record-sets transaction start \
   --zone=MANAGED_ZONE

    Substitua MANAGED_ZONE pelo nome da zona gerida cujos conjuntos de registos de recursos quer gerir, por exemplo, my-zone-name.

  2. Para adicionar um conjunto de registos de recursos como parte de uma transação, use o comando gcloud dns record-sets transaction add:

    gcloud dns record-sets transaction add RR_DATA \
   --name=DNS_NAME \
   --ttl=TTL \
   --type=RECORD_TYPE \
   --zone=MANAGED_ZONE

    Substitua o seguinte:

    • RR_DATA: um valor arbitrário associado ao conjunto de registos de recursos, por exemplo, 198.51.100.5. Também pode introduzir vários valores, rrdata1 rrdata2 rrdata3, por exemplo, 198.51.100.5 10.2.3.4...
    • DNS_NAME: o DNS ou o nome de domínio do conjunto de registos a adicionar, por exemplo, test.example.com
    • TTL: o tempo de vida (TTL) para o registo definido em número de segundos, por exemplo, 300
    • RECORD_TYPE: o tipo de registo, por exemplo, A.
    • MANAGED_ZONE: o nome da zona gerida cujos conjuntos de registos de recursos quer gerir, por exemplo, my-zone-name

  3. Para executar a transação, use o comando gcloud dns record-sets transaction execute:

    gcloud dns record-sets transaction execute \
   --zone=MANAGED_ZONE

  4. Para adicionar uma transação com carateres universais, use o comando gcloud dns record-sets transaction add:

    gcloud dns record-sets transaction add \
   --zone=MANAGED_ZONE \
   --name=WILDCARD_DNS_NAME \
   --type=RECORD_TYPE \
   --ttl=TTL

    Substitua o seguinte:

    • MANAGED_ZONE: o nome da zona gerida cujos conjuntos de registos de recursos quer gerir, por exemplo, my-zone-name
    • WILDCARD_DNS_NAME: o DNS ou o nome de domínio do conjunto de registos de recursos que quer adicionar, por exemplo, *.example.com. (tenha em atenção o ponto final)
    • RECORD_TYPE: o tipo de registo, por exemplo, CNAME.
    • TTL: o TTL do conjunto de registos em número de segundos, por exemplo, 300

API

Para criar uma transação com novos conjuntos de registos de recursos, use o método changes.create:

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

{
  "deletions": []
  "additions": [
    {
      "name": DNS_NAME,
      "type": RECORD_TYPE,
      "ttl": TTL,
      "rrdatas": [
        RR_DATA
      ]
    }
  ]
}

Substitua o seguinte:

  • PROJECT_ID: o ID do seu projeto
  • MANAGED_ZONE: o nome ou o ID da sua zona gerida
  • DNS_NAME: o DNS ou o nome de domínio do conjunto de registos, por exemplo, test.example.com. (tenha em atenção o ponto final)
  • RECORD_TYPE: o tipo de registo
  • TTL: o tempo de vida (TTL) do conjunto de registos em número de segundos. Por exemplo, 30
  • RR_DATA: um valor arbitrário associado ao conjunto de registos de recursos, por exemplo, 198.51.100.5; também pode introduzir vários valores, rrdata1 rrdata2 rrdata3, por exemplo, 198.51.100.5 10.2.3.4...

Para entregar emails no seu domínio, tem de adicionar registos MX à sua zona. Se usar o Google Workspace como fornecedor do protocolo SMTP (Simple Mail Transfer Protocol), consulte a página de apoio técnico Configurar registos do Google Workspace.MX Caso contrário, use os detalhes do registo MX do seu fornecedor e siga o processo de configuração descrito para o Google Workspace.

Veja conjuntos de registos de recursos de uma zona

Para ver conjuntos de registos de recursos de uma zona, siga estes passos:

Consola

  1. Na Google Cloud consola, aceda à página Cloud DNS.

    Aceda ao Cloud DNS

  2. No separador Zonas, clique na zona para a qual quer ver os conjuntos de registos de recursos.

    A página Detalhes da zona mostra os detalhes de todos os conjuntos de registos de recursos nessa zona.

gcloud

Para ver os registos de DNS da sua zona, use o comando gcloud dns record-sets list:

gcloud dns record-sets list \
   --zone="ZONE_NAME"

Substitua ZONE_NAME pelo nome de uma zona DNS no seu projeto.

O comando produz a resposta JSON para o conjunto de registos de recursos dos primeiros 100 registos. Pode especificar estes parâmetros adicionais:

  • --limit: número máximo de conjuntos de registos a apresentar
  • --name: apenas lista conjuntos de registos de recursos com este nome de domínio exato
  • --type: apenas lista registos deste tipo; se estiver presente, o parâmetro --name também tem de estar presente

API

Para ver os registos de DNS da sua zona, use o método resourceRecordSets.list:

GET https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto
  • MANAGED_ZONE: a zona gerida à qual este conjunto de registos de recursos está afiliado, por exemplo, my-zone-name; o nome deste conjunto de registos de recursos tem de ter o nome DNS da zona gerida como sufixo

Veja os detalhes de um conjunto de registos de recursos

Este procedimento pressupõe que já criou um conjunto de registos de recursos na zona do Cloud DNS gerida.

Para ver os detalhes de um conjunto de registos de recursos existente, siga estes passos:

Consola

  1. Na Google Cloud consola, aceda à página Zonas de DNS na nuvem.

    Aceda às zonas do Cloud DNS

  2. Clique na zona que contém o conjunto de registos de recursos.

  3. Clique no conjunto de registos de recursos cujos detalhes quer ver.

    A página Detalhes do conjunto de registos de recursos apresenta os detalhes do conjunto de registos de recursos.

gcloud

Para ver os detalhes de um conjunto de registos de recursos existente, use o comando gcloud dns record-sets describe:

gcloud dns record-sets describe RRSET_NAME \
  --type=RRSET_TYPE \
  --zone=MANAGED_ZONE

Substitua o seguinte:

  • RRSET_NAME: o nome DNS que corresponde às consultas recebidas com o nome DNS desta zona como sufixo, por exemplo, test.example.com
  • RRSET_TYPE: o tipo de registo de recurso deste conjunto de registos de recursos, por exemplo, A.
  • MANAGED_ZONE: a zona gerida à qual este conjunto de registos de recursos está afiliado, por exemplo, my-zone-name; o nome deste conjunto de registos de recursos tem de ter o nome DNS da zona gerida como sufixo

API

Para obter os detalhes de um conjunto de registos de recursos existente, use o método resourceRecordSets.get:

GET https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets/RRSET_NAME/RRSET_TYPE

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto
  • MANAGED_ZONE: a zona gerida à qual este conjunto de registos de recursos está afiliado, por exemplo, my-zone-name; o nome deste conjunto de registos de recursos tem de ter o nome DNS da zona gerida como sufixo
  • RRSET_NAME: o nome DNS que corresponde às consultas recebidas com o nome DNS desta zona como sufixo, por exemplo, test.example.com
  • RRSET_TYPE: o tipo de registo deste conjunto de registos de recursos, por exemplo, A.

Atualize um conjunto de registos de recursos

Para modificar um conjunto de registos, siga estes passos:

Consola

Para aplicar uma atualização parcial a um conjunto de registos de recursos existente, siga estes passos:

  1. Na Google Cloud consola, aceda à página Zonas de DNS na nuvem.

    Aceda às zonas do Cloud DNS

  2. Clique na zona para a qual quer atualizar o conjunto de registos de recursos.

  3. Na página