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.
- Seleccione la zona deseada en la tabla de la página Zonas DNS.
- Seleccione el separador Redes permitidas.
- Pulse Añadir red.
- En el panel que aparece, seleccione la región de la red en el menú de la lista Región de red.
- Seleccione la red deseada en el menú de la lista Red que aparece.
- Pulse Añadir red.
No se permite añadir la misma VPC a dos zonas DNS del mismo nombre.
Listado de redes permitidas en la consola
- Seleccione la zona deseada en la tabla de la página Zonas DNS.
- Seleccione el separador Redes permitidas.
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.