Gestión de redes permitidas

Gestione las redes permitidas para su instancia IBM Cloud® DNS Services mediante la interfaz de usuario, la CLI o la API.

Añadir redes permitidas en la consola

Los servicios DNS son un servicio global, con el cual puede añadir redes permitidas (por ejemplo, una VPC) de cualquier región de IBM Cloud®. Esta solicitud añade la red a la zona DNS, dando así a la red acceso a la zona. Puede añadir un máximo de 10 redes permitidas a una zona DNS.

Las instancias de servidor virtual recién creadas se configuran automáticamente para utilizar programas de resolución DNS privados (161.26.0.7 y 161.26.0.8). Las instancias de servidor virtual existentes pueden tardar hasta 3 minutos en configurarse para utilizar programas de resolución DNS privados.

  1. Seleccione la zona deseada en la tabla de la página Zonas DNS.
  2. Seleccione el separador Redes permitidas.
  3. Pulse Añadir red.
  4. En el panel que aparece, seleccione la región de la red en el menú de la lista Región de red.
  5. Seleccione la red deseada en el menú de la lista Red que aparece.
  6. Pulse Añadir red.

No se permite añadir la misma VPC a dos zonas DNS del mismo nombre.

Puede ir a la página de visión general de VPC desde la sección Redes permitidas pulsando el nombre de la VPC. Por ejemplo, en la siguiente imagen, al hacer clic en demo-vpc se accede a la página de resumen de la VPC denominada demo-vpc.

Enlace de red permitida a la
a una IBM VPC desde la
de redes permitidas*

Listado de redes permitidas en la consola

  1. Seleccione la zona deseada en la tabla de la página Zonas DNS.
  2. Seleccione el separador Redes permitidas.

por
de cuenta ACL de cuentas cruzadas* De forma predeterminada, la lista contiene las redes permitidas que se han añadido desde su cuenta como propietario. Para ver las redes permitidas añadidas por los usuarios de ACL entre cuentas, puede utilizar un filtro seleccionando los ID de cuenta.

Puede seleccionar un máximo de 5 ID de cuentas cruzadas.

Eliminar una red permitida en la consola

En la tabla de redes permitidas, pulse el icono Suprimir. Confirme el proceso de supresión en el recuadro de diálogo que aparece.

Si existe una red en una zona, no puede suprimir la zona hasta que se suprima la red permitida.

Gestión de redes permitidas desde la CLI

Primero utilice el mandato ibmcloud dns instance-target para establecer la instancia de servicios DNS operativos 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"

Almacene el ID de zona en una variable de modo que pueda utilizarlo en los mandatos siguientes sin tener que escribirlo cada vez. Por ejemplo, para almacenar el ID de zona en una variable, ejecute este mandato:

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

Añadir redes permitidas desde la CLI

Utilice el mandato ibmcloud dns permitted-network-add seguido del ID de zona para añadir una VPC a las redes permitidas de la zona. Siga los pasos para seleccionar una instancia de VPC para añadirla a las redes permitidas.

$ ibmcloud dns permitted-network-add $DNS_ZONE_ID
Select Network Region
1. au-syd
2. br-sao
3. ca-tor
4. eu-de
5. eu-gb
6. jp-osa
7. jp-tok
8. us-east
9. us-south
Enter a number> 1
Network Region: US South
Select VPC Network
1. vpc-cli-example
2. vpc-g1-dal-pdns-datapath-test-not-delete
6. vpc-g2-dal-pdns-datapath-test-not-delete
Enter a number> 1
Adding permitted network for zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' ...
OK

Name          vpc-cli-example
ID            ffffffff-f7c9-49ff-a8ca-000000000000
Type          vpc
VPC_CRN       crn:v1:bluemix:public:is:us-south:a/bcf1865e991345daf4d5f24ea90a5497::vpc:ffffffff-f7c9-49ff-a8ca-000000000000
State         ACTIVE
Created On    2020-04-10 10:06:24.99659547 +0000 UTC
Modified On   2020-04-10 10:06:24.99659547 +0000 UTC

Para solicitudes futuras, se hace referencia al ID de la salida como PERMITTED_NETWORK_ID.

Recuperar una red permitida desde la CLI

Utilice ibmcloud dns permitted-network seguido del ID de zona y el ID de red permitido para recuperar los detalles de una red permitida.

$ ibmcloud dns permitted-network $DNS_ZONE_ID $PERMITTED_NETWORK_ID
Getting permitted network 'ffffffff-f7c9-49ff-a8ca-000000000000' for zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' ...
OK

Name          vpc-gen1-for-pdns-e2e-test01-do-not-delete
ID            ffffffff-f7c9-49ff-a8ca-000000000000
Type          vpc
VPC_CRN       crn:v1:bluemix:public:is:us-south:a/bcf1865e991345daf4d5f24ea90a5497::vpc:ffffffff-f7c9-49ff-a8ca-000000000000
State         ACTIVE
Created On    2020-04-10 10:06:24.99659547 +0000 UTC
Modified On   2020-04-10 10:06:24.99659547 +0000 UTC

Listado de redes permitidas desde la CLI

Utilice ibmcloud dns permitted-networks seguido del ID de zona para listar todas las redes permitidas.

$ ibmcloud dns permitted-networks $DNS_ZONE_ID
Listing permitted networks for zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' ...
OK

