blob: f4d303d27147750afc1f21f32f286b06c6811412 [file] [log] [blame] [edit]
---
subcategory: "Cloud Billing"
description: |-
Get information about a Google Billing Account.
---
# google_billing_account
Use this data source to get information about a Google Billing Account.
```hcl
data "google_billing_account" "acct" {
display_name = "My Billing Account"
open = true
}
resource "google_project" "my_project" {
name = "My Project"
project_id = "your-project-id"
org_id = "1234567"
billing_account = data.google_billing_account.acct.id
}
```
## Argument Reference
The arguments of this data source act as filters for querying the available billing accounts.
The given filters must match exactly one billing account whose data will be exported as attributes.
The following arguments are supported:
* `billing_account` (Optional) - The name of the billing account in the form `{billing_account_id}` or `billingAccounts/{billing_account_id}`.
* `display_name` (Optional) - The display name of the billing account.
* `open` (Optional) - `true` if the billing account is open, `false` if the billing account is closed.
* `lookup_projects` (Optional) - `true` if projects associated with the billing account should be read, `false` if this step
should be skipped. Setting `false` may be useful if the user permissions do not allow listing projects. Defaults to `true`.
~> **NOTE:** One of `billing_account` or `display_name` must be specified.
## Attributes Reference
The following additional attributes are exported:
* `id` - The billing account ID.
* `name` - The resource name of the billing account in the form `billingAccounts/{billing_account_id}`.
* `project_ids` - The IDs of any projects associated with the billing account. `lookup_projects` must not be false
for this to be populated.