Adicionar, atualizar e excluir registros

Nesta página, descrevemos como adicionar, atualizar e excluir conjuntos de registros de recursos.

Para conferir a lista de tipos de registros de recursos compatíveis, consulte Visão geral dos registros DNS.

Antes de começar

É necessário ter ou criar uma zona gerenciada antes de criar um conjunto de registros de recursos. Para detalhes sobre como criar uma zona gerenciada, em que é possível criar o conjunto de registros de recursos, consulte Criar uma zona gerenciada.

Adicionar um conjunto de registros de recursos

Para adicionar um conjunto de registros de recursos, siga estas etapas:

Console

  1. No console do Google Cloud , acesse a página Zonas do Cloud DNS.

    Acessar Zonas do Cloud DNS

  2. Clique no nome da zona gerenciada a que você quer adicionar o registro.

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

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

    Para criar um registro DNS curinga, insira um asterisco, por exemplo, *.example.com.

    O símbolo @ não cria um registro de vértice automaticamente. Para criar um registro de recurso na raiz do domínio, deixe o campo Nome do DNS em branco.

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

  6. No campo TTL, insira um valor numérico para o time to live (TTL) do registro de recursos, que é o tempo que ele pode ser armazenado em cache. Esse valor precisa ser um número inteiro positivo.

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

  8. Dependendo do tipo de registro de recurso selecionado, preencha os campos restantes.

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

  10. Clique em Criar.

gcloud

Para adicionar um conjunto de registros 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:

  • RRSET_NAME: o nome de DNS que corresponde às consultas recebidas com o nome DNS desta zona como seu sufixo, por exemplo, test.example.com;
  • RR_DATA: um valor arbitrário associado ao conjunto de registros de recursos, por exemplo, 198.51.100.5. Você também pode inserir 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 esse conjunto de registros de recursos. Por exemplo, 30
  • RRSET_TYPE: o tipo de registro de recurso desse conjunto de registros de recursos, por exemplo, A
  • MANAGED_ZONE: a zona gerenciada a que esse conjunto de registros de recursos está afiliado. Por exemplo, my-zone-name. O nome desse conjunto de registros de recursos precisa ter o nome de DNS da zona gerenciada como seu sufixo

API

Para adicionar um conjunto de registros 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:

  • PROJECT_ID: o ID do projeto
  • MANAGED_ZONE: a zona gerenciada a que esse conjunto de registros de recursos está afiliado. Por exemplo, my-zone-name. O nome desse conjunto de registros de recursos precisa ter o nome de DNS da zona gerenciada como seu sufixo
  • RRSET_NAME: o nome de DNS que corresponde às consultas recebidas com o nome DNS desta zona como seu sufixo, por exemplo, test.example.com;
  • RRSET_TYPE: o tipo de registro de recurso desse conjunto de registros de recursos, por exemplo, A
  • TTL: o TTL em segundos que o resolvedor armazena em cache esse conjunto de registros de recursos. Por exemplo, 30
  • RR_DATA: um valor arbitrário associado ao conjunto de registros de recursos, por exemplo, "198.51.100.5". Também é possível inserir vários valores em uma 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
}

Adicionar uma coleção de conjuntos de registros de recursos em uma transação

É possível adicionar vários conjuntos de registros de recursos criando uma transação que especifique as mudanças. Uma transação é um grupo de uma ou mais mudanças de registro DNS que precisam ser aplicadas como uma unidade. A transação inteira é bem-sucedida ou falha, garantindo que seus dados nunca fiquem em um estado inconsistente. É possível criar uma transação apenas usando a CLI gcloud ou a API Cloud DNS.

Para criar uma transação, siga estas etapas:

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 gerenciada com os conjuntos de registros de recursos que você quer gerenciar, por exemplo, my-zone-name.

  2. Para adicionar um conjunto de registros 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:

    • RR_DATA: um valor arbitrário associado ao conjunto de registros de recursos, por exemplo, 198.51.100.5. Também é possível inserir vários valores, rrdata1 rrdata2 rrdata3, por exemplo, 198.51.100.5 10.2.3.4...
    • DNS_NAME: o DNS ou nome de domínio do conjunto de registros a ser adicionado. Por exemplo, test.example.com
    • TTL: o tempo de vida (TTL) do conjunto de registros em número de segundos, por exemplo, 300
    • RECORD_TYPE: o tipo de registro. Por exemplo, A
    • MANAGED_ZONE: o nome da zona gerenciada com os conjuntos de registros de recursos que você quer gerenciar. 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 curinga, 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:

    • MANAGED_ZONE: o nome da zona gerenciada com os conjuntos de registros de recursos que você quer gerenciar. Por exemplo, my-zone-name
    • WILDCARD_DNS_NAME: o DNS ou nome de domínio do conjunto de registros de recursos que você quer adicionar, por exemplo, *.example.com. (observe o ponto final)
    • RECORD_TYPE: o tipo de registro. Por exemplo, CNAME
    • TTL: o TTL do conjunto de registros em número de segundos. Por exemplo, 300