Name                                         ID                                     Type   VPC_CRN                                                                                                          State
vpc-gen1-for-pdns-e2e-test01-do-not-delete   ffffffff-f7c9-49ff-a8ca-000000000000   vpc    crn:v1:bluemix:public:is:us-south:a/bcf1865e991345daf4d5f24ea90a5497::vpc:ffffffff-f7c9-49ff-a8ca-000000000000   ACTIVE

Eliminación de una red permitida de la CLI

Utilice el mandato ibmcloud dns permitted-network-remove seguido por el ID de zona y el ID de red permitido para enlazar VPC de la zona.

$ ibmcloud dns permitted-network-remove $DNS_ZONE_ID $PERMITTED_NETWORK_ID
Really remove permitted network 'ffffffff-f7c9-49ff-a8ca-000000000000' from zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' ? [y/N]> y
Removing permitted network 'ffffffff-f7c9-49ff-a8ca-000000000000' from zone 'example.com:f7f40364-a5e6-48f7-9fc9-387434c579ae' ...
OK

La eliminación de una red permitida puede tardar hasta 5 minutos. No puede volver a añadir la VPC a la red permitida de la zona DNS hasta que se haya completado la operación de eliminación.

Gestión de redes permitidas con la API

Primero, almacene el punto final de la API en una variable para poder utilizarla en las solicitudes de API sin tener que escribir el URL completo. Por ejemplo, para almacenar el punto final de producción en una variable, ejecute este mandato:

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

Para verificar que esta variable se ha guardado, ejecute echo $DNSSVCS_ENDPOINT y asegúrese de que la respuesta no está vacía.

Añadir redes permitidas con la API

El estado inicial de una zona DNS es PENDING_NETWORK_ADD, porque su lista de red permitida está vacía cuando se crea la zona DNS. Cuando se añade una red permitida a las redes permitidas de la zona DNS, el estado cambia a ACTIVE.

Parámetros

  • DNSZONE_ID: Cuando crea una zona, se devuelve DNSZONE_ID en la respuesta como id.

Solicitud

curl -X POST \
         $DNSSVCS_ENDPOINT/v1/instances/$INSTANCE_ID/dnszones/$DNSZONE_ID/permitted_networks \
         -H "Authorization: $TOKEN" \
         -d '{
             "type": "vpc",
             "permitted_network":{
                 "vpc_crn":"crn:v1:staging:public:is:us-east:a/0821fa9f9ebcc7b7c9a0d6e9bf9442a4::vpc:b7246cdf-892a-4a6c-8fa9-491a5f585bd0"
             }
         }'

Respuesta

{
    "id": "b7246cdf-892a-4a6c-8fa9-491a5f585bd0",
    "created_on": "2019-09-11 13:46:51.68793557 +0000 UTC",
    "modified_on": "2019-09-11 13:46:51.68793557 +0000 UTC",
    "permitted_network": {
        "vpc_crn": "crn:v1:staging:public:is:us-east:a/0821fa9f9ebcc7b7c9a0d6e9bf9442a4::vpc:b7246cdf-892a-4a6c-8fa9-491a5f585bd0"
    },
    "type": "vpc",
    "state": "ACTIVE"
}

Para solicitudes futuras, se hace referencia al ID de la respuesta como PERMITTED_NETWORK_ID.

Recuperar una red permitida con la API

Recupere una red permitida específica de la instancia utilizando el ID de la red permitida.

Solicitud

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

Respuesta

{
    "id": "b7246cdf-892a-4a6c-8fa9-491a5f585bd0",
    "created_on": "2019-09-11 13:46:51.68793557 +0000 UTC",
    "modified_on": "2019-09-11 13:46:51.68793557 +0000 UTC",
    "permitted_network": {
        "vpc_crn": "crn:v1:staging:public:is:us-east:a/0821fa9f9ebcc7b7c9a0d6e9bf9442a4::vpc:b7246cdf-892a-4a6c-8fa9-491a5f585bd0"
    },
    "type": "vpc",
    "state": "ACTIVE"
}

Listado de redes permitidas con la API

Liste todas las redes permitidas para su zona DNS.

Solicitud

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

Respuesta

{
    "permitted_networks": [
        {
            "id": "b7246cdf-892a-4a6c-8fa9-491a5f585bd0",
            "created_on": "2019-09-11 13:46:51.68793557 +0000 UTC",
            "modified_on": "2019-09-11 13:46:51.68793557 +0000 UTC",
            "permitted_network": {
                "vpc_crn": "crn:v1:staging:public:is:us-east:a/0821fa9f9ebcc7b7c9a0d6e9bf9442a4::vpc:b7246cdf-892a-4a6c-8fa9-491a5f585bd0"
            },
            "type": "vpc",
            "state": "ACTIVE"
        }
    ]
}

Eliminar una red permitida con la API

Suprima una red permitida específica de la instancia y desenlace la VPC de una zona.

Solicitud

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

Respuesta

{
    "id": "b7246cdf-892a-4a6c-8fa9-491a5f585bd0",
    "created_on": "2019-09-11 13:46:51.68793557 +0000 UTC",
    "modified_on": "2019-09-11 13:46:51.68793557 +0000 UTC",
    "permitted_network": {
        "vpc_crn": "crn:v1:staging:public:is:us-east:a/0821fa9f9ebcc7b7c9a0d6e9bf9442a4::vpc:b7246cdf-892a-4a6c-8fa9-491a5f585bd0"
    },
    "type": "vpc",
    "state": "REMOVAL_IN_PROGRESS"
}

La eliminación de una red permitida puede tardar hasta 5 minutos. No puede volver a añadir la VPC a la red permitida de la zona DNS hasta que se haya completado la operación de eliminación.