ルートマップの作成とアップロード
カスタムのルートマップファイルをアップロードして、交通誘導の決定をきめ細かく制御することができます。 ルートマップは、IPアドレス（CIDR範囲）をDNSレコード内の回答に対応するルーティングターゲットにマッピングするカスタムJSONファイルです。
ステップ1 - ルートマップファイルを用意する
ルートマップは、 IBM® NS1 Connect® にアップロードする前にローカルで作成されたプレーンテキストの JSON ファイルです。 なお、ファイルを保存する際には、 .json という拡張子を使用する必要があります。
ルートマップファイルは以下のフォーマットを使用します。 バージョン、ネットワーク、ラベルが必要です
{
"meta": {
"version": 1
},
"map": [
{
"networks": [],
"labels": []
}
]
}
| フィールド | データ・タイプ | 説明 |
|---|---|---|
| meta | オブジェクト | メタデータ |
| version | 整数 | （必須）交換データフォーマットのバージョン。残りの交換のセマンティクスを決定します。 注 ：バージョン1が最新です。 |
| map | オブジェクトの配列 | 各メンバーオブジェクトは、その中に含まれるネットワークアドレスのリストによって定義されるマップのセグメントを宣言します。 |
| networks | ストリングの配列 | （必須）CIDR形式の IPv4 および/または IPv6 アドレス。1つのネットワーク定義には、 v4 アドレスと v6 アドレスの両方を含めることができます。 |
| ラベル | ストリングの配列 | （必須）ネットワークに関連付けられたラベルの配列。 これらは、DNSの回答と地図のセグメントを関連付けるために使用される任意の文字列です。 注： ラベルのリストの順序は重要です。なぜなら、回答が送信される順序を決定するからです。 例えば、 ["b", "c",
"a"] のリストは、 "b" 、次に "c" 、最後に "a" の順にDNSの回答を返します。 |
次の図は、3つのネットワークを示しています。 hkg と sin というターゲットラベルは、最初のネットワークグループ（ 192.168.10.0/24 から 192.168.60.0/24 ）に適用されます。 複数のターゲットラベルを使用することで、ルートマップをより広範囲に適用することができます。この例では、最初のネットワークグループは香港とシンガポールの両方の地域に適用されます。 ターゲットラベル nrt は、2番目のネットワークグループ（ 192.168.132.0/24 から 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"]
}
]
}この例では、最初のネットワークグループでは、マップファイルで最初に表示されているため、ターゲットラベル hkg が最初に参照されます。 hkg のメタデータに一致する対応する回答がない場合は、次のラベル（ sin ）が参照されます。
ステップ2 - ルートマップをアップロードする
NS1 Connect ポータルまたは API を使用してルートマップファイルをアップロードするには、次の手順に従います。
- ポータルで、メインナビゲーションの Pulsar ページに移動します。
- 路線図タブをクリックします。
- ルートマップを追加するをクリックします。
- ルートマップの名前を入力してください。
- 「参照」 をクリックし、ルートマップファイルを選択します。
- 「アップロード 」をクリックします。
APIを使用する場合は、2つのAPIリクエストを実行する必要があります。 最初の要求は、アップロードの準備としてルートマップのメタデータを作成します。 このレスポンスには、ルートマップファイルを IBM NS1 Connect® にアップロードする2つ目のリクエストに必要な重要な情報が含まれている。
まず、下記の GET リクエストを使用して、ルートマップのメタデータを作成します。ルートマップの名前を <nam> にe置き換えてください。
curl -X GET -H "X-NSONE-Key: $NSONE_API_KEY" https://api.nsone.net/v1/pulsar/routemaps/create?name=<name>応答の例:
{
"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/... ）を記録してください。次に、次の PUT リクエストを使用して、ルートマップファイルをアップロードします。 <fileSie>をzルートマップファイルのサイズに置き換え、 <filePath>ルートマップファイルのパス、および <aws_ur> をl前のリクエストに対する応答で提供された固有の URL に置き換えてください。
curl -X PUT -L -H "Content-Length: <fileSize>" -H "Client-Encoding: UTF-8" -T "<filePath>" "<aws_url>"次のステップ
ルートマップフィルタを使用して、関連するDNSレコード内に Filter Chain 。
update IPs https://ibmdocs-test.dcs.ibm.com/docs/en/ibm-style?topic=elements-web-ip-email-addresses#ipv4-addresses