--- # ---------------------------------------------------------------------------- # # *** AUTO GENERATED CODE *** AUTO GENERATED CODE *** # # ---------------------------------------------------------------------------- # # 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. # # ---------------------------------------------------------------------------- layout: "google" page_title: "Google: google_compute_backend_bucket" sidebar_current: "docs-google-compute-backend-bucket" description: |- Backend buckets allow you to use Google Cloud Storage buckets with HTTP(S) load balancing. --- # google\_compute\_backend\_bucket Backend buckets allow you to use Google Cloud Storage buckets with HTTP(S) load balancing. An HTTP(S) load balancer can direct traffic to specified URLs to a backend bucket rather than a backend service. It can send requests for static content to a Cloud Storage bucket and requests for dynamic content a virtual machine instance. To get more information about BackendBucket, see: * [API documentation](https://cloud.google.com/compute/docs/reference/latest/backendBuckets) * How-to Guides * [Using a Cloud Storage bucket as a load balancer backend](https://cloud.google.com/compute/docs/load-balancing/http/backend-bucket)
## Example Usage - Backend Bucket Basic ```hcl resource "google_compute_backend_bucket" "image_backend" { name = "image-backend-bucket" description = "Contains beautiful images" bucket_name = "${google_storage_bucket.image_bucket.name}" enable_cdn = true } resource "google_storage_bucket" "image_bucket" { name = "image-store-bucket" location = "EU" } ``` ## Argument Reference The following arguments are supported: * `bucket_name` - (Required) Cloud Storage bucket name. * `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. - - - * `description` - (Optional) An optional textual description of the resource; provided by the client when the resource is created. * `enable_cdn` - (Optional) If true, enable Cloud CDN for this BackendBucket. * `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: * `creation_timestamp` - Creation timestamp in RFC3339 text format. * `self_link` - The URI of the created resource. ## Timeouts This resource provides the following [Timeouts](/docs/configuration/resources.html#timeouts) configuration options: - `create` - Default is 4 minutes. - `update` - Default is 4 minutes. - `delete` - Default is 4 minutes. ## Import BackendBucket can be imported using any of these accepted formats: ``` $ terraform import google_compute_backend_bucket.default projects/{{project}}/global/backendBuckets/{{name}} $ terraform import google_compute_backend_bucket.default {{project}}/{{name}} $ terraform import google_compute_backend_bucket.default {{name}} ``` -> If you're importing a resource with beta features, make sure to include `-provider=google-beta" as an argument so that Terraform uses the correct provider to import your resource.