terraform-provider-google/website/docs/r/usage_export_bucket.html.markdown

48 lines
1.5 KiB
Markdown

---
layout: "google"
page_title: "Google: google_project_usage_export_bucket"
sidebar_current: "docs-google-project-usage-export-bucket"
description: |-
Manages a project's usage export bucket.
---
# google_project_usage_export_bucket
Sets up a usage export bucket for a particular project. A usage export bucket
is a pre-configured GCS bucket which is set up to receive daily and monthly
reports of the GCE resources used.
For more information see the [Docs](https://cloud.google.com/compute/docs/usage-export)
and for further details, the
[API Documentation](https://cloud.google.com/compute/docs/reference/rest/beta/projects/setUsageExportBucket).
~> **Note:** You should specify only one of these per project. If there are two or more
they will fight over which bucket the reports should be stored in. It is
safe to have multiple resources with the same backing bucket.
## Example Usage
```hcl
resource "google_project_usage_export_bucket" "usage_export" {
project = "development-project"
bucket_name = "usage-tracking-bucket"
}
```
## Argument Reference
* `bucket_name`: (Required) The bucket to store reports in.
- - -
* `prefix`: (Optional) A prefix for the reports, for instance, the project name.
* `project`: (Optional) The project to set the export bucket on. If it is not provided, the provider project is used.
## Import
A project's Usage Export Bucket can be imported using this format:
```
$ terraform import google_project_usage_export_bucket.usage_export {{project}}
```