mirror of
https://github.com/letic/terraform-provider-google.git
synced 2024-09-06 09:06:44 +00:00
ac73bebb15
Rename all ID fields to {resource_noun}_id instead of removing them
outright. This means people can still get at the info.
Leave project's id deleted. It has been marked as Removed for months.
I'm fine with cleaning it up before 1.0.0.
Also, update website docs.
163 lines
4.6 KiB
Markdown
163 lines
4.6 KiB
Markdown
---
|
|
layout: "google"
|
|
page_title: "Google: google_compute_url_map"
|
|
sidebar_current: "docs-google-compute-url-map"
|
|
description: |-
|
|
Manages a URL Map resource in GCE.
|
|
---
|
|
|
|
# google\_compute\_url\_map
|
|
|
|
Manages a URL Map resource within GCE. For more information see
|
|
[the official documentation](https://cloud.google.com/compute/docs/load-balancing/http/url-map)
|
|
and
|
|
[API](https://cloud.google.com/compute/docs/reference/latest/urlMaps).
|
|
|
|
|
|
## Example Usage
|
|
|
|
```hcl
|
|
resource "google_compute_url_map" "foobar" {
|
|
name = "urlmap"
|
|
description = "a description"
|
|
|
|
default_service = "${google_compute_backend_service.home.self_link}"
|
|
|
|
host_rule {
|
|
hosts = ["mysite.com"]
|
|
path_matcher = "allpaths"
|
|
}
|
|
|
|
path_matcher {
|
|
name = "allpaths"
|
|
default_service = "${google_compute_backend_service.home.self_link}"
|
|
|
|
path_rule {
|
|
paths = ["/home"]
|
|
service = "${google_compute_backend_service.home.self_link}"
|
|
}
|
|
|
|
path_rule {
|
|
paths = ["/login"]
|
|
service = "${google_compute_backend_service.login.self_link}"
|
|
}
|
|
|
|
path_rule {
|
|
paths = ["/static"]
|
|
service = "${google_compute_backend_bucket.static.self_link}"
|
|
}
|
|
}
|
|
|
|
test {
|
|
service = "${google_compute_backend_service.home.self_link}"
|
|
host = "hi.com"
|
|
path = "/home"
|
|
}
|
|
}
|
|
|
|
resource "google_compute_backend_service" "login" {
|
|
name = "login-backend"
|
|
port_name = "http"
|
|
protocol = "HTTP"
|
|
timeout_sec = 10
|
|
|
|
health_checks = ["${google_compute_http_health_check.default.self_link}"]
|
|
}
|
|
|
|
resource "google_compute_backend_service" "home" {
|
|
name = "home-backend"
|
|
port_name = "http"
|
|
protocol = "HTTP"
|
|
timeout_sec = 10
|
|
|
|
health_checks = ["${google_compute_http_health_check.default.self_link}"]
|
|
}
|
|
|
|
resource "google_compute_http_health_check" "default" {
|
|
name = "test"
|
|
request_path = "/"
|
|
check_interval_sec = 1
|
|
timeout_sec = 1
|
|
}
|
|
|
|
resource "google_compute_backend_bucket" "static" {
|
|
name = "static-asset-backend-bucket"
|
|
bucket_name = "${google_storage_bucket.static.name}"
|
|
enable_cdn = true
|
|
}
|
|
|
|
resource "google_storage_bucket" "static" {
|
|
name = "static-asset-bucket"
|
|
location = "US"
|
|
}
|
|
```
|
|
|
|
## Argument Reference
|
|
|
|
The following arguments are supported:
|
|
|
|
* `default_service` - (Required) The backend service or backend bucket to use when none of the given rules match.
|
|
|
|
* `name` - (Required) A unique name for the resource, required by GCE.
|
|
Changing this forces a new resource to be created.
|
|
|
|
- - -
|
|
|
|
* `description` - (Optional) A brief description of this resource.
|
|
|
|
* `host_rule` - (Optional) A list of host rules. Multiple blocks of this type are permitted. Structure is documented below.
|
|
|
|
* `path_matcher` - (Optional) A list of paths to match. Structure is documented below.
|
|
|
|
* `project` - (Optional) The project in which the resource belongs. If it
|
|
is not provided, the provider project is used.
|
|
|
|
* `test` - (Optional) The test to perform. Multiple blocks of this type are permitted. Structure is documented below.
|
|
|
|
The `host_rule` block supports:
|
|
|
|
* `hosts` (Required) - The list of [host patterns](https://cloud.google.com/compute/docs/reference/latest/urlMaps#hostRules.hosts)
|
|
to match.
|
|
|
|
* `description` - (Optional) An optional description of the host rule.
|
|
|
|
* `path_matcher` - (Required) The name of the `path_matcher` to apply this host rule to.
|
|
|
|
The `path_matcher` block supports:
|
|
|
|
* `name` - (Required) The name of the `path_matcher` resource.
|
|
|
|
* `default_service` - (Required) The backend service or backend bucket to use if none of the given paths match.
|
|
|
|
* `description` - (Optional) An optional description of the host rule.
|
|
|
|
* `path_rule` - (Optional) A list of path rules. Multiple blocks of this type are permitted. Structure is documented below.
|
|
|
|
The `path_rule` block supports:
|
|
|
|
* `paths` - (Required) The list of [paths](https://cloud.google.com/compute/docs/reference/latest/urlMaps#pathMatchers.pathRules.paths)
|
|
to match against.
|
|
|
|
* `service` - (Required) The backend service or backend bucket to use if any of the given paths match.
|
|
|
|
The `test` block supports:
|
|
|
|
* `service` - (Required) The backend service or backend bucket that should be matched by this test.
|
|
|
|
* `host` - (Required) The host component of the URL being tested.
|
|
|
|
* `path` - (Required) The path component of the URL being tested.
|
|
|
|
* `description` - (Optional) An optional description of this test.
|
|
|
|
## Attributes Reference
|
|
|
|
In addition to the arguments listed above, the following computed attributes are
|
|
exported:
|
|
|
|
* `fingerprint` - The unique fingerprint for this resource.
|
|
|
|
* `map_id` - The GCE assigned ID of the resource.
|
|
|
|
* `self_link` - The URI of the created resource.
|