IBM Cloud Docs
Gerenciando registros de DNS

Gerenciando registros de DNS

Os registros de DNS fazem a conexão entre nomes legíveis e endereços IP. Abordaremos como gerenciar registros de DNS nas seções a seguir. Gerencie registros DNS usando a interface do usuário, a CLI ou a API.

Adição de registros DNS no console

  1. Na tabela de zonas de DNS, clique no nome da zona na qual você deseja incluir registros. Aparecem mais detalhes sobre a zona selecionada.
  2. Clique em Incluir registro para exibir um painel no qual é possível criar um registro.

É possível usar o menu Tipo para selecionar o tipo de registro que você deseja criar. Cada tipo de registro de DNS tem um Nome e um Tempo de Vida (TTL) associado a ele.

Quando você inserir um nome no campo Nome, um nome de domínio será anexado automaticamente, se você não incluiu um manualmente. Por exemplo, se você digitar www ou www.example.com no campo Nome, a API manipulará ambas as entradas como www.example.com. Se você inserir o nome de domínio exato no campo de nome, ele não será anexado a si mesmo (por exemplo, example.com será manipulado como example.com). No entanto, a lista de registros de DNS mostra apenas os nomes, sem o nome de domínio incluído. Como resultado, www.example.com é exibido como www e example.com como example.com.

O valor TTL mínimo suportado é 1 min e o máximo é 12 hours. O valor padrão de TTL é 15 min, mas os usuários podem mudá-lo.

Adicione um registro do tipo A no console

Para incluir esse tipo de registro, valores válidos deverão existir nos campos Nome e Endereço IPv4. Especifique um valor de TTL no menu de listagem, com um valor padrão de 15 min.

Campos obrigatórios

  • Nome
  • Endereço IPv4
  • TTL (o valor padrão é 15 min)

Adicione um registro do tipo AAAA no console

Para incluir esse tipo de registro, valores válidos deverão existir nos campos Nome e Endereço IPv6. Especifique um valor de TTL no menu de listagem, com um valor padrão de 15 min.

Campos obrigatórios

  • Nome
  • Endereço IPv6
  • TTL (o valor padrão é 15 min)

Adicione um registro do tipo CNAME no console

Para incluir esse tipo de registro, um valor válido deve existir no campo Nome e um nome completo do domínio deve estar no campo Destino (FQDN). Um TTL também pode ser especificado no menu de listagem, com o valor padrão de 15 min.

Campos obrigatórios

  • Nome
  • Destino (para CNAME)
  • TTL (o valor padrão é 15 min)

Adicione um registro do tipo MX no console

Para incluir esse tipo de registro, um valor válido deve existir no campo Nome, um nome completo do domínio deve estar no campo Servidor de e-mail (FQDN) e um número válido deve existir no campo Prioridade. Especifique um valor de TTL no menu de listagem, com um valor padrão de 15 min.

Campos obrigatórios

  • Nome
  • Servidor de Correio
  • TTL (o valor padrão é 15 min)
  • Prioridade (o valor padrão é 1)

Adicione um registro do tipo PTR no console

Para incluir esse tipo de registro, deve-se ter um registro A ou AAAA existente que ainda não esteja associado a outro registro de PTR. Selecione um registro existente no menu de listagem. Especifique um valor de TTL no menu de listagem, com um valor padrão de 15 min.

Campos obrigatórios

  • Selecione o registro existente
  • TTL (o valor padrão é 15 min)

Adicione um registro do tipo SRV no console

Para incluir esse tipo de registro, deverão existir valores válidos nos campos Nome, Nome do serviço e Destino. Use o menu de listagem para selecionar um protocolo, que é padronizado com o protocolo UDP. Além disso, é possível especificar Prioridade, Peso e Porta. Esses três campos padrão para um valor de 1. Especifique um valor de TTL no menu de listagem, com um valor padrão de 15 min.

Campos obrigatórios

  • Nome
  • Nome do Serviço
  • Target
  • TTL (o valor padrão é 15 min)
  • Protocolo (o valor padrão é UDP)
  • Prioridade (o valor padrão é 1)
  • Peso (o valor padrão é 1)
  • Porta (o valor padrão é 1)

