diff --git a/.changelog/12486.txt b/.changelog/12486.txt new file mode 100644 index 00000000000..cc85e478c01 --- /dev/null +++ b/.changelog/12486.txt @@ -0,0 +1,3 @@ +```release-note:new-resource +`google_network_security_intercept_deployment_group` +``` \ No newline at end of file diff --git a/google/services/networksecurity/resource_network_security_intercept_deployment_group_generated_test.go b/google/services/networksecurity/resource_network_security_intercept_deployment_group_generated_test.go new file mode 100644 index 00000000000..8380ac5af78 --- /dev/null +++ b/google/services/networksecurity/resource_network_security_intercept_deployment_group_generated_test.go @@ -0,0 +1,3 @@ +// Copyright (c) HashiCorp, Inc. +// SPDX-License-Identifier: MPL-2.0 +package networksecurity_test diff --git a/website/docs/r/network_security_intercept_deployment_group.html.markdown b/website/docs/r/network_security_intercept_deployment_group.html.markdown new file mode 100644 index 00000000000..98a5cff5c4e --- /dev/null +++ b/website/docs/r/network_security_intercept_deployment_group.html.markdown @@ -0,0 +1,171 @@ +--- +# ---------------------------------------------------------------------------- +# +# *** 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: |- + A Deployment Group represents the collector deployments across different zones within an organization. +--- + +# google_network_security_intercept_deployment_group + +A Deployment Group represents the collector deployments across different zones within an organization. + +~> **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. + + +
+ + Open in Cloud Shell + +
+## Example Usage - Network Security Intercept Deployment Group Basic + + +```hcl +resource "google_compute_network" "network" { + provider = google-beta + name = "example-network" + auto_create_subnetworks = false +} + +resource "google_network_security_intercept_deployment_group" "default" { + provider = google-beta + intercept_deployment_group_id = "example-dg" + location = "global" + network = google_compute_network.network.id + labels = { + foo = "bar" + } +} +``` + +## Argument Reference + +The following arguments are supported: + + +* `network` - + (Required) + Required. Immutable. The network that is being used for the deployment. Format is: + projects/{project}/global/networks/{network}. + +* `location` - + (Required) + Resource ID segment making up resource `name`. It identifies the resource within its parent collection as described in https://google.aip.dev/122. See documentation for resource type `networksecurity.googleapis.com/InterceptDeploymentGroup`. + +* `intercept_deployment_group_id` - + (Required) + Required. Id of the requesting object + If auto-generating Id server-side, remove this field and + intercept_deployment_group_id from the method_signature of Create RPC + + +- - - + + +* `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. + +* `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}}/interceptDeploymentGroups/{{intercept_deployment_group_id}}` + +* `name` - + Output only. Identifier. Then name of the InterceptDeploymentGroup. + +* `create_time` - + Output only. [Output only] Create time stamp + +* `update_time` - + Output only. [Output only] Update time stamp + +* `connected_endpoint_groups` - + Output only. The list of Intercept Endpoint Groups that are connected to this resource. + Structure is [documented below](#nested_connected_endpoint_groups). + +* `state` - + Output only. Current state of the deployment group. + Possible values: + STATE_UNSPECIFIED + ACTIVE + CREATING + DELETING + +* `reconciling` - + Output only. Whether reconciling is in progress, recommended per + https://google.aip.dev/128. + +* `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. + + +The `connected_endpoint_groups` block contains: + +* `name` - + (Output) + Output only. A connected intercept endpoint group. + +## 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 + + +InterceptDeploymentGroup can be imported using any of these accepted formats: + +* `projects/{{project}}/locations/{{location}}/interceptDeploymentGroups/{{intercept_deployment_group_id}}` +* `{{project}}/{{location}}/{{intercept_deployment_group_id}}` +* `{{location}}/{{intercept_deployment_group_id}}` + + +In Terraform v1.5.0 and later, use an [`import` block](https://developer.hashicorp.com/terraform/language/import) to import InterceptDeploymentGroup using one of the formats above. For example: + +```tf +import { + id = "projects/{{project}}/locations/{{location}}/interceptDeploymentGroups/{{intercept_deployment_group_id}}" + to = google_network_security_intercept_deployment_group.default +} +``` + +When using the [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import), InterceptDeploymentGroup can be imported using one of the formats above. For example: + +``` +$ terraform import google_network_security_intercept_deployment_group.default projects/{{project}}/locations/{{location}}/interceptDeploymentGroups/{{intercept_deployment_group_id}} +$ terraform import google_network_security_intercept_deployment_group.default {{project}}/{{location}}/{{intercept_deployment_group_id}} +$ terraform import google_network_security_intercept_deployment_group.default {{location}}/{{intercept_deployment_group_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).