Erstellen und Hochladen einer Wegbeschreibung

Sie können eine benutzerdefinierte Routenkartendatei hochladen, um Entscheidungen zur Verkehrssteuerung detailliert zu steuern. Routenkarten sind benutzerdefinierte JSON-Dateien, die IP-Adressen (CIDR-Bereiche) Routing-Zielen zuordnen, die Antworten in DNS-Einträgen entsprechen.

Schritt 1 – Bereiten Sie die Routenkartendatei vor

Routenkarten sind JSON-Dateien im Klartext, die lokal erstellt werden, bevor sie auf IBM® NS1 Connect® hochgeladen werden. Beachten Sie, dass Sie die Dateierweiterung .json verwenden müssen, wenn Sie Ihre Dateien speichern.

Die Routenkartendatei verwendet das folgende Format. Version, Netzwerke und Labels sind erforderlich:

{
  "meta": {
    "version": 1
  },
  "map": [
    {
      "networks": [],
      "labels": []
    }
  ]
}
Feld Datentyp Beschreibung
meta Objekt Metadaten
version ganze Zahl (Erforderlich) Version des Austauschdatenformats; bestimmt die Semantik des restlichen Austauschs.
Hinweis : Version 1 ist aktuell.
map objektgruppe Jedes Mitgliedobjekt deklariert einen Kartenausschnitt, der durch die darin enthaltene Liste der Netzwerkadressen definiert ist.
networks Array von Zeichenfolgen (Erforderlich) IPv4 - und/oder IPv6 -Adressen im CIDR-Format; eine einzelne Netzwerkdefinition kann sowohl v4 - als auch v6 -Adressen enthalten.
Label Array von Zeichenfolgen (Erforderlich) Eine Reihe von Labels, die mit den Netzwerken verbunden sind. Dies sind willkürliche Zeichenketten, die verwendet werden, um DNS-Antworten mit Kartensegmenten zu verknüpfen.
Hinweis : Die Reihenfolge, in der Sie die Etiketten auflisten, ist wichtig, da sie die Reihenfolge bestimmt, in der die Antworten ausgegeben werden. Beispielsweise gibt eine Liste ["b", "c", "a"] zuerst DNS-Antworten für "b", dann für "c" und dann für "a" aus.
Beispiel-Streckenkarte

Die folgende Karte definiert drei Netzwerke. Die Ziel-Labels hkg und sin werden auf die erste Gruppe von Netzwerken ( 192.168.10.0/24 bis 192.168.60.0/24 ) angewendet. Durch die Verwendung mehrerer Zielbezeichnungen können Sie die Streckenkarten breiter anwenden. In diesem Beispiel gilt die erste Gruppe von Netzwerken für die geografischen Regionen Hongkong und Singapur. Die zweite Gruppe von Netzwerken ( 192.168.132.0/24 bis 192.168.144.0/24 ) wird mit dem Ziel-Label nrt versehen.

Draft comment: nadine.mootoo@ibm.com
update IPs https://ibmdocs-test.dcs.ibm.com/docs/en/ibm-style?topic=elements-web-ip-email-addresses#ipv4-addresses 

{
  "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"]
    }
  ]
}

In diesem Beispiel wird für die erste Gruppe von Netzwerken zuerst auf das Ziel-Label hkg verwiesen, da es in der Kartendatei zuerst erscheint. Wenn es keine entsprechenden Antworten gibt, die mit den hkg -Metadaten übereinstimmen, wird auf das nächste Label ( sin ) verwiesen.

Schritt 2 – Laden Sie die Streckenkarte hoch

Befolgen Sie die folgenden Anweisungen, um eine Routenkartendatei über das Portal NS1 Connect oder die API hochzuladen.

Über das Portal hochladen
  1. Navigieren Sie im Portal zur Seite Pulsar seite in der Hauptnavigation.
  2. Klicken Sie auf die Registerkarte "Streckenkarten ".
  3. Klicken Sie auf "Streckenkarte hinzufügen ".
  4. Geben Sie einen Namen für die Streckenkarte ein.
  5. Klicken Sie auf "Durchsuchen" und wählen Sie die Datei mit der Streckenkarte aus.
  6. Klicken Sie auf "Hochladen ".
Hinweis : Es kann einige Minuten dauern, bis die Routenkartendatei verarbeitet wurde.
Über API hochladen

Wenn Sie die API verwenden, müssen Sie zwei API-Anfragen ausführen. Die erste Anfrage erstellt die Metadaten der Routenkarte zur Vorbereitung des Uploads. Die Antwort enthält wichtige Informationen, die Sie für die zweite Anfrage benötigen, mit der die Routenkartendatei auf IBM NS1 Connect® hochgeladen wird.

Hinweis: Sie benötigen einen gültigen API-Schlüssel, der im Portal NS1 Connect erstellt wurde, um API-Anfragen zu authentifizieren.

Verwenden Sie zunächst die untenstehende Anfrage an GET, um die Metadaten der Streckenkarte zu erstellen, und ersetzen Sie dabei "<name>" durch einen Namen für die Streckenkarte.

curl -X GET -H "X-NSONE-Key: $NSONE_API_KEY" https://api.nsone.net/v1/pulsar/routemaps/create?name=<name>

Beispielantwort:

{
  "customer": 0,
  "status": "uploading",
  "name": "example",
  "created": 0,
  "url": "https://s3.amazonaws.com/pulsar-routemap-uploads/example.json?...",
  "mapid": 0,
  "modified": 0
}
Achtung : Notieren Sie sich die in der Antwort angegebene URL ( https://s3.amazonaws.com/pulsar-routemap-uploads/... ), da Sie diese für den nächsten Schritt benötigen.

Zweitens verwenden Sie die folgende PUT -Anfrage, um die Routenkartendatei hochzuladen, und ersetzen Sie dabei <fileSize> durch die Größe der Routenkartendatei, <filePath> durch den Pfad der Routenkartendatei und <aws_url> durch die eindeutige URL, die in der Antwort auf die vorherige Anfrage angegeben wurde,

curl -X PUT -L -H "Content-Length: <fileSize>" -H "Client-Encoding: UTF-8" -T "<filePath>" "<aws_url>"

Weitere Schritte

Konfigurieren Sie eine Filter Chain innerhalb des/der entsprechenden DNS-Eintrags/Datensätze, indem Sie den Filter Route Map verwenden, um die Konfiguration zu aktivieren.