Adicione um registro do tipo TXT no console

Para incluir esse tipo de registro, valores válidos deverão existir nos campos Nome e Conteúdo. Especifique um valor de TTL no menu de listagem, com um valor padrão de 15 min.

Por razões de segurança e privacidade, recomenda-se não usar registros de tipo TXT para dados sensíveis e confidenciais.

Campos obrigatórios

  • Nome
  • Conteúdo
  • TTL (o valor padrão é 15 min)

Atualizar registros DNS no console

Em cada linha de registro, clique no ícone Editar para abrir um painel no qual é possível atualizar o registro.

Excluir registros DNS no console

Em cada linha de registro, clique no ícone Excluir para abrir um painel no qual é possível confirmar o processo de exclusão.

Importar registros de recursos no console

Para importar registros de recursos, realize as etapas a seguir:

  1. A partir da sua instância dos Serviços DNS, selecione a zona para a qual você deseja importar registros

  2. Clique em Selecionar ação de registro na seção de detalhes da zona e escolha Registros de importação

  3. Arraste e solte o arquivo de importação no painel que aparece, ou clique no link para fazer o upload a partir do seu computador

    Os arquivos de importação devem estar em formato de texto simples e não podem exceder 8 MB

  4. Clique em Registros de importação

Seu arquivo de importação deve seguir este formato de amostra:.

www.test.com.  900 IN  A   127.0.0.1
www.test.com.  900 IN  AAAA    ::1
w3.test.com.   900 IN  CNAME   mydomain.com.
www.test.com.  900 IN  MX  1 mail.example.com.
_service._tcp.www.sample.com.   900 IN  SRV 1 1 1 mydomain.com.
www.test.com.  900 IN  TXT "my content"

Após os registros serem importados, revise os detalhes do status de importação, incluindo o número de arquivos transferidos com sucesso por upload e quais registros não puderam ser transferidos. Se for necessário fazer o upload de arquivos adicionais, clique em Fazer upload de mais arquivos e repita as etapas de importação. Clique no ícone X na parte superior direita do painel para fechar o painel de importação.

Exportar registros de recursos no console

Para exportar registros de recursos, realize as etapas a seguir:

  1. A partir da sua instância de Serviços DNS, selecione a zona a partir da qual deseja exportar registros
  2. Clique em Selecionar ação de registro na seção de detalhes da zona e escolha Registros de exportação
  3. Insira um nome para seu arquivo exportado ou aceite o nome padrão de records.txt
  4. Clique em Download

O arquivo exportado é transferido por download para o local de download padrão especificado por seu navegador.

Gerenciamento de recondicionamentos de DNS na CLI

Primeiramente, use o comando ibmcloud dns instance-target para configurar a instância operacional do DNS Services de destino.

$ ibmcloud dns instances
Retrieving service instances for service 'dns-svcs' ...
OK

Name                 ID                                     Location   State    Service Name
DNS Services-km      ffffffff-b042-41fd-885e-000000000000   global     active   dns-svcs

$ ibmcloud dns instance-target "DNS Services-km"

Armazene o ID de zona em uma variável para que seja possível usá-lo nos comandos a seguir sem precisar sempre digitá-lo. Por exemplo, para armazenar o ID de zona em uma variável, execute este comando:

DNS_ZONE_ID="example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae"

Crie um registro de recurso do tipo ' A na CLI

Use o comando ibmcloud dns resource-record-create com a opção --type A para criar um registro de recurso do tipo A. O --name e o --ipv4 são as opções obrigatórias.

$ ibmcloud dns resource-record-create $DNS_ZONE_ID --type A --name www --ipv4 192.168.1.100
Creating resource record in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID            A:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6
Name          www.example.com
Type          A
Created On    2020-04-10 09:12:07.858707275 +0000 UTC
Modified On   2020-04-10 09:12:07.858707275 +0000 UTC
TTL           900
Data
    ip        192.168.1.100

