Criando uma instância do DNS Services no console

1. Abra a página Catálogo da IBM Cloud.

2. Selecione a categoria Rede.

3. Clique no tile DNS Services.

4. Escolha um plano.

5. Insira Nome do serviço e clique em Criar.

   Você é redirecionado para a página da instância do DNS Services que mostra as informações de Zonas de DNS.

Também é possível navegar diretamente para a criação de instância do DNS Services acessando a entrada do catálogo do DNS Services.

Criação de uma zona DNS no console

1. Navegue até a página Recurso e selecione sua instância do DNS Services.
2. Na página Zonas de DNS, clique em Criar zona.
3. No painel Criar zona, insira o nome de sua zona. Opcionalmente, insira um rótulo e uma descrição.
4. Clique em Criar zona no painel. Se a zona for criada com sucesso, você será redirecionado para a página Detalhes da zona.

Criação de um registro de recurso "A" no console

1. Navegue até a página Recurso e selecione sua instância do DNS Services. Em seguida, selecione sua zona.
2. Na página Detalhes do DNS, clique na guia Registros de DNS.
3. Clique em Selecionar ação de registro e selecione Incluir registro no menu de lista.
4. No painel Incluir registro, selecione o tipo de registro de DNS que você deseja incluir no menu Tipo. Nesse caso, selecione o tipo A.
5. Insira os dados necessários para o tipo de registro de DNS selecionado. Nesse caso, para o tipo A, insira Nome e Endereço IPv4.
6. Clique em Incluir registro no painel.

Criação de uma rede permitida no console

1. Navegue até a página Recurso e selecione sua instância do DNS Services. Em seguida, selecione sua zona.

2. Clique na guia Redes permitidas.

3. Clique em Incluir rede.

4. No painel Incluir rede, selecione a região de sua VPC no menu Região de rede.

5. Selecione a VPC no menu Rede que aparece.

6. Clique em Incluir rede.

   Essa solicitação inclui a rede VPC em sua zona, fornecendo para a rede o acesso à zona.

Criação de uma instância do DNS Services com a API

Consulte a documentação de Criar uma nova instância de recurso para a API do Controlador de recurso. Observe que resource_group e resource_plan_id devem ser configurados. Cada conta pode ter vários grupos de recursos e cada grupo de recursos tem um ID exclusivo.

Configure as variáveis como a seguir para criar uma instância do plano padrão:

"resource_plan_id": "2c8fa097-d7c2-4df2-b53e-2efb7874cdf7",

Consulte a documentação de Referência da API do Controlador de recurso para obter mais informações sobre o uso da API.

As linhas de comandos para instâncias estão usando a API do controlador de recurso, não as APIs do DNS. Esses comandos são equivalentes aos comandos ibmcloud resource service-instance, que fornecem conveniência para que usuários do DNS gerenciem instâncias do DNS Services.

Criação de uma zona DNS com a API

Deve-se criar um VPC para que seja possível vincular a zona de DNS a ele.

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 em uma variável, execute este comando:

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

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

Depois de reunir detalhes sobre sua instância, execute o comando curl a seguir para criar uma zona de DNS:

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones \
  -H "Authorization: $TOKEN" \
  -d '{
        "name": "example.com",
        "description": "The DNS zone is used for VPCs in the us-east region",
        "label": "us-east"
  }'

{
  "id": "example.com:2d0f862b-67cc-41f3-b6a2-59860d0aa90e",
  "created_on": "2019-01-01T05:20:00.12345Z",
  "modified_on": "2019-01-01T05:20:00.12345Z",
  "instance_id": "1407a753-a93f-4bb0-9784-bcfc269ee1b3",
  "name": "example.com",
  "description": "The DNS zone is used for VPCs in the us-east region",
  "state": "pending_network_add",
  "label": "us-east"
}

Criação de uma rede permitida com a API

O DNS Services permite a resolução do nome apenas por meio de um VPC incluído na zona de DNS.

Quando uma zona de DNS é criada, seu Status é PENDING_NETWORK_ADD. Para mover a zona para o estado ACTIVE, inclua uma entrada para a sua VPC na rede permitida da zona.

Incluindo a sua VPC na rede permitida de sua zona, as instâncias de cálculo em sua VPC podem acessar esses registros de recurso.

curl -X POST \
  $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/acls \
  -H "Authorization: $TOKEN" \
  -d '{
        "type": "vpc",
        "acl_data": {
            "vpc_crn": "crn:v1:staging:public:is:us-east:a/40705ee14536813e2385f26c20be24a5::vpc:ed5e3cdd-8a4f-45ce-bae4-2774cb028caf"
        }
  }'

{
  "id": "fecd0173-3919-456b-b202-3029dfa1b0f7",
  "created_on": "2019-01-01T05:20:00.12345Z",
  "modified_on": "2019-01-01T05:20:00.12345Z",
  "acl_data": {
    "vpc_crn": "crn:v1:staging:public:is:us-east:a/40705ee14536813e2385f26c20be24a5::vpc:ed5e3cdd-8a4f-45ce-bae4-2774cb028caf"
  },
  "type": "vpc"
}

Criação de um registro de recurso "A" com a API

Um Registro A (Registro de endereço) é um registro de recurso de DNS que associa um domínio ou subdomínio a um endereço IPv4.

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
  }'

{
   "created_on":"2019-09-13 19:56:42.484382585 +0000 UTC",
   "modified_on":"2019-09-13 19:56:42.484382585 +0000 UTC",
   "rtype":"A",
   "ttl":300,
   "name":"www.example.com.testZone.com",
   "id":"A:786c07c7-173e-473b-aa09-c186601a5709",
   "rdata":{
      "ip":"1.2.6.7"
   }
}