Extracting a list of NS1 monitoring regions

The IBM® NS1 Connect® platform provides tools to configure basic up/down monitoring jobs to track the availability of your application endpoints and services. When configuring an NS1 monitoring job, you must select one or more monitoring regions from which the platform will probe the endpoint to test the connection. Depending on the settings of the monitoring job, the endpoint is only considered up if the tests conducted from one, most, or all monitoring regions pass the user-defined up conditions.

To monitor an endpoint using an NS1 monitoring job, the endpoint must be configured to allow incoming requests from the NS1 servers in each of the selected monitoring regions.

Run the following API request using a valid NS1 API key to return a detailed list of available NS1 monitoring regions—including the associated IP addresses and other details for each.

curl GET -H "X-NSONE-Key: $NSONE_API_KEY" https://api.nsone.net/v1/monitoring/regions

The JSON response includes the code, name, and the corresponding IPv4 and IPv6 subnets for each region.

[
  {
    "code": "nrt",
    "name": "Tokyo",
    "subnets": [
      "163.114.230.0/24",
      "2620:4d:4036::/48"
    ]
  },
  {
    "code": "dal",
    "name": "Dallas",
    "subnets": [
      "163.114.225.0/24",
      "2620:4d:4031::/48"
    ]
  },
  {
    "code": "sin",
    "name": "Singapore",
    "subnets": [
      "163.114.227.0/24",
      "2620:4d:4034::/48"
    ]
  },
  {
    "code": "sjc",
    "name": "San Jose",
    "subnets": [
      "163.114.226.0/24",
      "2620:4d:4030::/48"
    ]
  },
  {
    "code": "lga",
    "name": "New York",
    "subnets": [
      "163.114.224.0/24",
      "2620:4d:4032::/48"
    ]
  },
  {
    "code": "ams",
    "name": "Amsterdam",
    "subnets": [
      "163.114.228.0/24",
      "2620:4d:4033::/48"
    ]
  },
  {
    "code": "syd",
    "name": "Sydney",
    "subnets": [
      "163.114.229.0/24",
      "2620:4d:4035::/48"
    ]
  },
  {
    "code": "gru",
    "name": "São Paulo",
    "subnets": [
      "163.114.232.0/24",
      "2620:4d:4038::/48"
    ]
  },
  {
    "code": "lhr",
    "name": "London",
    "subnets": [
      "163.114.231.0/24",
      "2620:4d:4037::/48"
    ]
  }
]