Criar um registro de recurso do tipo "SRV" na CLI

Use o comando ibmcloud dns resource-record-create com a opção --type SRV para criar um registro de recurso do tipo SRV. O --name, --service, --protocol e --target são as opções obrigatórias.

$ ibmcloud dns resource-record-create $DNS_ZONE_ID --type SRV --name video --service _sip --protocol tcp --priority 10 --weight 10 --port 953 --target media.example.com
Creating resource record in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID             SRV:c7c8938b-87c7-4aee-95fa-63f28452c8d4
Name           _sip._tcp.video.example.com
Type           SRV
Created On     2020-04-10 09:15:56.940189115 +0000 UTC
Modified On    2020-04-10 09:15:56.940189115 +0000 UTC
TTL            900
Data
    port       953
    priority   10
    target     media.example.com
    weight     10

Criar um registro de recurso do tipo "TXT" na CLI

Use o comando ibmcloud dns resource-record-create com a opção --type TXT para criar um registro de recurso do tipo TXT. O --name e --text são opções obrigatórias.

$ ibmcloud dns resource-record-create $DNS_ZONE_ID --type TXT --name text --text "This is a text record."
Creating resource record in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID            TXT:92648285-c7e5-49ef-bf8b-a5be91d5c5d3
Name          text.example.com
Type          TXT
Created On    2020-04-10 09:16:50.169135062 +0000 UTC
Modified On   2020-04-10 09:16:50.169135062 +0000 UTC
TTL           900
Data
    text      This is a text record.

Criar um registro de recurso do tipo "MX" na CLI

Use o comando ibmcloud dns resource-record-create com a opção --type MX para criar um registro de recurso do tipo MX. O --name e --exchange são as opções obrigatórias.

$ ibmcloud dns resource-record-create $DNS_ZONE_ID --type MX --name mail --preference 10 --exchange exchange.example.com
Creating resource record in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID               MX:900750bf-881d-402f-a482-20447f2e64a2
Name             mail.example.com
Type             MX
Created On       2020-04-10 09:18:08.299278244 +0000 UTC
Modified On      2020-04-10 09:18:08.299278244 +0000 UTC
TTL              900
Data
    preference   10
    exchange     exchange.example.com

Criar um registro de recurso do tipo "PTR" na CLI

Use o comando ibmcloud dns resource-record-create com a opção --type PTR para criar um registro de recurso do tipo PTR. O --name e --ptrdname são as opções obrigatórias.

$ ibmcloud dns resource-record-create $DNS_ZONE_ID --type PTR --name 192.168.1.100 --ptrdname www.example.com
Creating resource record in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID             PTR:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6
Name           192.168.1.100
Type           PTR
Created On     2020-04-10 09:34:49.722454606 +0000 UTC
Modified On    2020-04-10 09:34:49.722454606 +0000 UTC
TTL            900
Data
    ptrdname   www.example.com

Crie um registro de recurso do tipo "CNAME" na CLI

Use o comando ibmcloud dns resource-record-create com a opção --type CNAME para criar um registro de recurso do tipo CNAME. O --name e --cname são opções obrigatórias.

$ ibmcloud dns resource-record-create $DNS_ZONE_ID --type CNAME --name web --cname www.example.com
Creating resource record in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID            CNAME:6e80f079-effd-409a-a520-b8c1b10f6e6e
Name          web.example.com
Type          CNAME
Created On    2020-04-10 09:36:13.186040793 +0000 UTC
Modified On   2020-04-10 09:36:13.186040793 +0000 UTC
TTL           900
Data
    cname     www.example.com

Criar um registro de recurso do tipo "AAAA" na CLI

Use o comando ibmcloud dns resource-record-create com a opção --type AAAA para criar um registro de recurso do tipo AAAA. O --name e --ipv6 são opções obrigatórias.

$ ibmcloud dns resource-record-create $DNS_ZONE_ID --type AAAA --name www --ipv6 2019::2020
Creating resource record in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID            AAAA:37e1e701-e549-4ca1-8c22-86574bf4aaed
Name          www.example.com
Type          AAAA
Created On    2020-04-10 09:37:15.063814601 +0000 UTC
Modified On   2020-04-10 09:37:15.063814601 +0000 UTC
TTL           900
Data
    ip        2019::2020

