Nesta página, descrevemos como adicionar, atualizar, alterar e excluir conjuntos de registros de recursos.
Para ver a lista de tipos de registro de recurso compatíveis, consulte Visão geral dos registros DNS.
Antes de começar
É preciso 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 seu 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
No console do Google Cloud , acesse a página Zonas do Cloud DNS.
Clique no nome da zona gerenciada a que você quer adicionar o registro.
Na página Detalhes da zona, clique em Adicionar padrão.
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 sinal de arroba (@) não cria automaticamente um registro de ápice. Para criar um registro de recurso na raiz do domínio, deixe o campo Nome do DNS em branco.
Selecione o Tipo de registro de recurso, por exemplo,
MX.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.
No menu Unidade TTL, selecione a unidade de tempo. Por exemplo,
minutes.Dependendo do tipo de registro de recurso selecionado, preencha os campos restantes.
Para inserir informações adicionais, clique em Adicionar item.
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,rrdata1rrdata2rrdata3, por exemplo,198.51.100.510.2.3.4...TTL: o TTL em segundos que o resolvedor armazena em cache esse conjunto de registros de recursos. Por exemplo,30RRSET_TYPE: o tipo de registro de recurso desse conjunto de registros de recursos, por exemplo,AMANAGED_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 projetoMANAGED_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 sufixoRRSET_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,ATTL: o TTL em segundos que o resolvedor armazena em cache esse conjunto de registros de recursos. Por exemplo,30RR_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
Adicionar um novo tipo de registro a um domínio com um registro atual
Se você quiser adicionar um novo tipo de registro a um nome de domínio que já tem um
registro, por exemplo, adicionar um registro TXT de verificação de domínio a
um domínio que já tem um registro A, não edite o registro A atual
nem mude o Tipo de registro de recurso para TXT. A alteração do tipo de registro
substitui o registro A atual.
Quando você altera os registros DNS de um domínio ou subdomínio, dois tipos de registro
diferentes (como um registro A e um registro TXT) podem coexistir no mesmo nome de DNS
como conjuntos de registros de recursos separados. A única exceção é um registro CNAME,
que precisa sempre existir por conta própria e não pode compartilhar o mesmo nome DNS com nenhum
outro tipo de registro.
Para adicionar um novo tipo de registro a um domínio com um registro, siga estas etapas:
Console
No console do Google Cloud , acesse a página Zonas do Cloud DNS.
Clique na zona em que você quer adicionar o registro.
Na página Detalhes da zona, clique em Adicionar padrão para criar um conjunto de registros
TXTseparado com o mesmo Nome do DNS para que os dois registros coexistam.Se já houver um conjunto de registros
TXTpara esse nome, clique em editEditar ao lado do conjunto de registrosTXTatual e clique em Adicionar item para adicionar o novo valor.
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 alterações. Uma transação é um grupo de uma ou mais alterações 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. Só é possível criar uma transação usando a CLI gcloud ou a API Cloud DNS.
Para criar uma transação, siga estas etapas:
gcloud
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_ZONEpelo nome da zona gerenciada com os conjuntos de registros de recursos que você quer gerenciar. Por exemplo,my-zone-name.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,rrdata1rrdata2rrdata3, por exemplo,198.51.100.510.2.3.4...DNS_NAME: o DNS ou nome de domínio do conjunto de registros a ser adicionado. Por exemplo,test.example.comTTL: o tempo de vida (TTL) do conjunto de registros em número de segundos, por exemplo,300RECORD_TYPE: o tipo de registro. Por exemplo,AMANAGED_ZONE: o nome da zona gerenciada com os conjuntos de registros de recursos que você quer gerenciar. Por exemplo,my-zone-name
Para executar a transação, use o comando
gcloud dns record-sets transaction execute:gcloud dns record-sets transaction execute \ --zone=MANAGED_ZONE
Para adicionar uma transação de caractere 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-nameWILDCARD_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,CNAMETTL: 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 projetoMANAGED_ZONE: o nome ou ID da zona gerenciadaDNS_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 registroTTL: o tempo de vida (TTL, na sigla em inglês) do conjunto de registros em número de segundos. Por exemplo,30RR_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,rrdata1rrdata2rrdata3, por exemplo,198.51.100.510.2.3.4...
Para entregar e-mails ao seu domínio, adicione registros MX à sua zona. Se você
usa o Google Workspace como seu provedor de protocolo 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.
Ver conjuntos de registros de recursos de uma zona
Para ver os conjuntos de registros de recursos de uma zona, siga estas etapas:
Console
No console do Google Cloud , acesse a página Cloud DNS.
Na guia Zonas, clique na zona em que você quer ver 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 ver os registros DNS da 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: listar apenas conjuntos de registros de recursos com esse nome de domínio exato--type: lista apenas registros desse tipo. Se presente, o parâmetro--nametambém deve estar presente
API
Para ver 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 projetoMANAGED_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
No console do Google Cloud , acesse a página Zonas do Cloud DNS.
Clique na zona que contém o conjunto de registros de recursos.
Clique no conjunto de registros de recursos com os detalhes que você quer ver.
A página Detalhes do conjunto de registros de recursos mostra os detalhes do conjunto de registros de recursos.
gcloud
Para visualizar os detalhes de um conjunto de registros de recursos existentes, 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,AMANAGED_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 projetoMANAGED_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 sufixoRRSET_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.
Atualizar um conjunto de registros de recursos
Para modificar um conjunto de registros, siga estas etapas:
Console
Para aplicar uma atualização parcial a um conjunto de registros de recursos existente, siga estas etapas:
No console do Google Cloud , acesse a página Zonas do Cloud DNS.
Clique na zona em que você quer atualizar o conjunto de registros de recursos.
Na página Detalhes da zona, ao lado do conjunto de registros de recursos que você quer atualizar, clique em editEditar.
Depois de fazer as atualizações necessárias, clique em Salvar.
gcloud
Para aplicar uma atualização parcial a um conjunto de registros de recursos, 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:
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,rrdata1rrdata2rrdata3, por exemplo,198.51.100.510.2.3.4...TTL: o TTL em segundos que o resolvedor armazena em cache esse conjunto de registros de recursos. Por exemplo,30RRSET_TYPE: o tipo de registro de recurso desse conjunto de registros de recursos, por exemplo,AMANAGED_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 aplicar uma atualização parcial a um conjunto de registros de recursos, use o método resourceRecordSets.patch:
PATCH https://dns.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:
PROJECT_ID: o ID do projetoMANAGED_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 sufixoRRSET_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,ATTL: o TTL em segundos que o resolvedor armazena em cache esse conjunto de registros de recursos. Por exemplo,30RR_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,rrdata1rrdata2rrdata3, por exemplo,198.51.100.510.2.3.4...
Excluir conjuntos de registros de recursos
Quando você exclui conjuntos de registros de recursos, os registros DNS deles são removidos permanentemente e não podem ser recuperados. Para evitar a perda dos registros DNS, exporte os conjuntos de registros de recursos antes da exclusão. Para informações sobre como exportar conjuntos de registros de recursos, consulte Importar e exportar conjuntos de registros de recursos.
O Cloud DNS cria automaticamente registros NS e SOA no ápice
da zona. Esses registros não podem ser excluídos usando a API Cloud DNS
e são excluídos automaticamente quando a zona é excluída. Para mais informações,
consulte RFC 1034.
Para excluir conjuntos de registros de recursos, siga estas etapas:
Console
No console do Google Cloud , acesse a página Cloud DNS.
Acessar a página Zonas do Cloud DNS
Os registros da zona são listados na página Detalhes da zona.
Para excluir conjuntos de registros de recursos em uma zona, clique no nome dela.
Marque a caixa de seleção ao lado dos conjuntos de registros de recursos que você quer excluir.
Clique em Excluir conjuntos de registros.
gcloud
Para excluir um conjunto de registros de recursos, use o
comando gcloud dns record-sets delete:
gcloud dns record-sets delete 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,AMANAGED_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 excluir um conjunto de registros de recursos, use o método resourceRecordSets.delete:
DELETE https://dns.googleapis.com/dns/v1/projects/PROJECT_ID/managedZones/MANAGED_ZONE/rrsets/RRSET_NAME/RRSET_TYPE
Substitua:
PROJECT_ID: o ID do projetoMANAGED_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 sufixoRRSET_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
Importar e exportar conjuntos de registros de recursos
Para copiar conjuntos de registros de recursos para dentro e fora de uma zona gerenciada, use os comandos import e export. É possível importar e exportar para o formato de arquivo de zona BIND ou para o formato de arquivo YAML.
gcloud
Para importar um conjunto de registros de recursos, use o comando
dns record-sets import:gcloud dns record-sets import -z=ZONE_NAME
Se você quiser especificar o formato do arquivo de zona, use o comando anterior com a flag
--zone-file-format. Se você omitir a sinalização, será necessário fornecer um arquivo de zona no formato YAML.Substitua
ZONE_NAMEpor um novo nome para a zona.Quando você usa o comando
gcloud dns record-sets importcom a flag--replace-origin-ns, ele substitui os registros NS da zona pelos registros NS especificados no arquivo de zona. Esses registros precisam corresponder aos servidores de nomes atribuídos pelo Cloud DNS para hospedar a zona. Eles também precisam corresponder aos registrosNSespecificados na zona pai (de delegação). Por padrão, o Cloud DNS não substitui registrosNS. Se você usar essa flag, verifique se os registrosNSestão corretos.Ao importar conjuntos de registros como um arquivo formatado por zona BIND, remova o sinal de arroba (@) que indica o ápice da zona. No arquivo formatado por zona do BIND, para um nome de DNS como
example.com, o sinal de arroba (@) se refere aexample.com.. No entanto, no Cloud DNS, o arroba (@) é tratado literalmente ao definir nomes de registro. 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 os arquivos de zona, adicione um ponto final (
.) ao final de todos os nomes de domínio que precisam ser totalmente qualificados.
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 formatado por zona BIND, use a flag--zone-file-format. 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 a flag
--zone-file-format, oexportvai exportar o conjunto de registros de recursos para um arquivo de registros formatado em YAML:gcloud dns record-sets export example.zone -z=examplezonename
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: AO 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 oBIND. Se você estiver exportando conjuntos de registros de recursos paraBIND, os registrosALIASserão ignorados. Se uma zona tiver uma política de roteamento, ela será exportada como um registro com dados de registro de recurso (rrdata) vazios.
A seguir
- Para informações sobre os comandos
gcloudpara conjuntos de registros de recursos, consultegcloud dns record-sets. - Para verificar o status das operações
gcloudou da API, consulte Monitorar a propagação de DNS. - Para encontrar soluções para problemas comuns que podem acontecer ao usar o Cloud DNS, consulte Solução de problemas.
- Para uma visão geral do Cloud DNS, consulte Visão geral do Cloud DNS.