2018-02-13 21:30:17 +00:00
|
|
|
---
|
|
|
|
layout: "google"
|
|
|
|
page_title: "Google: google_project_usage_export_bucket"
|
|
|
|
sidebar_current: "docs-google-project-usage-export-bucket"
|
|
|
|
description: |-
|
2018-09-05 17:31:35 +00:00
|
|
|
Manages a project's usage export bucket.
|
2018-02-13 21:30:17 +00:00
|
|
|
---
|
|
|
|
|
|
|
|
# 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).
|
|
|
|
|
2018-09-05 17:31:35 +00:00
|
|
|
~> **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.
|
2018-02-13 21:30:17 +00:00
|
|
|
|
|
|
|
## Example Usage
|
|
|
|
|
|
|
|
```hcl
|
2018-09-05 17:31:35 +00:00
|
|
|
resource "google_project_usage_export_bucket" "usage_export" {
|
|
|
|
project = "development-project"
|
|
|
|
bucket_name = "usage-tracking-bucket"
|
2018-02-13 21:30:17 +00:00
|
|
|
}
|
|
|
|
```
|
|
|
|
|
|
|
|
## Argument Reference
|
|
|
|
* `bucket_name`: (Required) The bucket to store reports in.
|
2018-09-05 17:31:35 +00:00
|
|
|
|
|
|
|
- - -
|
|
|
|
|
2018-02-13 21:30:17 +00:00
|
|
|
* `prefix`: (Optional) A prefix for the reports, for instance, the project name.
|
|
|
|
|
2018-09-05 17:31:35 +00:00
|
|
|
* `project`: (Optional) The project to set the export bucket on. If it is not provided, the provider project is used.
|
2018-02-13 21:30:17 +00:00
|
|
|
|
2018-09-05 17:31:35 +00:00
|
|
|
## Import
|
|
|
|
|
|
|
|
A project's Usage Export Bucket can be imported using this format:
|
|
|
|
|
|
|
|
```
|
|
|
|
$ terraform import google_project_usage_export_bucket.usage_export {{project}}
|
|
|
|
```
|