NS1 status

Articles in this section

Updating (replacing) a route map

  • Updated
Follow

Follow the instructions below to update the route map file. After making changes to the source JSON file, you can update the route map via the NS1 Managed DNS portal or API.

To replace a route map via the NS1 portal:

  1. Log in to the Managed DNS portal via https://my.nsone.net.

  2. Click Pulsar in the top navigation bar.

  3. Click Route Maps in the sub-navigation.

    pulsar_routemaps_nav.png

  4. Locate the map in the list and click the vertical ellipsis icon on the right of it. Click Replace.

    pulsar_routemaps_replace.png

  5. Replace the map:

    1. In the Configure Existing Map window, rename the route map and/or browse for an updated route map file.

      configure_existing_map.png

    2. Click Upload.

The route map is replaced, and any records that include this route map as metadata are also updated to use the new version of the route map.

Note

NOTE

Route maps can take a few minutes to upload and process. After processing is complete, however, the changes are made available immediately to any associated records.

To update a route map via API:

If you are using the NS1 API, you must execute two API commands to first obtain a pre-signed Amazon S3 URL that you will use in a second step to upload the route map file to the NS1 platform. The map ID that you use in the first step must match that of the route map you will replace. You can only replace data for a route map that is in the ready state.

  1. Execute the following command to obtain the pre-signed Amazon S3 URL that you will use to upload the new route map file:

    curl -X GET -H "X-NSONE-Key: $API_KEY" https://api.nsone.net/v1/pulsar/routemaps/{mapID}/replace

    where {mapID} (integer) is the map ID of the route map you are replacing (for example, 2992). You can find the map ID from the NS1 portal or by viewing a list of route maps via the API.

    Example response:

    {
  "customer": 0,
  "status": "ready",
  "name": "West Coast",
  "created": 0,
  "url": "https://s3.amazonaws.com/pulsar-routemap-uploads/example.json?...",
  "mapid": 2992,
  "modified": 0
}

    Note

    IMPORTANT NOTE:

    Note and record the URL provided in the response to the command above. This is the URL to which you must upload the route map in the next step.

  2. Execute the following command to upload the route map file to the URL generated in the response to the command in the previous step:

    curl -X PUT -L -H "Content-Length: {file_size}" -H "Client-Encoding: UTF-8" -T "{file_path}" "{aws_url}"

    where {file_size} is the size of the route map file, {file_path} is the path of the route map file, and {aws_url} is the unique URL generated in the response to the previous GET command that you ran in step 1.

Related articles