Adicionar, atualizar e excluir registros,Adicionar, atualizar e excluir registros,Adicionar, atualizar e excluir registros,Adicionar, atualizar e excluir registros

Console

1. No Google Cloud console, acesse a página Zonas de DNS na nuvem .

   Ir para zonas DNS na nuvem

2. Clique no nome da zona gerenciada à qual você deseja 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 DNS , insira o subdomínio da zona DNS — por exemplo, mail . O ponto final é adicionado automaticamente ao final.

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

   O símbolo de arroba (@) não cria automaticamente um registro apex. Para criar um registro de recurso no apex do domínio, deixe o campo de nome 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 tempo de vida do registro de recurso, que é o tempo durante o qual ele pode ser armazenado em cache. Este valor deve ser um número inteiro positivo.

7. No menu da 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 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 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 este conjunto de registros de recursos — por exemplo, 30
• RRSET_TYPE : o tipo de registro de recurso deste conjunto de registros de recurso — por exemplo, A .
• MANAGED_ZONE : a zona gerenciada à qual este conjunto de registros de recursos está afiliado — por exemplo, my-zone-name ; o nome deste conjunto de registros de recursos deve ter o nome DNS da zona gerenciada como seu sufixo

API

Para adicionar um conjunto de registros 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 gerenciada à qual este conjunto de registros de recursos está afiliado — por exemplo, my-zone-name ; o nome deste conjunto de registros de recursos deve ter o nome DNS da zona gerenciada como seu 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 registro de recurso deste conjunto de registros de recurso — por exemplo, A
• TTL : o TTL em segundos que o resolvedor armazena em cache este 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" ; você também pode 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
}

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 cujos conjuntos de registros de recursos você deseja 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 o seguinte:

   • 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 ...
   • 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) para o 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 cujos conjuntos de registros de recursos você deseja 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 o seguinte:

   • MANAGED_ZONE : o nome da zona gerenciada cujos conjuntos de registros de recursos você deseja gerenciar — por exemplo, my-zone-name
   • WILDCARD_DNS_NAME : o DNS ou nome de domínio do conjunto de registros de recursos que você deseja adicionar — por exemplo, *.example.com. (observe o ponto final)
   • RECORD_TYPE : o tipo de registro — por exemplo, CNAME .
   • TTL : o TTL para o 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 o seguinte:

• PROJECT_ID : seu ID de projeto
• MANAGED_ZONE : seu nome ou ID de 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) para o 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 ...

Console

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

   Ir para Cloud DNS

2. Na guia Zonas , clique na zona para a qual você deseja visualizar os conjuntos de registros de recursos.

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

gcloud

Para visualizar 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 DNS no seu projeto.

O comando gera a resposta JSON para o conjunto de registros de recursos referente aos 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 deste tipo; se presente, o parâmetro --name também deve estar presente

API

Para visualizar os registros 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 gerenciada à qual este conjunto de registros de recursos está afiliado — por exemplo, my-zone-name ; o nome deste conjunto de registros de recursos deve ter o nome DNS da zona gerenciada como seu sufixo

Console

1. No Google Cloud console, acesse a página Zonas de DNS na nuvem .

   Ir para zonas DNS na nuvem

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

3. Clique no conjunto de registros de recursos cujos detalhes você deseja visualizar.

   A página Detalhes do conjunto de registros de recursos exibe os detalhes do conjunto de registros de recursos.

gcloud

Para visualizar os detalhes de um conjunto de registros 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 registro de recurso deste conjunto de registros de recurso — por exemplo, A .
• MANAGED_ZONE : a zona gerenciada à qual este conjunto de registros de recursos está afiliado — por exemplo, my-zone-name ; o nome deste conjunto de registros de recursos deve ter o nome DNS da zona gerenciada como seu sufixo

API

Para obter os detalhes de um conjunto de registros 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 gerenciada à qual este conjunto de registros de recursos está afiliado — por exemplo, my-zone-name ; o nome deste conjunto de registros de recursos deve ter o nome DNS da zona gerenciada como seu 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 registro deste conjunto de registros de recursos — por exemplo, A .

Console

Para aplicar uma atualização parcial a um conjunto de registros de recursos existente, siga estas etapas:

1. No Google Cloud console, acesse a página Zonas de DNS na nuvem .

   Ir para zonas DNS na nuvem

2. Clique na zona para a qual você deseja atualizar o conjunto de registros de recursos.

