Creación y carga de un mapa de ruta
Puede cargar un archivo de mapa de ruta personalizado para un control granular sobre las decisiones de dirección del tráfico. Los mapas de rutas son archivos JSON personalizados que asignan direcciones IP (rangos CIDR) a objetivos de enrutamiento correspondientes a respuestas dentro de registros DNS.
Paso 1: preparar el archivo del mapa de ruta
Los mapas de rutas son archivos JSON de texto plano creados localmente antes de subirlos a IBM® NS1 Connect®. Tenga en cuenta que debe utilizar la extensión de archivo .json cuando guarde sus archivos.
El archivo del mapa de ruta utiliza el siguiente formato. Se requieren versión, redes y etiquetas:
{
"meta": {
"version": 1
},
"map": [
{
"networks": [],
"labels": []
}
]
}
| Campo | Tipo de datos | Descripción |
|---|---|---|
| meta | objeto | Metadatos |
| version | entero | (Obligatorio) Versión del formato de datos de intercambio; determina la semántica del resto del intercambio. Nota : La versión 1 es la actual. |
| map | conjunto de objetos | Cada objeto miembro declara un segmento del mapa tal como se define en la lista de direcciones de red que contiene. |
| networks | Matriz de series | (Obligatorio) Direcciones IPv4 y/o IPv6 en formato CIDR; una única definición de red puede incluir direcciones v4 y v6. |
| etiquetas | Matriz de series | (Obligatorio) Conjunto de etiquetas asociadas a las redes. Se trata de cadenas arbitrarias utilizadas para asociar respuestas DNS con segmentos de mapa. Nota : El orden en el que enumere las etiquetas es importante, ya que determina el orden en el que se emiten las respuestas. Por ejemplo, una lista ["b", "c",
"a"] emite respuestas DNS para "b" primero, luego "c" y, por último, "a". |
El siguiente mapa define tres redes. Las etiquetas objetivo hkg y sin se aplican al primer grupo de redes ( 192.168.10.0/24 a 192.168.60.0/24 ). El uso de varias etiquetas de destino permite aplicar mapas de rutas de forma más amplia; en este ejemplo, el primer grupo de redes se aplica tanto a la región geográfica de Hong Kong como a la de Singapur. La etiqueta de destino nrt se aplica al segundo grupo de redes ( 192.168.132.0/24 a 192.168.144.0/24 ).
{
"meta": {
"version": 1
},
"map": [
{
"networks": [
"192.168.10.0/24",
"192.168.20.0/24",
"192.168.40.0/24",
"192.168.50.0/24",
"192.168.60.0/24"
],
"labels": ["hkg", "sin"]
},
{
"networks": [
"192.168.132.0/24",
"192.168.133.0/24",
"192.168.135.0/24",
"192.168.144.0/20"
],
"labels": ["nrt"]
},
{
"networks": [
"172.16.5.0/24",
"172.16.1.0/24",
"192.168.111.0/24",
"fd0d:82a7:be8b:ae00::/56",
"fde2:d85e:f372:7408::/64"
],
"labels": ["syd"]
}
]
}En este ejemplo, para el primer grupo de redes, se hace referencia primero a la etiqueta de destino hkg, ya que aparece primero en el archivo de mapa. Si no hay respuestas correspondientes que coincidan con los metadatos de hkg, se hace referencia a la siguiente etiqueta ( sin ).
Paso 2: cargar el mapa de ruta
Complete las siguientes instrucciones para cargar un archivo de mapa de ruta utilizando el portal NS1 Connect o la API.
- En el portal, vaya a la página Pulsar en la navegación principal.
- Haga clic en la pestaña Mapas de rutas.
- Haga clic en Añadir mapa de ruta.
- Introduzca un nombre para el mapa de ruta.
- Haga clic en Examinar y seleccione el archivo del mapa de ruta.
- Haga clic en Cargar.
Si utiliza la API, debe ejecutar dos solicitudes de API. La primera solicitud crea los metadatos del mapa de ruta en preparación para la carga. La respuesta contiene información crítica que necesitará para la segunda solicitud, que carga el archivo de mapa de ruta en IBM NS1 Connect®.
En primer lugar, utilice la solicitud GET que aparece a continuación para crear los metadatos del mapa de ruta, sustituyendo <name> por un nombre para el mapa de ruta.
curl -X GET -H "X-NSONE-Key: $NSONE_API_KEY" https://api.nsone.net/v1/pulsar/routemaps/create?name=<name>Respuesta de ejemplo:
{
"customer": 0,
"status": "uploading",
"name": "example",
"created": 0,
"url": "https://s3.amazonaws.com/pulsar-routemap-uploads/example.json?...",
"mapid": 0,
"modified": 0
}https://s3.amazonaws.com/pulsar-routemap-uploads/... ), ya que la necesitará para completar el siguiente paso.En segundo lugar, utilice la siguiente solicitud PUT para cargar el archivo del mapa de ruta, sustituyendo <fileSize> por el tamaño del archivo del mapa de ruta, <filePath> con la ruta de acceso del archivo del mapa de ruta, y <aws_url> con la URL única proporcionada en respuesta a la solicitud anterior.
curl -X PUT -L -H "Content-Length: <fileSize>" -H "Client-Encoding: UTF-8" -T "<filePath>" "<aws_url>"Próximos pasos
Configure un Filter Chain dentro del registro o registros DNS correspondientes utilizando el filtro Mapa de ruta para activar la configuración.
update IPs https://ibmdocs-test.dcs.ibm.com/docs/en/ibm-style?topic=elements-web-ip-email-addresses#ipv4-addresses