Represents a Global Address resource. Global addresses are used for HTTP(S) load balancing.
To get more information about GlobalAddress, see:
resource "google_compute_global_address" "default" {
name = "global-appserver-ip"
}
resource "google_compute_global_address" "default" {
provider = google-beta
name = "global-psconnect-ip"
address_type = "INTERNAL"
purpose = "PRIVATE_SERVICE_CONNECT"
network = google_compute_network.network.id
address = "100.100.100.105"
}
resource "google_compute_network" "network" {
provider = google-beta
name = "my-network-name"
auto_create_subnetworks = false
}
The following arguments are supported:
name
-
(Required)
Name of the resource. Provided by the client when the resource is
created. The name must be 1-63 characters long, and comply with
RFC1035. Specifically, the name must be 1-63 characters long and
match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?
which means
the first character must be a lowercase letter, and all following
characters must be a dash, lowercase letter, or digit, except the last
character, which cannot be a dash.address
-
(Optional)
The IP address or beginning of the address range represented by this
resource. This can be supplied as an input to reserve a specific
address or omitted to allow GCP to choose a valid one for you.
description
-
(Optional)
An optional description of this resource.
labels
-
(Optional, Beta)
Labels to apply to this address. A list of 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.
ip_version
-
(Optional)
The IP Version that will be used by this address. The default value is IPV4
.
Possible values are: IPV4
, IPV6
.
prefix_length
-
(Optional)
The prefix length of the IP range. If not present, it means the
address field is a single IP address.
This field is not applicable to addresses with addressType=INTERNAL
when purpose=PRIVATE_SERVICE_CONNECT
address_type
-
(Optional)
The type of the address to reserve.
EXTERNAL
.
Possible values are: EXTERNAL
, INTERNAL
.purpose
-
(Optional)
The purpose of the resource. Possible values include:
network
-
(Optional)
The URL of the network in which to reserve the IP range. The IP range
must be in RFC1918 space. The network cannot be deleted if there are
any reserved IP ranges referring to it.
This should only be set when using an Internal address.
project
- (Optional) The ID of the project in which the resource belongs.
If it is not provided, the provider project is used.
In addition to the arguments listed above, the following computed attributes are exported:
id
- an identifier for the resource with format projects/{{project}}/global/addresses/{{name}}
creation_timestamp
-
Creation timestamp in RFC3339 text format.
label_fingerprint
-
(Beta)
The fingerprint used for optimistic locking of this resource. Used
internally during updates.
terraform_labels
-
(Beta)
The combination of labels configured directly on the resource
and default labels configured on the provider.
effective_labels
-
(Beta)
All of labels (key/value pairs) present on the resource in GCP, including the labels configured through Terraform, other clients and services.
self_link
- The URI of the created resource.This resource provides the following Timeouts configuration options:
create
- Default is 20 minutes.update
- Default is 20 minutes.delete
- Default is 20 minutes.GlobalAddress can be imported using any of these accepted formats:
projects/{{project}}/global/addresses/{{name}}
{{project}}/{{name}}
{{name}}
In Terraform v1.5.0 and later, use an import
block to import GlobalAddress using one of the formats above. For example:
import {
id = "projects/{{project}}/global/addresses/{{name}}"
to = google_compute_global_address.default
}
When using the terraform import
command, GlobalAddress can be imported using one of the formats above. For example:
$ terraform import google_compute_global_address.default projects/{{project}}/global/addresses/{{name}}
$ terraform import google_compute_global_address.default {{project}}/{{name}}
$ terraform import google_compute_global_address.default {{name}}
This resource supports User Project Overrides.