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
Crie uma zona gerida. Conclua os pré-requisitos para criar uma zona gerida e crie uma zona gerida.
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
Na Trusted Cloud consola, aceda à página Zonas de DNS na nuvem.
Clique no nome da zona gerida à qual quer adicionar o registo.
Na página Detalhes da zona, clique em Adicionar padrão.
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.
Selecione o Tipo de registo de recurso, por exemplo,
MX
.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.
No menu Unidade de TTL, selecione a unidade de tempo, por exemplo,
minutes
.Consoante o tipo de registo de recursos que selecionou, preencha os campos restantes.
Para introduzir informações adicionais, clique em Adicionar item.
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 projetoMANAGED_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 sufixoRRSET_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
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
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
.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
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 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 projetoMANAGED_ZONE
: o nome ou o ID da sua zona geridaDNS_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 registoTTL
: 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
Na Trusted Cloud consola, aceda à página Cloud DNS.
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 projetoMANAGED_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
Na Trusted Cloud consola, aceda à página Zonas de DNS na nuvem.
Clique na zona que contém o conjunto de registos de recursos.
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 projetoMANAGED_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 sufixoRRSET_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:
Na Trusted Cloud consola, aceda à página Zonas de DNS na nuvem.
Clique na zona para a qual quer atualizar o conjunto de registos de recursos.
Na página Detalhes da zona, junto ao conjunto de registos de recursos que quer atualizar, clique em editEditar.
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 projetoMANAGED_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 sufixoRRSET_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
...
Elimine conjuntos de registos de recursos
Quando elimina conjuntos de registos de recursos, os respetivos registos DNS são removidos permanentemente; não é possível recuperá-los. Para evitar perder os seus registos de DNS, exporte os conjuntos de registos de recursos antes da eliminação. Para obter informações sobre como exportar conjuntos de registos de recursos, consulte Importe e exporte conjuntos de registos de recursos.
O Cloud DNS cria automaticamente registos NS
e SOA
no vértice da zona. Não é possível eliminar estes registos através da API Cloud DNS
e são eliminados automaticamente quando a zona é eliminada. Para mais informações,
consulte o RFC 1034.
Para eliminar conjuntos de registos de recursos, siga estes passos:
Consola
Na Trusted Cloud consola, aceda à página Cloud DNS.
Os registos da zona são apresentados na página Detalhes da zona.
Para eliminar conjuntos de registos de recursos numa zona, clique no nome da zona.
Junto aos conjuntos de registos de recursos que quer eliminar, selecione a caixa de verificação.
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 projetoMANAGED_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 sufixoRRSET_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
.
Importe e exporte conjuntos de registos de recursos
Para copiar conjuntos de registos de recursos para dentro e para fora de uma zona gerida, pode usar os comandos import
e export
. Pode importar e exportar para o formato de ficheiro de zona BIND ou o formato de ficheiro YAML.
gcloud
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 registosNS
especificados na zona principal (de delegação). Por predefinição, o Cloud DNS não substitui os registosNS
. Se usar esta flag, tem de verificar se os registosNS
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 aexample.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.
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 noBIND
. Se estiver a exportar conjuntos de registos de recursos para oBIND
, os registosALIAS
são ignorados. Se uma zona tiver uma política de encaminhamento, é exportada como um registo com dados de registo de recursos (rrdata) vazios.
Tipos de registos de recursos suportados
Para o tipo de registo | Enter |
---|---|
A |
O endereço numérico do anfitrião, no formato decimal pontuado IPv4. O tipo de registo
|
AAAA |
O endereço IP numérico do anfitrião, no formato hexadecimal IPv6. O tipo de registo
|
ALIAS (Pré-visualizar) |
O nome canónico a resolver para consultas de endereços recebidas, por exemplo, |
CNAME |
O alias de DNS para um registo
Também pode usar o tipo de registo
Por vezes, um servidor de nomes responde com o registo |
HTTPS , SVCB |
A prioridade do serviço ( |
MX |
Um número de preferência e o nome DNS de um servidor de troca de correio que
recebe emails em nome do seu domínio. Os servidores SMTP preferem servidores com números de preferência mais baixos. Por exemplo: Certifique-se de que existe um espaço entre o número de preferência e o nome DNS. O registo MX que introduzir tem de terminar com um ponto final ou
ponto ( Pode criar vários registos com prioridades diferentes para configurar servidores de correio de cópia de segurança ou usar a mesma prioridade para distribuir a carga por vários servidores de correio. Por exemplo, para encaminhar o seu email para a sua conta do Google Workspace, introduza o seguinte:
|
NS |
O nome DNS do servidor de nomes oficial que fornece serviços DNS
para o seu domínio ou subdomínio. Os seus registos |
SPF |
O tipo de conjunto de registos de recursos |
SRV |
Os dados que especificam a localização, ou seja, o nome do anfitrião e o número da porta, dos servidores para um serviço específico, por exemplo, Para mais informações, consulte o RFC 2782. |
SSHFP |
O número do algoritmo do servidor SSH, o número do tipo de impressão digital e a impressão digital da chave, por exemplo, Use este tipo de registo apenas se tiver ativado as DNSSEC para esta zona. |
TXT |
Dados de texto, que podem conter texto arbitrário e também podem ser usados para definir dados legíveis por máquina, como informações de segurança ou prevenção de abusos.
Um registo TXT pode conter uma ou mais strings de texto; o comprimento máximo de cada string é de 255 carateres. Se os dados do registo tiverem mais de 255 bytes, divida o registo em strings de 255 bytes e coloque cada string entre aspas, por exemplo, Os agentes de correio e outros agentes de software concatenam várias strings. Inclua cada string entre aspas, por exemplo, Cada registo TXT tem um limite de 1000 carateres. Se precisar de aumentar este limite, contacte o Trusted Cloud by S3NS apoio técnico. |
O que se segue?
- Para obter informações sobre os comandos
gcloud
para conjuntos de registos de recursos, consulte o artigogcloud dns record-sets
. - Para verificar o estado das operações da
gcloud
ou da API, consulte o artigo Monitorize a propagação do DNS. - Para encontrar soluções para problemas comuns que pode encontrar ao usar o Cloud DNS, consulte a secção Resolução de problemas.
- Para obter uma vista geral do Cloud DNS, consulte o artigo Vista geral do Cloud DNS.