3. Na página Detalhes da zona , ao lado do conjunto de registros de recursos que você deseja atualizar, clique em edit .

4. Após fazer as atualizações necessárias, clique em Salvar .

gcloud

Para aplicar uma atualização parcial a um conjunto de registros 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 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 este conjunto de registros de recursos — por exemplo, 30
• RRSET_TYPE : o tipo de registro de recurso deste conjunto de registros de recurso — por exemplo, A .
• MANAGED_ZONE : a zona gerenciada à qual este conjunto de registros de recursos está afiliado — por exemplo, my-zone-name ; o nome deste conjunto de registros de recursos deve ter o nome DNS da zona gerenciada como seu sufixo

API

Para aplicar uma atualização parcial a um conjunto de registros 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 gerenciada à qual este conjunto de registros de recursos está afiliado — por exemplo, my-zone-name ; o nome deste conjunto de registros de recursos deve ter o nome DNS da zona gerenciada como seu 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 registro de recurso deste conjunto de registros de recurso — por exemplo, A .
• TTL : o TTL em segundos que o resolvedor armazena em cache este 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 ; você também pode inserir vários valores, rrdata1 rrdata2 rrdata3 — por exemplo, 198.51.100.5 10.2.3.4 ...

Console

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

   Ir para zonas DNS na nuvem

   Os registros da zona são listados na página Detalhes da zona .

2. Para excluir conjuntos de registros de recursos em uma zona, clique no nome da zona.

3. Ao lado dos conjuntos de registros de recursos que você deseja excluir, marque a caixa de seleção.

4. Clique em Excluir conjuntos de registros .

gcloud

Para excluir um conjunto de registros 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 registro de recurso deste conjunto de registros de recurso — por exemplo, A .
• MANAGED_ZONE : a zona gerenciada à qual este conjunto de registros de recursos está afiliado — por exemplo, my-zone-name ; o nome deste conjunto de registros de recursos deve ter o nome DNS da zona gerenciada como seu sufixo

API

Para excluir um conjunto de registros 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 gerenciada à qual este conjunto de registros de recursos está afiliado — por exemplo, my-zone-name ; o nome deste conjunto de registros de recursos deve ter o nome DNS da zona gerenciada como seu 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 registro de recurso deste conjunto de registros de recurso — por exemplo, A .

gcloud

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

   gcloud dns record-sets import -z=ZONE_NAME
   

   Se quiser especificar o formato do arquivo de zona, use o comando anterior com o sinalizador --zone-file-format . Se omitir o sinalizador, você deverá fornecer um arquivo de zona no formato YAML.

   Substitua ZONE_NAME por um novo nome para sua zona.

   • Ao usar o comando gcloud dns record-sets import com o sinalizador --replace-origin-ns , ele substitui os registros NS da zona pelos registros NS especificados no arquivo de zona. Esses registros devem corresponder aos servidores de nomes atribuídos pelo Cloud DNS para hospedar a zona. Eles também devem corresponder aos registros NS especificados na zona pai (delegante). Por padrão, o Cloud DNS não substitui registros NS . Se você usar esse sinalizador, verifique se os registros NS estão corretos.

   • Ao importar conjuntos de registros como um arquivo no formato de zona BIND, remova o sinal de arroba (@) que indica o ápice da zona. No arquivo no formato de zona BIND, para um nome DNS como example.com , o sinal de arroba (@) refere-se a example.com. No entanto, no Cloud DNS, o sinal de arroba (@) é tratado literalmente ao definir nomes de registros. Para criar um conjunto de registros de recursos para o ápice 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 seus arquivos de zona, adicione um ponto final ( . ) ao final de qualquer nome de domínio que deva ser totalmente qualificado.

2. Para exportar um conjunto de registros de recursos, use o comando dns record-sets export . Para especificar que os conjuntos de registros de recursos sejam exportados para um arquivo com formato de zona BIND, use o sinalizador --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 você omitir o sinalizador --zone-file-format , export exportará o conjunto de registros de recursos para um arquivo de registros no formato 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 é compatível com o tipo de registro ALIAS , que não é um tipo de registro DNS padrão e não é compatível com BIND . Se você estiver exportando conjuntos de registros de recursos para BIND , os registros ALIAS serão ignorados. Se uma zona tiver uma política de roteamento, ela será exportada como um registro com dados de registro de recursos vazios (rrdata).