blob: 8c156b868c4bf7a4c290700fbc6bbb652bf5e1be [file] [log] [blame] [edit]
---
# ----------------------------------------------------------------------------
#
# *** 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: "Cloud VMware Engine"
description: |-
An allocated external IP address and its corresponding internal IP address in a private cloud.
---
# google_vmwareengine_external_address
An allocated external IP address and its corresponding internal IP address in a private cloud.
To get more information about ExternalAddress, see:
* [API documentation](https://cloud.google.com/vmware-engine/docs/reference/rest/v1/projects.locations.privateClouds.externalAddresses)
## Example Usage - Vmware Engine External Address Basic
```hcl
resource "google_vmwareengine_network" "external-address-nw" {
name = "pc-nw"
location = "global"
type = "STANDARD"
description = "PC network description."
}
resource "google_vmwareengine_private_cloud" "external-address-pc" {
location = "-a"
name = "sample-pc"
description = "Sample test PC."
network_config {
management_cidr = "192.168.50.0/24"
vmware_engine_network = google_vmwareengine_network.external-address-nw.id
}
management_cluster {
cluster_id = "sample-mgmt-cluster"
node_type_configs {
node_type_id = "standard-72"
node_count = 3
}
}
}
resource "google_vmwareengine_network_policy" "external-address-np" {
location = ""
name = "sample-np"
edge_services_cidr = "192.168.30.0/26"
vmware_engine_network = google_vmwareengine_network.external-address-nw.id
}
resource "google_vmwareengine_external_address" "vmw-engine-external-address" {
name = "sample-external-address"
parent = google_vmwareengine_private_cloud.external-address-pc.id
internal_ip = "192.168.0.66"
description = "Sample description."
depends_on = [
google_vmwareengine_network_policy.external-address-np,
]
}
```
## Argument Reference
The following arguments are supported:
* `internal_ip` -
(Required)
The internal IP address of a workload VM.
* `parent` -
(Required)
The resource name of the private cloud to create a new external address in.
Resource names are schemeless URIs that follow the conventions in https://cloud.google.com/apis/design/resource_names.
For example: projects/my-project/locations/us-west1-a/privateClouds/my-cloud
* `name` -
(Required)
The ID of the external IP Address.
- - -
* `description` -
(Optional)
User-provided description for this resource.
## Attributes Reference
In addition to the arguments listed above, the following computed attributes are exported:
* `id` - an identifier for the resource with format `{{parent}}/externalAddresses/{{name}}`
* `create_time` -
Creation time of this resource.
A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and
up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
* `update_time` -
Last updated time of this resource.
A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine
fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
* `external_ip` -
The external IP address of a workload VM.
* `state` -
State of the resource.
* `uid` -
System-generated unique identifier for the resource.
## Timeouts
This resource provides the following
[Timeouts](https://developer.hashicorp.com/terraform/plugin/sdkv2/resources/retries-and-customizable-timeouts) configuration options:
- `create` - Default is 40 minutes.
- `update` - Default is 20 minutes.
- `delete` - Default is 20 minutes.
## Import
ExternalAddress can be imported using any of these accepted formats:
* `{{parent}}/externalAddresses/{{name}}`
In Terraform v1.5.0 and later, use an [`import` block](https://developer.hashicorp.com/terraform/language/import) to import ExternalAddress using one of the formats above. For example:
```tf
import {
id = "{{parent}}/externalAddresses/{{name}}"
to = google_vmwareengine_external_address.default
}
```
When using the [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import), ExternalAddress can be imported using one of the formats above. For example:
```
$ terraform import google_vmwareengine_external_address.default {{parent}}/externalAddresses/{{name}}
```