add support for listing available monitoring regions

go.mod

@@ -7,7 +7,7 @@ require (
 	github.com/hashicorp/go-retryablehttp v0.7.2
 	github.com/hashicorp/terraform-plugin-sdk/v2 v2.24.1
 	github.com/stretchr/testify v1.8.1
-	gopkg.in/ns1/ns1-go.v2 v2.8.0
+	gopkg.in/ns1/ns1-go.v2 v2.9.0
 )
 
 require (

ns1/config.go

@@ -19,7 +19,7 @@ import (
 )
 
 var (
-	clientVersion     = "2.1.0"
+	clientVersion     = "2.2.0"
 	providerUserAgent = "tf-ns1" + "/" + clientVersion
 	defaultRetryMax   = 3
 )

ns1/data_source_monitoring_regions.go

@@ -0,0 +1,60 @@
+package ns1
+
+import (
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
+	ns1 "gopkg.in/ns1/ns1-go.v2/rest"
+)
+
+func dataSourceMonitoringRegions() *schema.Resource {
+	return &schema.Resource{
+		Schema: map[string]*schema.Schema{
+			"regions": {
+				Type:     schema.TypeList,
+				Optional: true,
+				Elem: &schema.Resource{
+					Schema: map[string]*schema.Schema{
+						"code": {
+							Type:     schema.TypeString,
+							Optional: true,
+						},
+						"name": {
+							Type:     schema.TypeString,
+							Optional: true,
+						},
+						"subnets": {
+							Type:     schema.TypeList,
+							Optional: true,
+							Elem: &schema.Schema{
+								Type: schema.TypeString,
+							},
+						},
+					},
+				},
+			},
+		},
+		Read: MonitoringingRegionsRead,
+	}
+}
+
+// MonitoringRegionsRead reads the available Monitoring Regions from ns1.
+func MonitoringingRegionsRead(d *schema.ResourceData, meta any) error {
+	client := meta.(*ns1.Client)
+
+	regions, resp, err := client.MonitorRegions.List()
+	if err != nil {
+		return ConvertToNs1Error(resp, err)
+	}
+
+	out := []map[string]any{}
+
+	for _, region := range regions {
+		out = append(out, map[string]any{
+			"code":    region.Code,
+			"name":    region.Name,
+			"subnets": region.Subnets,
+		})
+	}
+
+	d.SetId("1")
+	return d.Set("regions", out)
+}

ns1/data_source_monitoring_regions_test.go

@@ -0,0 +1,51 @@
+package ns1
+
+import (
+	"fmt"
+	"testing"
+
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/resource"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/terraform"
+)
+
+func TestAccMonitoringRegions_basic(t *testing.T) {
+	name := "foobar"
+	resourceName := fmt.Sprintf("data.ns1_monitoring_regions.%s", name)
+	resource.Test(t, resource.TestCase{
+		PreCheck:     func() { testAccPreCheck(t) },
+		Providers:    testAccProviders,
+		CheckDestroy: testAccCheckTeamDestroy,
+		Steps: []resource.TestStep{
+			{
+				Config: fmt.Sprintf(testAccMonitoringRegionsBasic, name),
+				Check: resource.ComposeTestCheckFunc(
+					testAccCheckMonitoringRegionsLength(resourceName),
+				),
+			},
+		},
+	})
+}
+
+func testAccCheckMonitoringRegionsLength(
+	n string,
+) resource.TestCheckFunc {
+	return func(s *terraform.State) error {
+		regions, ok := s.RootModule().Resources[n]
+
+		if !ok {
+			return fmt.Errorf("not found: %s", n)
+		}
+
+		// make sure we get some monitoring regions
+		if len(regions.Primary.Attributes["regions.#"]) == 0 {
+			return fmt.Errorf("no monitoring regions found")
+		}
+
+		return nil
+	}
+}
+
+const testAccMonitoringRegionsBasic = `
+data "ns1_monitoring_regions" "%s" {
+}
+`

ns1/provider.go

@@ -56,10 +56,11 @@ func Provider() *schema.Provider {
 			},
 		},
 		DataSourcesMap: map[string]*schema.Resource{
-			"ns1_zone":     dataSourceZone(),
-			"ns1_dnssec":   dataSourceDNSSEC(),
-			"ns1_record":   dataSourceRecord(),
-			"ns1_networks": dataSourceNetworks(),
+			"ns1_zone":               dataSourceZone(),
+			"ns1_dnssec":             dataSourceDNSSEC(),
+			"ns1_record":             dataSourceRecord(),
+			"ns1_networks":           dataSourceNetworks(),
+			"ns1_monitoring_regions": dataSourceMonitoringRegions(),
 		},
 		ResourcesMap: map[string]*schema.Resource{
 			"ns1_zone":              resourceZone(),

website/docs/d/monitoring_regions.markdown

@@ -0,0 +1,38 @@
+---
+layout: "ns1"
+page_title: "NS1: ns1_monitoring_regions"
+sidebar_current: "docs-ns1-datasource-monitoring-regions"
+description: |-
+  Provides detials of all available monitoring regions.
+---
+
+# Data Source: ns1_monitoring_regions
+
+Provides details of all available monitoring regions.
+
+## Example Usage
+
+```hcl
+# Get details of all available monitoring regions.
+data "ns1_monitoring_regions" "example" {
+}
+```
+
+## Argument Reference
+
+There are no required arguments.
+
+## Attributes Reference
+
+The following are attributes exported:
+
+* `regions` - A set of the available monitoring regions. [Regions](#regions) is
+  documented below.
+
+#### Regions
+
+A region has the following fields:
+
+* `code` - 3-letter city code identifying the location of the monitor.
+* `name` - City name identifying the location of the monitor.
+* `subnets` - A list of IPv4 and IPv6 subnets the monitor sources requests from.