Obter um registro de recurso da CLI

Use o comando ibmcloud dns resource-record seguido pelo ID de zona e pelo ID de registro de recurso para obter detalhes de um registro de recurso.

$ ibmcloud dns resource-record $DNS_ZONE_ID A:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6
Getting resource record 'A:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6' in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID            A:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6
Name          www.example.com
Type          A
Created On    2020-04-10 09:12:07.858707275 +0000 UTC
Modified On   2020-04-10 09:34:49.986883927 +0000 UTC
TTL           900
Data
    ip        192.168.1.100

Listar registros de recursos na CLI

Use o comando ibmcloud dns resource-records seguido pelo ID de zona para listar todos os registros de recurso.

$ ibmcloud dns resource-records $DNS_ZONE_ID
Listing resource records in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK
ID                                           Name                          Type    TTL
AAAA:37e1e701-e549-4ca1-8c22-86574bf4aaed    www.example.com               AAAA    900
CNAME:6e80f079-effd-409a-a520-b8c1b10f6e6e   web.example.com               CNAME   900
MX:900750bf-881d-402f-a482-20447f2e64a2      mail.example.com              MX      900
TXT:92648285-c7e5-49ef-bf8b-a5be91d5c5d3     text.example.com              TXT     900
SRV:c7c8938b-87c7-4aee-95fa-63f28452c8d4     _sip._tcp.video.example.com   SRV     900
A:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6       www.example.com               A       900
PTR:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6     192.168.1.100                 PTR     900

Atualizar um registro de recurso na CLI

Use o comando ibmcloud dns resource-record-update seguido pelo ID de zona e pelo ID de registro de recurso para atualizar um registro de recurso.

$ ibmcloud dns resource-record-update $DNS_ZONE_ID A:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6 --name www --ipv4 10.10.1.1
Updating resource record 'A:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6' in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

ID            A:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6
Name          www.example.com
Type          A
Created On    2020-04-10 09:12:07.858707275 +0000 UTC
Modified On   2020-04-10 09:40:55.204076727 +0000 UTC
TTL           900
Data
    ip        10.10.1.1

Excluir um registro de recurso da CLI

Use o comando ibmcloud dns resource-record-delete seguido pelo ID de zona e pelo ID de registro de recurso para excluir um registro de recurso.

$ ibmcloud dns resource-record-delete $DNS_ZONE_ID PTR:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6
Really delete resource record 'PTR:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6' in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km'? [y/N]> y
Deleting resource record 'PTR:f20cfe91-b936-4bad-a8d1-f7afa4ac32a6' in zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' for service instance 'DNS Services-km' ...
OK

Gerenciar registros DNS com a API

Primeiro armazene o terminal da API em uma variável para que seja possível usá-lo em solicitações de API sem ter que digitar a URL completa. Por exemplo, para armazenar o terminal de produção em uma variável, execute este comando:

DNSSVCS_ENDPOINT=https://api.dns-svcs.cloud.ibm.com

Para verificar se essa variável foi salva, execute echo $DNSSVCS_ENDPOINT e assegure-se de que a resposta não esteja vazia.

Crie um registro de recurso do tipo ' A com a API

Solicitação

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records \
  -H "Authorization: $TOKEN" \
  -d '{
    "name":"www.example.com",
    "type":"A",
    "rdata": {
            "ip":"1.2.6.7"
        },
    "ttl":300
}'

Resposta

{
    "id": "fa57d5d0-7729-4770-af27-6d7f8dce860c",
    "created_on": "2019-08-12 08:03:03.910471016 +0000 UTC",
    "modified_on": "2019-08-12 08:03:03.910471016 +0000 UTC",
    "rtype": "A",
    "ttl": 300,
    "name": "www.example.com",
    "id": "A:fa57d5d0-7729-4770-af27-6d7f8dce860c",
    "rdata": {
        "ip": "1.2.6.7"
    }
}