API

Para criar uma transação com novos conjuntos de registros 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:

  • PROJECT_ID: ID do projeto
  • MANAGED_ZONE: o nome ou ID da zona gerenciada
  • DNS_NAME: o DNS ou nome de domínio do conjunto de registros, por exemplo, test.example.com. (observe o ponto final)
  • RECORD_TYPE: o tipo de registro
  • TTL: o tempo de vida (TTL, na sigla em inglês) do conjunto de registros em número de segundos. Por exemplo, 30
  • RR_DATA: um valor arbitrário associado ao conjunto de registros de recursos, por exemplo, 198.51.100.5. Você também pode inserir vários valores, rrdata1 rrdata2 rrdata3, por exemplo, 198.51.100.5 10.2.3.4...

Para entregar e-mails no seu domínio, adicione registros MX à sua zona. Se você usa o Google Workspace como provedor do Simple Mail Transfer Protocol (SMTP), consulte a página de suporte Configurar registros MX do Google Workspace. Caso contrário, use os detalhes do registro MX do seu provedor e siga o processo de configuração descrito para o Google Workspace.

Conferir conjuntos de registros de recursos de uma zona

Para conferir os conjuntos de registros de recursos de uma zona, siga estas etapas:

Console

  1. No console do Google Cloud , acesse a página Cloud DNS.

    Acessar Cloud DNS

  2. Na guia Zonas, clique na zona em que você quer visualizar os conjuntos de registros de recursos.

    A página Detalhes da zona mostra os detalhes de todos os conjuntos de registros de recursos dessa zona.

gcloud

Para conferir os registros 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 de DNS no projeto:

O comando gera a resposta JSON para o conjunto de registros de recursos dos primeiros 100 registros. Você pode especificar estes parâmetros adicionais:

  • --limit: número máximo de conjuntos de registros a serem listados
  • --name: lista apenas conjuntos de registros de recursos com este nome de domínio exato
  • --type: lista apenas registros desse tipo. Se presente, o parâmetro --name também deve estar presente

API

Para conferir os registros 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:

  • PROJECT_ID: o ID do projeto
  • MANAGED_ZONE: a zona gerenciada a que esse conjunto de registros de recursos está afiliado. Por exemplo, my-zone-name. O nome desse conjunto de registros de recursos precisa ter o nome de DNS da zona gerenciada como seu sufixo

Visualizar detalhes de um conjunto de registros de recurso

Para este procedimento, presumimos que você já tenha criado um conjunto de registros de recurso na zona de DNS gerenciada do Cloud DNS.

Para visualizar os detalhes de um conjunto de registros de recursos existentes, siga estas etapas:

Console

  1. No console do Google Cloud , acesse a página Zonas do Cloud DNS.

    Acessar a página Zonas do Cloud DNS

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

  3. Clique no conjunto de registros de recursos para ver os detalhes.

    A página Detalhes do conjunto de registros de recurso mostra os detalhes do conjunto de registros de recurso.

gcloud

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

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

Substitua:

  • RRSET_NAME: o nome de DNS que corresponde às consultas recebidas com o nome DNS desta zona como seu sufixo, por exemplo, test.example.com;
  • RRSET_TYPE: o tipo de registro de recurso desse conjunto de registros de recursos, por exemplo, A
  • MANAGED_ZONE: a zona gerenciada a que esse conjunto de registros de recursos está afiliado. Por exemplo, my-zone-name. O nome desse conjunto de registros de recursos precisa ter o nome de DNS da zona gerenciada como seu sufixo

API

Para ver os detalhes de um conjunto de registros de recursos, 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:

  • PROJECT_ID: o ID do projeto
  • MANAGED_ZONE: a zona gerenciada a que esse conjunto de registros de recursos está afiliado. Por exemplo, my-zone-name. O nome desse conjunto de registros de recursos precisa ter o nome de DNS da zona gerenciada como seu sufixo
  • RRSET_NAME: o nome de DNS que corresponde às consultas recebidas com o nome DNS desta zona como seu sufixo, por exemplo, test.example.com;
  • RRSET_TYPE: o tipo de registro desse conjunto de registros de recursos, por exemplo, A.