Add datasource for teams (#510)

Author: andredupreez

docs/data-sources/team.md

@@ -0,0 +1,38 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "grafana_team Data Source - terraform-provider-grafana"
+subcategory: ""
+description: |-
+  Official documentation https://grafana.com/docs/grafana/latest/administration/manage-users-and-permissions/manage-teams/HTTP API https://grafana.com/docs/grafana/latest/http_api/team/
+---
+
+# grafana_team (Data Source)
+
+* [Official documentation](https://grafana.com/docs/grafana/latest/administration/manage-users-and-permissions/manage-teams/)
+* [HTTP API](https://grafana.com/docs/grafana/latest/http_api/team/)
+
+## Example Usage
+
+```terraform
+resource "grafana_team" "test" {
+  name  = "test-team"
+  email = "[email protected]"
+}
+
+data "grafana_team" "from_name" {
+  name = grafana_team.test.name
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `name` (String) The name of the Grafana team.
+
+### Read-Only
+
+- `id` (String) The ID of this resource.
+
+

examples/data-sources/grafana_team/data-source.tf

@@ -0,0 +1,8 @@
+resource "grafana_team" "test" {
+  name  = "test-team"
+  email = "[email protected]"
+}
+
+data "grafana_team" "from_name" {
+  name = grafana_team.test.name
+}

grafana/data_source_team.go

@@ -0,0 +1,60 @@
+package grafana
+
+import (
+	"context"
+	"fmt"
+	"strconv"
+
+	gapi "github.com/grafana/grafana-api-golang-client"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/diag"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
+)
+
+func DatasourceTeam() *schema.Resource {
+	return &schema.Resource{
+		Description: `
+* [Official documentation](https://grafana.com/docs/grafana/latest/administration/manage-users-and-permissions/manage-teams/)
+* [HTTP API](https://grafana.com/docs/grafana/latest/http_api/team/)
+`,
+		ReadContext: dataSourceTeamRead,
+		Schema: map[string]*schema.Schema{
+			"name": {
+				Type:        schema.TypeString,
+				Required:    true,
+				Description: "The name of the Grafana team.",
+			},
+		},
+	}
+}
+
+func findTeamWithName(client *gapi.Client, name string) (*gapi.Team, error) {
+	searchTeam, err := client.SearchTeam(name)
+	if err != nil {
+		return nil, err
+	}
+
+	for _, f := range searchTeam.Teams {
+		if f.Name == name {
+			// Query the team by ID, that API has additional information
+			return client.Team(f.ID)
+		}
+	}
+
+	return nil, fmt.Errorf("no team with name %q", name)
+}
+
+func dataSourceTeamRead(ctx context.Context, d *schema.ResourceData, meta interface{}) diag.Diagnostics {
+	client := meta.(*client).gapi
+	name := d.Get("name").(string)
+	team, err := findTeamWithName(client, name)
+
+	if err != nil {
+		return diag.FromErr(err)
+	}
+
+	id := strconv.FormatInt(team.ID, 10)
+	d.SetId(id)
+	d.Set("name", team.Name)
+
+	return nil
+}

grafana/data_source_team_test.go

@@ -0,0 +1,34 @@
+package grafana
+
+import (
+	"testing"
+
+	gapi "github.com/grafana/grafana-api-golang-client"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/resource"
+)
+
+func TestAccDatasourceTeam(t *testing.T) {
+	CheckOSSTestsEnabled(t)
+
+	var team gapi.Team
+	checks := []resource.TestCheckFunc{
+		testAccTeamCheckExists("grafana_team.test", &team),
+		resource.TestCheckResourceAttr(
+			"data.grafana_team.from_name", "name", "test-team",
+		),
+		resource.TestMatchResourceAttr(
+			"data.grafana_team.from_name", "id", idRegexp,
+		),
+	}
+
+	resource.Test(t, resource.TestCase{
+		ProviderFactories: testAccProviderFactories,
+		CheckDestroy:      testAccTeamCheckDestroy(&team),
+		Steps: []resource.TestStep{
+			{
+				Config: testAccExample(t, "data-sources/grafana_team/data-source.tf"),
+				Check:  resource.ComposeTestCheckFunc(checks...),
+			},
+		},
+	})
+}

grafana/provider.go

@@ -208,6 +208,7 @@ func Provider(version string) func() *schema.Provider {
 				"grafana_folder":        DatasourceFolder(),
 				"grafana_library_panel": DatasourceLibraryPanel(),
 				"grafana_user":          DatasourceUser(),
+				"grafana_team":          DatasourceTeam(),
 				"grafana_organization":  DatasourceOrganization(),
 
 				// Cloud