feat(billingbudget): support project level recicipients on budgets (#10926) (#18437)

[upstream:81488b892dcb7a9e33c3718a1fbcbdd434860d7c]

Signed-off-by: Modular Magician <[email protected]>

Author: modular-magician

.changelog/10926.txt

@@ -0,0 +1,3 @@
+```release-note:enhancement
+billingbudget: added `enable_project_level_recipients` field to `google_billing_budget` resource
+```

google/services/billing/resource_billing_budget.go

@@ -152,6 +152,16 @@ those with Billing Account Administrators and Billing
 Account Users IAM roles for the target account.`,
 							Default: false,
 						},
+						"enable_project_level_recipients": {
+							Type:     schema.TypeBool,
+							Optional: true,
+							Description: `When set to true, and when the budget has a single project configured,
+notifications will be sent to project level recipients of that project.
+This field will be ignored if the budget has multiple or no project configured.
+
+Currently, project level recipients are the users with Owner role on a cloud project.`,
+							Default: false,
+						},
 						"monitoring_notification_channels": {
 							Type:     schema.TypeList,
 							Optional: true,
@@ -651,7 +661,8 @@ func resourceBillingBudgetUpdate(d *schema.ResourceData, meta interface{}) error
 		updateMask = append(updateMask, "notificationsRule.pubsubTopic",
 			"notificationsRule.schemaVersion",
 			"notificationsRule.monitoringNotificationChannels",
-			"notificationsRule.disableDefaultIamRecipients")
+			"notificationsRule.disableDefaultIamRecipients",
+			"notificationsRule.enableProjectLevelRecipients")
 	}
 
 	if d.HasChange("ownership_scope") {
@@ -1110,6 +1121,8 @@ func flattenBillingBudgetAllUpdatesRule(v interface{}, d *schema.ResourceData, c
 		flattenBillingBudgetAllUpdatesRuleMonitoringNotificationChannels(original["monitoringNotificationChannels"], d, config)
 	transformed["disable_default_iam_recipients"] =
 		flattenBillingBudgetAllUpdatesRuleDisableDefaultIamRecipients(original["disableDefaultIamRecipients"], d, config)
+	transformed["enable_project_level_recipients"] =
+		flattenBillingBudgetAllUpdatesRuleEnableProjectLevelRecipients(original["enableProjectLevelRecipients"], d, config)
 	return []interface{}{transformed}
 }
 func flattenBillingBudgetAllUpdatesRulePubsubTopic(v interface{}, d *schema.ResourceData, config *transport_tpg.Config) interface{} {
@@ -1132,6 +1145,10 @@ func flattenBillingBudgetAllUpdatesRuleDisableDefaultIamRecipients(v interface{}
 	return v
 }
 
+func flattenBillingBudgetAllUpdatesRuleEnableProjectLevelRecipients(v interface{}, d *schema.ResourceData, config *transport_tpg.Config) interface{} {
+	return v
+}
+
 func flattenBillingBudgetOwnershipScope(v interface{}, d *schema.ResourceData, config *transport_tpg.Config) interface{} {
 	return v
 }
@@ -1525,6 +1542,13 @@ func expandBillingBudgetAllUpdatesRule(v interface{}, d tpgresource.TerraformRes
 		transformed["disableDefaultIamRecipients"] = transformedDisableDefaultIamRecipients
 	}
 
+	transformedEnableProjectLevelRecipients, err := expandBillingBudgetAllUpdatesRuleEnableProjectLevelRecipients(original["enable_project_level_recipients"], d, config)
+	if err != nil {
+		return nil, err
+	} else if val := reflect.ValueOf(transformedEnableProjectLevelRecipients); val.IsValid() && !tpgresource.IsEmptyValue(val) {
+		transformed["enableProjectLevelRecipients"] = transformedEnableProjectLevelRecipients
+	}
+
 	return transformed, nil
 }
 
@@ -1544,6 +1568,10 @@ func expandBillingBudgetAllUpdatesRuleDisableDefaultIamRecipients(v interface{},
 	return v, nil
 }
 
+func expandBillingBudgetAllUpdatesRuleEnableProjectLevelRecipients(v interface{}, d tpgresource.TerraformResourceData, config *transport_tpg.Config) (interface{}, error) {
+	return v, nil
+}
+
 func expandBillingBudgetOwnershipScope(v interface{}, d tpgresource.TerraformResourceData, config *transport_tpg.Config) (interface{}, error) {
 	return v, nil
 }

google/services/billing/resource_billing_budget_generated_test.go

@@ -279,6 +279,64 @@ resource "google_monitoring_notification_channel" "notification_channel" {
 `, context)
 }
 
