Adicione, atualize e elimine registos

Consola

1. Na Trusted 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://www.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 de recursos, 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
}

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...

Consola

1. Na Trusted 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://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONErrsets

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

Consola

1. Na Trusted 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://www.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.

Consola

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

1. Na Trusted 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 Detalhes da zona, junto ao conjunto de registos de recursos que quer atualizar, clique em editEditar.

4. Depois de fazer as atualizações necessárias, clique em Guardar.

gcloud

Para aplicar uma atualização parcial a um conjunto de registos de recursos existente, use o comando gcloud dns record-sets update:

gcloud dns record-sets update 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 aplicar uma atualização parcial a um conjunto de registos de recursos existente, use o método resourceRecordSets.patch:

PATCH https://www.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets/RRSET_NAME/RRSET_TYPE
{
  "ttl": TTL,
  "rrdatas": RR_DATA,
  "update_mask": {
      "paths": ["rrset.ttl", "rrset.rrdatas"]
  }
}

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 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...

Consola

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

   Aceda às zonas do Cloud DNS

   Os registos da zona são apresentados na página Detalhes da zona.

2. Para eliminar conjuntos de registos de recursos numa zona, clique no nome da zona.

3. Junto aos conjuntos de registos de recursos que quer eliminar, selecione a caixa de verificação.

4. Clique em Eliminar conjuntos de registos.

gcloud

Para eliminar um conjunto de registos de recursos existente, use o comando gcloud dns record-sets delete:

gcloud dns record-sets delete 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 eliminar um conjunto de registos de recursos existente, use o método resourceRecordSets.delete:

DELETE https://www.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 de recurso deste conjunto de registos de recursos, por exemplo, A.

gcloud

1. Para importar um conjunto de registos de recursos, use o comando dns record-sets import:

   gcloud dns record-sets import -z=ZONE_NAME
   

   Se quiser especificar o formato de ficheiro do ficheiro de zona, use o comando anterior com a flag --zone-file-format. Se omitir a flag, tem de fornecer um ficheiro de zona no formato YAML.

   Substitua ZONE_NAME por um novo nome para a sua zona.

   • Quando usa o comando gcloud dns record-sets import com a flag --replace-origin-ns, substitui os registos NS da zona pelos registos NS especificados no ficheiro de zona. Estes registos têm de corresponder aos servidores de nomes atribuídos pelo Cloud DNS para alojar a zona. Também têm de corresponder aos registos NS especificados na zona principal (de delegação). Por predefinição, o Cloud DNS não substitui os registos NS. Se usar esta flag, tem de verificar se os registos NS estão corretos.

   • Quando importa conjuntos de registos como um ficheiro formatado de zona BIND, remova o sinal de arroba (@) que indica o vértice da zona. No ficheiro formatado em zona BIND, para um nome DNS como example.com, o símbolo arroba (@) refere-se a example.com.. No entanto, no Cloud DNS, o símbolo arroba (@) é tratado literalmente quando define nomes de registos. Para criar um conjunto de registos de recursos para o vértice da zona no Cloud DNS, use o nome de domínio completo. Por exemplo, example.com..

     in.smtp              IN MX 5 gmail-smtp-in.l.google.com
     in.smtp.example.com. IN MX 5 gmail-smtp-in.l.google.com.example.com.
     

     Para importar os seus ficheiros de zona, adicione um ponto final (.) no final de todos os nomes de domínios que têm de ser totalmente qualificados.

2. Para exportar um conjunto de registos de recursos, use o comando dns record-sets export. Para especificar que os conjuntos de registos de recursos são exportados para um ficheiro formatado em zona BIND, use a flag --zone-file-format. Por exemplo:

   example.com. 21600 IN NS ns-gcp-private.googledomains.com.
   example.com. 21600 IN SOA ns-gcp-private.googledomains.com.
   cloud-dns-hostmaster.google.com. 1 21600 3600 259200 300
   host1.example.com. 300 IN A 192.0.2.91
   

   Se omitir a flag --zone-file-format, export exporta o conjunto de registos de recursos para um ficheiro de registos formatado em YAML:

   gcloud dns record-sets export example.zone -z=examplezonename
   

   Por exemplo:

   ---
   kind: dns#resourceRecordSet
   name: example.com.
   rrdatas:
   - ns-gcp-private.googledomains.com.
   ttl: 21600
   type: NS
   ---
   kind: dns#resourceRecordSet
   name: example.com.
   rrdatas:
   - ns-gcp-private.googledomains.com. cloud-dns-hostmaster.google.com. 1 21600 3600 259200 300
   ttl: 21600
   type: SOA
   ---
   kind: dns#resourceRecordSet
   name: host1.example.com.
   rrdatas:
   - 192.0.2.91
   ttl: 300
   type: A
   
   

   O Cloud DNS suporta o tipo de registo ALIAS, que não é um tipo de registo DNS padrão e não é suportado no BIND. Se estiver a exportar conjuntos de registos de recursos para o BIND, os registos ALIAS são ignorados. Se uma zona tiver uma política de encaminhamento, é exportada como um registo com dados de registo de recursos (rrdata) vazios.