feat(resourcemanager): add data source for retrieving all organizations

Author: bestefreund

mmv1/third_party/terraform/provider/provider_mmv1_resources.go.tmpl

@@ -184,6 +184,7 @@ var handwrittenDatasources = map[string]*schema.Resource{
 	"google_oracle_database_cloud_vm_clusters":			oracledatabase.DataSourceOracleDatabaseCloudVmClusters(),
 	"google_oracle_database_cloud_vm_cluster":          oracledatabase.DataSourceOracleDatabaseCloudVmCluster(),
 	"google_organization":                              resourcemanager.DataSourceGoogleOrganization(),
+	"google_organizations":                             resourcemanager.DataSourceGoogleOrganizations(),
 	{{- if ne $.TargetVersionName "ga" }}
 	"google_parameter_manager_regional_parameter":      parametermanagerregional.DataSourceParameterManagerRegionalRegionalParameter(),
 	{{- end }}

mmv1/third_party/terraform/services/resourcemanager/data_source_google_organizations.go

@@ -0,0 +1,94 @@
+// Copyright (c) HashiCorp, Inc.
+// SPDX-License-Identifier: MPL-2.0
+package resourcemanager
+
+import (
+	"fmt"
+	"path/filepath"
+
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
+	"github.com/hashicorp/terraform-provider-google/google/tpgresource"
+	transport_tpg "github.com/hashicorp/terraform-provider-google/google/transport"
+
+	"google.golang.org/api/cloudresourcemanager/v1"
+)
+
+func DataSourceGoogleOrganizations() *schema.Resource {
+	return &schema.Resource{
+		Read: datasourceGoogleOrganizationsRead,
+		Schema: map[string]*schema.Schema{
+			"filter": {
+				Optional: true,
+				Type:     schema.TypeString,
+			},
+			"organizations": {
+				Computed: true,
+				Type:     schema.TypeList,
+				Elem: &schema.Resource{
+					Schema: map[string]*schema.Schema{
+						"directory_customer_id": {
+							Computed: true,
+							Type:     schema.TypeString,
+						},
+						"display_name": {
+							Computed: true,
+							Type:     schema.TypeString,
+						},
+						"lifecycle_state": {
+							Computed: true,
+							Type:     schema.TypeString,
+						},
+						"name": {
+							Computed: true,
+							Type:     schema.TypeString,
+						},
+						"org_id": {
+							Computed: true,
+							Type:     schema.TypeString,
+						},
+					},
+				},
+			},
+		},
+	}
+}
+
+func datasourceGoogleOrganizationsRead(d *schema.ResourceData, meta interface{}) error {
+	config := meta.(*transport_tpg.Config)
+	userAgent, err := tpgresource.GenerateUserAgentString(d, config.UserAgent)
+	if err != nil {
+		return err
+	}
+
+	organizations := make([]map[string]interface{}, 0)
+
+	filter := ""
+	if v, ok := d.GetOk("filter"); ok {
+		filter = v.(string)
+	}
+
+	organizationList, err := config.NewResourceManagerClient(userAgent).Organizations.Search(&cloudresourcemanager.SearchOrganizationsRequest{
+		Filter: filter,
+	}).Do()
+	if err != nil {
+		return fmt.Errorf("Error retrieving organizations: %s", err)
+	}
+
+	for _, organization := range organizationList.Organizations {
+		organizations = append(organizations, map[string]interface{}{
+			"directory_customer_id": organization.Owner.DirectoryCustomerId,
+			"display_name":          organization.DisplayName,
+			"lifecycle_state":       organization.LifecycleState,
+			"name":                  organization.Name,
+			"org_id":                filepath.Base(organization.Name),
+		})
+	}
+
+	if err := d.Set("organizations", organizations); err != nil {
+		return fmt.Errorf("Error retrieving organizations: %s", err)
+	}
+
+	d.SetId(filter)
+
+	return nil
+}

mmv1/third_party/terraform/services/resourcemanager/data_source_google_organizations_test.go

@@ -0,0 +1,30 @@
+package resourcemanager_test
+
+import (
+	"testing"
+
+	"github.com/hashicorp/terraform-plugin-testing/helper/resource"
+	"github.com/hashicorp/terraform-provider-google/google/acctest"
+)
+
+func TestAccDataSourceGoogleOrganizations_basic(t *testing.T) {
+	t.Parallel()
+
+	acctest.VcrTest(t, resource.TestCase{
+		PreCheck:                 func() { acctest.AccTestPreCheck(t) },
+		ProtoV5ProviderFactories: acctest.ProtoV5ProviderFactories(t),
+		Steps: []resource.TestStep{
+			{
+				Config: `data "google_organizations" "test" {}`,
+				Check: resource.ComposeTestCheckFunc(
+					// We assume that every principal finds at least one organization and we'll only check set-ness
+					resource.TestCheckResourceAttrSet("data.google_organizations.test", "organizations.0.directory_customer_id"),
+					resource.TestCheckResourceAttrSet("data.google_organizations.test", "organizations.0.display_name"),
+					resource.TestCheckResourceAttrSet("data.google_organizations.test", "organizations.0.lifecycle_state"),
+					resource.TestCheckResourceAttrSet("data.google_organizations.test", "organizations.0.name"),
+					resource.TestCheckResourceAttrSet("data.google_organizations.test", "organizations.0.org_id"),
+				),
+			},
+		},
+	})
+}

mmv1/third_party/terraform/website/docs/d/organizations.html.markdown

@@ -0,0 +1,45 @@
+---
+subcategory: "Cloud Platform"
+description: |-
+  Get all organizations.
+---
+
+
+# google_organizations
+
+Gets a list of all organizations.
+See [the official documentation](https://cloud.google.com/resource-manager/docs/creating-managing-organization)
+and [API](https://cloud.google.com/resource-manager/reference/rest/v1/organizations/search).
+
+## Example Usage
+
+```hcl
+data "google_organizations" "example" {
+  filter = "domain:example.com"
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+* `filter` - (Optional) An optional query string used to filter the Organizations to return in the response. Filter rules are case-insensitive. Further information can be found in the [REST API](https://cloud.google.com/resource-manager/reference/rest/v1/organizations/search#request-body).
+
+
+## Attributes Reference
+
+The following attributes are exported:
+
+* `organizations` - A list of all retrieved organizations. Structure is [defined below](#nested_organizations).
+
+<a name="nested_organizations"></a>The `organizations` block supports:
+
+* `directory_customer_id` - The Google for Work customer ID of the Organization.
+
+* `display_name` - A human-readable string that refers to the Organization in the Google Cloud console. The string will be set to the primary domain (for example, `"google.com"`) of the G Suite customer that owns the organization.
+
+* `lifecycle_state` - The Organization's current lifecycle state.
+
+* `name` - The resource name of the Organization in the form `organizations/{organization_id}`.
+
+* `org_id` - The Organization ID.