A Cloud Billing account is used to define who pays for a given set of resources, and it can be linked to one or more projects. Project usage is charged to the linked Cloud Billing account.
This article describes how to verify the billing status of your projects.
Overview
To ensure that billing is enabled on a project, the project must be linked to a valid, active Cloud Billing account. Typically, projects are linked to a billing account at the time that you create the project.
If projects are linked to a Cloud Billing account that is subsequently closed or suspended, then billing is no longer enabled on those projects. If you want to continue using the projects, you must either reopen the billing account, or move the projects to a different, active Cloud Billing account.
It is also possible to unlink a project from a billing account, disabling billing on the project. To continue using the project, you must re-enable billing by linking the project to an active Cloud Billing account.
Refer to the information in this article to help you determine if billing is actively enabled on your projects.
Permissions required for this task
To perform the tasks needed to confirm that billing is enabled on your project, you need a role that includes the following permissions on your Cloud Billing account:
billing.resourceAssociations.list
to view project associations for a billing account.billing.accounts.get
to view basic information about the billing account (such as account name, currency, open/closed status).
To gain these permissions, ask your administrator to grant you one of the following Cloud Billing IAM roles on your Cloud Billing account:
- Billing Account Viewer
- Billing Account Costs Manager
- Billing Account Administrator
For more information about billing permissions, see:
- Overview of Cloud Billing access control
- Create custom roles for Cloud Billing
- Understanding predefined IAM roles for Cloud Billing
Check if billing is enabled on a project
Billing is enabled on a project if the following are true:
- The project is linked to a Cloud Billing account.
- The linked Cloud Billing account is active and in good standing - that is, the billing account is not closed or suspended.
1. Identify the Cloud Billing account linked to a project
Console
To view the Cloud Billing account that is linked to a specific project, do the following:
Sign in to the Google Cloud console.
In the project drop down ( [your project name]
) at the top of the Google Cloud console page, select your project.Open the console Navigation menu (
), and then select Billing.
If a billing account is NOT linked to the project:
If the project is not linked to a Cloud Billing account, you see a pop-up window with text similar to:
"This project has no billing account"
To enable billing on the project, select Link a billing account. Note that you need adequate permissions to link a billing account. See enable billing for an existing project for more information.
To view a list of billing accounts for your organization, select Manage billing accounts.
If a billing account is linked to the project:
If the project is linked to a Cloud Billing account, and if you have only one Cloud Billing account, the Billing Overview page is displayed.
If the project is linked to a Cloud Billing account, and if you have more than one Cloud Billing account, a pop-up window displays, with text similar to:
"Billing account [Name of your Billing Account] is linked to this project"
To view the Billing Overview page for the Cloud Billing account that is linked to the project, select Go to linked billing account.
To view a list of Cloud Billing accounts for your organization, select Manage billing accounts.
gcloud
To view the detailed billing information for a project, run the
gcloud beta billing projects describe
command:
gcloud beta billing projects describe PROJECT_ID
Where:
- PROJECT_ID is the ID or number of the project for which you want to view billing information.
Example:
To see detailed billing information for a project my-project
, run:
gcloud beta billing projects describe my-project
Based on the details returned, you can tell if billing is enabled or not.
- Billing is enabled for
my-project
if you see abillingAccountName
andbillingEnabled: true
. ThebillingAccountName
is the ID of the Cloud Billing account that is linked to the project. For example:
billingAccountName: billingAccounts/0X0X0X-0X0X0X-0X0X0X billingEnabled: true name: projects/my-project/billingInfo projectId: my-project
- If you see a
billingAccountName
formy-project
, but you seebillingEnabled: false
, then the project is linked to an inactive Cloud Billing account. Billing is not enabled for this project. For example:
billingAccountName: billingAccounts/0X0X0X-0X0X0X-0X0X0X billingEnabled: false name: projects/my-project/billingInfo projectId: my-project
If the billing account is not active, you cannot use the resources within the linked project. Learn how to reopen a closed billing account or change the billing account linked to a project.
- If the
billingAccountName
is blank formy-project
, then the project is not linked to any Cloud Billing account. Billing is not enabled for this project. For example:
billingAccountName: '' billingEnabled: false name: projects/my-project/billingInfo projectId: my-project
For information on how to link a billing account to a project, see enable billing for an existing project.
2. Confirm the status of the linked Cloud Billing account
Console
To confirm the linked Cloud Billing account is active, do the following:
View the Billing Overview page for the linked billing account.
You might already be on the Billing Overview page. If not, do the following:
Sign in to your Cloud Billing account in the Google Cloud console.
At the prompt, choose the Cloud Billing account you'd like to view. The Billing Overview page opens for the selected billing account.
If the linked billing account is closed or suspended, you will see a message at the top of the Billing Overview page that indicates the status of the account. For example, if the billing account is closed, you will see a message similar to the following: "This billing account is closed. Visit the account management page to reopen it and continue using linked projects."
You cannot use the resources within the linked projects if the billing account is not active.
View the Payment Overview page for the linked billing account.
If you are already on the Billing Overview page, select the Payment Overview tab. Otherwise, do the following to open the Payment Overview page:
In the Google Cloud console, sign in to the Payment overview page for your Cloud Billing account.
At the prompt, choose the Cloud Billing account you'd like to view. The Billing Payment overview page opens for the selected billing account.
If the linked Cloud Billing account has an overdue, unpaid balance or an issue with your method of payment, your account might be suspended until you resolve any issues and pay the balance due.
Learn how to resolve declined payments on self-serve (autopay) accounts.
gcloud
To view the details for a Cloud Billing account, run the
gcloud beta billing accounts describe
command:
gcloud beta billing accounts describe ACCOUNT_ID
Where:
- ACCOUNT_ID is the ID of the billing account you want to view,
in the form of 0X0X0X-0X0X0X-0X0X0X. To see available IDs, run
$ gcloud alpha billing accounts list
.
Example:
To see details for billing account 0X0X0X-0X0X0X-0X0X0X
, run:
gcloud beta billing accounts describe 0X0X0X-0X0X0X-0X0X0X
The information returned for a billing account includes the billing account display name and the active status of the account. For example:
displayName: My Billing Account masterBillingAccount: '' name: billingAccounts/0X0X0X-0X0X0X-0X0X0X open: true
displayName
is the name you assigned to the billing account.masterBillingAccount
indicates if the billing account you are viewing is a parent/top-level account or a subaccount. If you see a value inmasterBillingAccount
, then the billing account you are viewing is a subaccount of the parent billing account displayed inmasterBillingAccount
. IfmasterBillingAccount
is blank, then the billing account you are viewing is not a subaccount.name
is the ID of the billing account you are viewing.open
indicates if the billing account is active. Iftrue
, the billing account is open. Iffalse
, the billing account is closed or suspended. Billing is not enabled for any projects linked to a closed billing account.
If the billing account is not open, you cannot use the resources within the linked project. Learn how to reopen a closed billing account or change the billing account linked to a project.
Related topics
For information on accessing a tabular view of all your projects and the Cloud Billing account linked to each project, see View projects linked to billing accounts.