feat: Data source for workspace tags in an organization

CHANGELOG.md

@@ -1,6 +1,7 @@
 ## Unreleased
 
 FEATURES:
+* **New Data Source**: d/tfe_organization_workspace_tags is a new datasource to allow reading workspace tags within an organization, by @rhughes1 ([#773](https://github.com/hashicorp/terraform-provider-tfe/pull/773))
 
 ENHANCEMENTS:
 

tfe/data_source_organization_workspace_tags.go

@@ -0,0 +1,81 @@
+package tfe
+
+import (
+	"fmt"
+	"strconv"
+
+	tfe "github.com/hashicorp/go-tfe"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
+)
+
+func dataSourceTFEOrganizationWorkspaceTags() *schema.Resource {
+	return &schema.Resource{
+		Read: dataSourceTFEOrganizationWorkspaceTagsRead,
+
+		Schema: map[string]*schema.Schema{
+			"organization": {
+				Type:     schema.TypeString,
+				Optional: true,
+			},
+			"tags": {
+				Type:     schema.TypeList,
+				Computed: true,
+				Elem: &schema.Resource{
+					Schema: map[string]*schema.Schema{
+						"name": {
+							Type:     schema.TypeString,
+							Computed: true,
+						},
+
+						"id": {
+							Type:     schema.TypeString,
+							Computed: true,
+						},
+
+						"workspace_count": {
+							Type:     schema.TypeString,
+							Computed: true,
+						},
+					},
+				},
+			},
+		},
+	}
+}
+
+func dataSourceTFEOrganizationWorkspaceTagsRead(d *schema.ResourceData, meta interface{}) error {
+	tfeClient := meta.(ConfiguredClient)
+
+	organizationName, err := tfeClient.schemaOrDefaultOrganization(d)
+	if err != nil {
+		return err
+	}
+
+	var tags []map[string]string
+
+	options := tfe.OrganizationTagsListOptions{}
+	for {
+		organizationTagsList, err := tfeClient.Client.OrganizationTags.List(ctx, organizationName, &options)
+		if err != nil {
+			return fmt.Errorf("Error retrieving organization workspace tags: %w", err)
+		}
+
+		for _, orgTag := range organizationTagsList.Items {
+			tag := map[string]string{"id": orgTag.ID, "name": orgTag.Name, "workspace_count": strconv.Itoa(orgTag.InstanceCount)}
+			tags = append(tags, tag)
+		}
+
+		// Exit the loop when we've seen all pages.
+		if organizationTagsList.CurrentPage >= organizationTagsList.TotalPages {
+			break
+		}
+
+		// Update the page number to get the next page.
+		options.PageNumber = organizationTagsList.NextPage
+	}
+
+	d.Set("tags", tags)
+	d.SetId(organizationName)
+
+	return nil
+}

tfe/data_source_organization_workspace_tags_test.go

@@ -0,0 +1,60 @@
+package tfe
+
+import (
+	"fmt"
+	"math/rand"
+	"testing"
+	"time"
+
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/resource"
+)
+
+func TestAccTFEOrganizationWorkspaceTagsDataSource_basic(t *testing.T) {
+	rInt := rand.New(rand.NewSource(time.Now().UnixNano())).Int()
+	orgName := fmt.Sprintf("tst-terraform-%d", rInt)
+
+	resource.Test(t, resource.TestCase{
+		PreCheck:  func() { testAccPreCheck(t) },
+		Providers: testAccProviders,
+		Steps: []resource.TestStep{
+			{
+				Config: testAccTFEOrganizationWorkspaceTagsDataSourceConfig(rInt),
+				Check: resource.ComposeAggregateTestCheckFunc(
+					resource.TestCheckResourceAttr(
+						"data.tfe_organization_workspace_tags.foobar", "organization", orgName),
+					resource.TestCheckResourceAttrSet("data.tfe_organization_workspace_tags.foobar", "tags"),
+				),
+			},
+		},
+	})
+}
+
+func testAccTFEOrganizationWorkspaceTagsDataSourceConfig(rInt int) string {
+	return fmt.Sprintf(`
+	resource "tfe_organization" "foobar" {
+		name  = "tst-terraform-%d"
+		email = "[email protected]"
+	  }
+
+	  resource "tfe_workspace" "foobar" {
+		name                  = "workspace-test-%d"
+		organization          = tfe_organization.foobar.id
+		description           = "provider-testing"
+		allow_destroy_plan    = false
+		auto_apply            = true
+		file_triggers_enabled = true
+		queue_all_runs        = false
+		speculative_enabled   = true
+		assessments_enabled       = false
+		tag_names             = ["modules", "shared"]
+		terraform_version     = "0.11.1"
+		trigger_prefixes      = ["/modules", "/shared"]
+		working_directory     = "terraform/test"
+		global_remote_state   = true
+	  }
+
+	  data "tfe_organization_workspace_tags" "foobar" {
+		organization = tfe_workspace.foobar.organization
+		depends_on   = [tfe_workspace.foobar]
+	  }`, rInt, rInt)
+}

tfe/provider.go

@@ -106,25 +106,25 @@ func Provider() *schema.Provider {
 		},
 
 		DataSourcesMap: map[string]*schema.Resource{
-			"tfe_organizations":           dataSourceTFEOrganizations(),
-			"tfe_organization":            dataSourceTFEOrganization(),
-			"tfe_agent_pool":              dataSourceTFEAgentPool(),
-			"tfe_ip_ranges":               dataSourceTFEIPRanges(),
-			"tfe_oauth_client":            dataSourceTFEOAuthClient(),
-			"tfe_organization_membership": dataSourceTFEOrganizationMembership(),
-			"tfe_organization_run_task":   dataSourceTFEOrganizationRunTask(),
-			"tfe_slug":                    dataSourceTFESlug(),
-			"tfe_ssh_key":                 dataSourceTFESSHKey(),
-			"tfe_team":                    dataSourceTFETeam(),
-			"tfe_team_access":             dataSourceTFETeamAccess(),
-			"tfe_team_project_access":     dataSourceTFETeamProjectAccess(),
-			"tfe_workspace":               dataSourceTFEWorkspace(),
-			"tfe_workspace_ids":           dataSourceTFEWorkspaceIDs(),
-			"tfe_workspace_run_task":      dataSourceTFEWorkspaceRunTask(),
-			"tfe_variables":               dataSourceTFEWorkspaceVariables(),
-			"tfe_variable_set":            dataSourceTFEVariableSet(),
-			"tfe_policy_set":              dataSourceTFEPolicySet(),
-			"tfe_organization_members":    dataSourceTFEOrganizationMembers(),
+			"tfe_organizations":               dataSourceTFEOrganizations(),
+			"tfe_organization":                dataSourceTFEOrganization(),
+			"tfe_agent_pool":                  dataSourceTFEAgentPool(),
+			"tfe_ip_ranges":                   dataSourceTFEIPRanges(),
+			"tfe_oauth_client":                dataSourceTFEOAuthClient(),
+			"tfe_organization_membership":     dataSourceTFEOrganizationMembership(),
+			"tfe_organization_run_task":       dataSourceTFEOrganizationRunTask(),
+			"tfe_organization_workspace_tags": dataSourceTFEOrganizationWorkspaceTags(),
+			"tfe_slug":                        dataSourceTFESlug(),
+			"tfe_ssh_key":                     dataSourceTFESSHKey(),
+			"tfe_team":                        dataSourceTFETeam(),
+			"tfe_team_access":                 dataSourceTFETeamAccess(),
+			"tfe_workspace":                   dataSourceTFEWorkspace(),
+			"tfe_workspace_ids":               dataSourceTFEWorkspaceIDs(),
+			"tfe_workspace_run_task":          dataSourceTFEWorkspaceRunTask(),
+			"tfe_variables":                   dataSourceTFEWorkspaceVariables(),
+			"tfe_variable_set":                dataSourceTFEVariableSet(),
+			"tfe_policy_set":                  dataSourceTFEPolicySet(),
+			"tfe_organization_members":        dataSourceTFEOrganizationMembers(),
 		},
 
 		ResourcesMap: map[string]*schema.Resource{

website/docs/d/organization_workspace_tags.html.markdown

@@ -0,0 +1,36 @@
+---
+layout: "tfe"
+page_title: "Terraform Enterprise: tfe_organization_workspace_tags"
+description: |-
+  Get information on an organization's workspace tags.
+---
+
+# Data Source: tfe_organization_workspace_tags
+
+Use this data source to get information about the workspace tags for a given organization.
+
+## Example Usage
+
+```hcl
+data "tfe_organization_workspace_tags" "example" {
+  organization = "my-org-name"
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `organization` - (Required) Name of the organization.
+
+## Attributes Reference
+
+In addition to all arguments above, the following attributes are exported:
+
+* `tags` - A list of workspace tags within the organization
+
+The `tag` block contains:
+
+* `name` - The name of the workspace tag
+* `id` - The ID of the workspace tag
+* `workspace_count` - The number of workspaces the tag is associate with