Crie um registro de recurso do tipo "SRV" com a API

Solicitação

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records \
  -H "Authorization: $TOKEN" \
  -d '{
    "type": "SRV",
    "name": "example.com",
    "service": "srv",
    "protocol": "udp",
    "rdata": {
        "priority": 100,
        "weight": 100,
        "port": 8000,
        "target": "siphost.com"
    }
}'

Resposta

{
    "created_on": "2019-08-16 08:07:41.113606 +0000 UTC",
    "modified_on": "2019-08-16 08:07:41.113606 +0000 UTC",
    "rtype": "SRV",
    "ttl": 60,
    "name": "example.com",
    "id": "SRV:7562b1f9-1a6a-4189-b794-dd84c91d6a28",
    "rdata": {
        "priority": 100,
        "weight": 100,
        "port": 8000,
        "target": "siphost.com"
    },
    "service": "srv",
    "protocol": "udp"
}

Crie um registro de recurso do tipo "TXT" com a API

Solicitação

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records \
  -H "Authorization: $TOKEN" \
  -d '{
    "type": "TXT",
    "name": "txt.example.com",
    "rdata": {
        "txtdata": "txt strings"
    }
}'

Resposta

{
    "created_on": "2019-08-16 08:15:53.360664 +0000 UTC",
    "modified_on": "2019-08-16 08:15:53.360664 +0000 UTC",
    "rtype": "TXT",
    "ttl": 60,
    "name": "txt.example.com",
    "id": "TXT:c6221d5f-69d7-4717-9951-4f69b2680fd4",
    "rdata": {
        "txtdata": "txt strings"
    }
}

Criar um registro de recurso do tipo "MX" com a API

Solicitação

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records \
  -H "Authorization: $TOKEN" \
  -d '{
    "type": "MX",
    "name": "mx1.example.com",
    "rdata": {
        "exchange": "mailserver.example.com",
        "preference": 10
    }
}'

Resposta

{
    "created_on": "2019-08-16 08:21:20.308716 +0000 UTC",
    "modified_on": "2019-08-16 08:21:20.308716 +0000 UTC",
    "rtype": "MX",
    "ttl": 60,
    "name": "mx1.example.com",
    "id": "MX:8e1b201e-00dd-46a0-a3ec-46573f908870",
    "rdata": {
        "preference": 10,
        "exchange": "mailserver.example.com"
    }
}

Criar um registro de recurso do tipo "PTR" com a API

Solicitação

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records \
  -H "Authorization: $TOKEN" \
  -d '{
    "type": "PTR",
    "name": "192.168.10.100",
    "rdata": {
       "ptrdname": "www1.example.com"
    }
}'

Resposta

{
    "created_on": "2019-08-30 06:48:16.971764628 +0000 UTC",
    "modified_on": "2019-08-30 06:48:16.971764628 +0000 UTC",
    "rtype": "PTR",
    "ttl": 60,
    "name": "100.10.168.192.in-addr.arpa",
    "id": "PTR:a47dd63a-e65a-4280-8f53-3cdb433cc78a",
    "rdata": {
        "ptrdname": "www1.example.com"
    }
}

Crie um registro de recurso do tipo "CNAME" com a API

Solicitação

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records \
  -H "Authorization: $TOKEN" \
  -d '{
    "type": "CNAME",
    "name": "cname.example.com",
    "rdata": {
       "cname": "clientinterface.com"
    }
}'

Resposta

{
    "created_on": "2019-08-16 08:29:36.710416 +0000 UTC",
    "modified_on": "2019-08-16 08:29:36.710416 +0000 UTC",
    "rtype": "CNAME",
    "ttl": 60,
    "name": "cname.example.com",
    "id": "CNAME:c95916ba-5504-499a-943a-21f5befe92b5",
    "rdata": {
        "cname": "clientinterface.com"
    }
}

Criação de um registro de recurso do tipo "AAAA" com a API