+func TestAccBillingBudget_billingBudgetNotifyProjectRecipientExample(t *testing.T) {
+	t.Parallel()
+
+	context := map[string]interface{}{
+		"billing_acct":  envvar.GetTestMasterBillingAccountFromEnv(t),
+		"random_suffix": acctest.RandString(t, 10),
+	}
+
+	acctest.VcrTest(t, resource.TestCase{
+		PreCheck:                 func() { acctest.AccTestPreCheck(t) },
+		ProtoV5ProviderFactories: acctest.ProtoV5ProviderFactories(t),
+		CheckDestroy:             testAccCheckBillingBudgetDestroyProducer(t),
+		Steps: []resource.TestStep{
+			{
+				Config: testAccBillingBudget_billingBudgetNotifyProjectRecipientExample(context),
+			},
+			{
+				ResourceName:            "google_billing_budget.budget",
+				ImportState:             true,
+				ImportStateVerify:       true,
+				ImportStateVerifyIgnore: []string{"billing_account"},
+			},
+		},
+	})
+}
+
+func testAccBillingBudget_billingBudgetNotifyProjectRecipientExample(context map[string]interface{}) string {
+	return acctest.Nprintf(`
+data "google_billing_account" "account" {
+  billing_account = "%{billing_acct}"
+}
+
+data "google_project" "project" {
+}
+
+resource "google_billing_budget" "budget" {
+  billing_account = data.google_billing_account.account.id
+  display_name    = "Example Billing Budget%{random_suffix}"
+
+  budget_filter {
+    projects = ["projects/${data.google_project.project.number}"]
+  }
+
+  amount {
+    specified_amount {
+      currency_code = "USD"
+      units         = "100000"
+    }
+  }
+
+  all_updates_rule {
+    monitoring_notification_channels = []
+    enable_project_level_recipients  = true
+  }
+}
+`, context)
+}
+
 func TestAccBillingBudget_billingBudgetCustomperiodExample(t *testing.T) {
 	t.Parallel()
 

website/docs/r/billing_budget.html.markdown

@@ -177,6 +177,38 @@ resource "google_monitoring_notification_channel" "notification_channel" {
   }
 }
 ```
+## Example Usage - Billing Budget Notify Project Recipient
+
+
+```hcl
+data "google_billing_account" "account" {
+  billing_account = "000000-0000000-0000000-000000"
+}
+
+data "google_project" "project" {
+}
+
+resource "google_billing_budget" "budget" {
+  billing_account = data.google_billing_account.account.id
+  display_name    = "Example Billing Budget"
+
+  budget_filter {
+    projects = ["projects/${data.google_project.project.number}"]
+  }
+
+  amount {
+    specified_amount {
+      currency_code = "USD"
+      units         = "100000"
+    }
+  }
+
+  all_updates_rule {
+    monitoring_notification_channels = []
+    enable_project_level_recipients  = true
+  }
+}
+```
 ## Example Usage - Billing Budget Customperiod
 
 
@@ -470,6 +502,13 @@ The following arguments are supported:
   those with Billing Account Administrators and Billing
   Account Users IAM roles for the target account.
 
+* `enable_project_level_recipients` -
+  (Optional)
+  When set to true, and when the budget has a single project configured,
+  notifications will be sent to project level recipients of that project.
+  This field will be ignored if the budget has multiple or no project configured.
+  Currently, project level recipients are the users with Owner role on a cloud project.
+
 ## Attributes Reference
 
 In addition to the arguments listed above, the following computed attributes are exported: