Add Intercept Endpoint Group Association resource to Network Security. (#12577) (#20761)

[upstream:c53f2b3c7c416174b29f170656da81c320d2e7ed]

Signed-off-by: Modular Magician <magic-modules@google.com>

Author: modular-magician

.changelog/12577.txt

@@ -0,0 +1,3 @@
+```release-note:new-resource
+`google_network_security_intercept_endpoint_group_association` (beta)
+```

google/services/networksecurity/resource_network_security_intercept_endpoint_group_association_generated_test.go

@@ -0,0 +1,3 @@
+// Copyright (c) HashiCorp, Inc.
+// SPDX-License-Identifier: MPL-2.0
+package networksecurity_test

website/docs/r/network_security_intercept_endpoint_group_association.html.markdown

@@ -0,0 +1,206 @@
+---
+# ----------------------------------------------------------------------------
+#
+#     ***     AUTO GENERATED CODE    ***    Type: MMv1     ***
+#
+# ----------------------------------------------------------------------------
+#
+#     This file is automatically generated by Magic Modules and manual
+#     changes will be clobbered when the file is regenerated.
+#
+#     Please read more about how to change this file in
+#     .github/CONTRIBUTING.md.
+#
+# ----------------------------------------------------------------------------
+subcategory: "Network security"
+description: |-
+  Creates an association between a VPC and an Intercept Endpoint Group in order to intercept traffic in that VPC.
+---
+
+# google_network_security_intercept_endpoint_group_association
+
+Creates an association between a VPC and an Intercept Endpoint Group in order to intercept traffic in that VPC.
+
+~> **Warning:** This resource is in beta, and should be used with the terraform-provider-google-beta provider.
+See [Provider Versions](https://terraform.io/docs/providers/google/guides/provider_versions.html) for more details on beta resources.
+
+
+<div class = "oics-button" style="float: right; margin: 0 0 -15px">
+  <a href="https://console.cloud.google.com/cloudshell/open?cloudshell_git_repo=https%3A%2F%2Fgithub.com%2Fterraform-google-modules%2Fdocs-examples.git&cloudshell_image=gcr.io%2Fcloudshell-images%2Fcloudshell%3Alatest&cloudshell_print=.%2Fmotd&cloudshell_tutorial=.%2Ftutorial.md&cloudshell_working_dir=network_security_intercept_endpoint_group_association_basic&open_in_editor=main.tf" target="_blank">
+    <img alt="Open in Cloud Shell" src="//gstatic.com/cloudssh/images/open-btn.svg" style="max-height: 44px; margin: 32px auto; max-width: 100%;">
+  </a>
+</div>
+## Example Usage - Network Security Intercept Endpoint Group Association Basic
+
+
+```hcl
+resource "google_compute_network" "producer_network" {
+  provider                = google-beta
+  name                    = "example-prod-network"
+  auto_create_subnetworks = false
+}
+
+resource "google_compute_network" "consumer_network" {
+  provider                = google-beta
+  name                    = "example-cons-network"
+  auto_create_subnetworks = false
+}
+
+resource "google_network_security_intercept_deployment_group" "deployment_group" {
+  provider                      = google-beta
+  intercept_deployment_group_id = "example-dg"
+  location                      = "global"
+  network                       = google_compute_network.producer_network.id
+}
+
+resource "google_network_security_intercept_endpoint_group" "endpoint_group" {
+  provider                      = google-beta
+  intercept_endpoint_group_id   = "example-eg"
+  location                      = "global"
+  intercept_deployment_group    = google_network_security_intercept_deployment_group.deployment_group.id
+}
+
+resource "google_network_security_intercept_endpoint_group_association" "default" {
+  provider                                = google-beta
+  intercept_endpoint_group_association_id = "example-ega"
+  location                                = "global"
+  network                                 = google_compute_network.consumer_network.id
+  intercept_endpoint_group                = google_network_security_intercept_endpoint_group.endpoint_group.id
+  labels = {
+    foo = "bar"
+  }
+}
+```
+
+## Argument Reference
+
+The following arguments are supported:
+
+
+* `intercept_endpoint_group` -
+  (Required)
+  Immutable. The Intercept Endpoint Group that this resource is connected to. Format
+  is:
+  `projects/{project}/locations/global/interceptEndpointGroups/{interceptEndpointGroup}`.
+
+* `network` -
+  (Required)
+  Immutable. The VPC network associated. Format:
+  `projects/{project}/global/networks/{network}`.
+
+* `location` -
+  (Required)
+  The location of the Intercept Endpoint Group Association, currently restricted to `global`.
+
+
+- - -
+
+
+* `labels` -
+  (Optional)
+  Optional. Labels as key value pairs.
+  **Note**: This field is non-authoritative, and will only manage the labels present in your configuration.
+  Please refer to the field `effective_labels` for all of the labels present on the resource.
+
+* `intercept_endpoint_group_association_id` -
+  (Optional)
+  ID of the Intercept Endpoint Group Association.
+
+* `project` - (Optional) The ID of the project in which the resource belongs.
+    If it is not provided, the provider project is used.
+
+
+## Attributes Reference
+
+In addition to the arguments listed above, the following computed attributes are exported:
+
+* `id` - an identifier for the resource with format `projects/{{project}}/locations/{{location}}/interceptEndpointGroupAssociations/{{intercept_endpoint_group_association_id}}`
+
+* `name` -
+  Identifier. The name of the Intercept Endpoint Group Association.
+
+* `create_time` -
+  Create time stamp.
+
+* `update_time` -
+  Update time stamp.
+
+* `locations_details` -
+  The list of locations that are currently supported by the associated Intercept Deployment Group and their state.
+  Structure is [documented below](#nested_locations_details).
+
+* `state` -
+  Current state of the Intercept Endpoint Group Association. 
+   Possible values:
+   STATE_UNSPECIFIED
+  ACTIVE
+  CREATING
+  DELETING
+  CLOSED
+  OUT_OF_SYNC
+  DELETE_FAILED
+
+* `reconciling` -
+  Whether reconciling is in progress.
+
+* `terraform_labels` -
+  The combination of labels configured directly on the resource
+   and default labels configured on the provider.
+
+* `effective_labels` -
+  All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Terraform, other clients and services.
+
+
+<a name="nested_locations_details"></a>The `locations_details` block contains:
+
+* `location` -
+  (Output)
+  Location supported by the Intercept Deployment Group, for example `us-central1-a`
+
+* `state` -
+  (Output)
+  The association state in this location. 
+   Possible values:
+   STATE_UNSPECIFIED
+  ACTIVE
+  OUT_OF_SYNC
+
+## Timeouts
+
+This resource provides the following
+[Timeouts](https://developer.hashicorp.com/terraform/plugin/sdkv2/resources/retries-and-customizable-timeouts) configuration options:
+
+- `create` - Default is 20 minutes.
+- `update` - Default is 20 minutes.
+- `delete` - Default is 20 minutes.
+
+## Import
+
+
+InterceptEndpointGroupAssociation can be imported using any of these accepted formats:
+
+* `projects/{{project}}/locations/{{location}}/interceptEndpointGroupAssociations/{{intercept_endpoint_group_association_id}}`
+* `{{project}}/{{location}}/{{intercept_endpoint_group_association_id}}`
+* `{{location}}/{{intercept_endpoint_group_association_id}}`
+
+
+In Terraform v1.5.0 and later, use an [`import` block](https://developer.hashicorp.com/terraform/language/import) to import InterceptEndpointGroupAssociation using one of the formats above. For example:
+
+```tf
+import {
+  id = "projects/{{project}}/locations/{{location}}/interceptEndpointGroupAssociations/{{intercept_endpoint_group_association_id}}"
+  to = google_network_security_intercept_endpoint_group_association.default
+}
+```
+
+When using the [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import), InterceptEndpointGroupAssociation can be imported using one of the formats above. For example:
+
+```
+$ terraform import google_network_security_intercept_endpoint_group_association.default projects/{{project}}/locations/{{location}}/interceptEndpointGroupAssociations/{{intercept_endpoint_group_association_id}}
+$ terraform import google_network_security_intercept_endpoint_group_association.default {{project}}/{{location}}/{{intercept_endpoint_group_association_id}}
+$ terraform import google_network_security_intercept_endpoint_group_association.default {{location}}/{{intercept_endpoint_group_association_id}}
+```
+
+## User Project Overrides
+
+This resource supports [User Project Overrides](https://registry.terraform.io/providers/hashicorp/google/latest/docs/guides/provider_reference#user_project_override).