Solicitação

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records \
  -H "Authorization: $TOKEN" \
  -d '{
    "type": "AAAA",
    "name": "test.example.com",
    "rdata": {
       "ip": "8000::2000"
    }
}'

Resposta

{
    "created_on": "2019-08-16 08:34:38.311539 +0000 UTC",
    "modified_on": "2019-08-16 08:34:38.311539 +0000 UTC",
    "rtype": "AAAA",
    "ttl": 60,
    "name": "test.example.com",
    "id": "AAAA:894e165b-f066-434d-9b58-4afc2dca62c9",
    "rdata": {
        "ip": "8000::2000"
    }
}

Obtenha um registro de recurso com a API

Solicitação

curl -X GET \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records/$RECORD_ID \
  -H "Authorization: $TOKEN"

Resposta

{
    "created_on": "2019-08-12 08:03:03.910471016 +0000 UTC",
    "modified_on": "2019-08-12 08:03:32.875065176 +0000 UTC",
    "rtype": "A",
    "ttl": 300,
    "name": "www.example.com",
    "id": "A:fa57d5d0-7729-4770-af27-6d7f8dce860c",
    "rdata": {
        "ip": "9.4.6.7"
    }
}

Listar registros de recursos com a API

Solicitação

curl -X GET \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records?limit=50&offset=0 \
  -H "Authorization: $TOKEN"

Resposta

{
    "offset": 0,
    "limit": 50,
    "total_count": 1,
    "first": {
      "href": "https://api.dns-svcs.cloud.ibm.com/v1/instances/ec0c4ee2-5d1f-4066-bcf2-dc9f3122c638/dnszones/example.com:4759caa4-d4fa-4fb9-7848-f463de19b392/resource_records?limit=50"
    },
    "resource_records": [
        {
            "created_on": "2019-08-30 04:10:25.092468565 +0000 UTC",
            "modified_on": "2019-08-30 04:10:25.092468565 +0000 UTC",
            "rtype": "A",
            "ttl": 60,
            "name": "www.example.com",
            "id": "A:ec0c4ee2-5d1f-4066-bcf2-dc9f3122c639",
            "rdata": {
                "ip": "192.168.10.100"
            }
        }
    ]
}

Atualizar um registro de recurso com a API

Solicitação

curl -X PUT \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records/$RECORD_ID \
  -H "Authorization: $TOKEN" \
  -d '{
    "name":"www",
    "rdata": {
            "ip":"7.7.7.7"
        },
    "ttl":300
}'

Resposta

{
    "created_on":"2019-09-10 20:03:25.249355942 +0000 UTC",
    "modified_on":"2019-09-11 16:13:17.350043736 +0000 UTC",
    "rtype":"A",
    "ttl":300,
    "name":"www",
    "id":"A:139eb9f3-c646-4eb6-92fa-3ddabfb1b84f",
    "rdata":{
        "ip":"7.7.7.7"
    }
}

Excluir um registro de recurso com a API

Solicitação

curl -X DELETE \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/resource_records/$RECORD_ID \
  -H "Authorization: $TOKEN"

Resposta

HTTP 204 is returned, no content in response.

Importar registros de recursos em massa de um arquivo de zona DNS com a API

Solicitação

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/import_resource_records --form "file=@./bind.cfg" \
  -H "Authorization: $TOKEN"

Resposta

{
    "total_records_parsed": 17,
    "records_added": 17,
    "records_failed": 0,
    "records_added_by_type": {
        "A": 10,
        "AAAA": 2,
        "CNAME": 4,
        "SRV": 0,
        "TXT": 0,
        "MX": 0,
        "PTR": 1
    },
    "records_failed_by_type": {
        "A": 0,
        "AAAA": 0,
        "CNAME": 0,
        "SRV": 0,
        "TXT": 0,
        "MX": 0,
        "PTR": 0
    },
    "message": null,
    "errors": null
}

Exportar registros de recursos em massa para um arquivo de zona DNS com a API

Solicitação

curl -X GET \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/export_resource_records -o dns_records.cfg \
  -H "Authorization: $TOKEN"

Resposta

HTTP 200 is returned with zone file content in byte format