gcloud billing projects link

NAME
gcloud billing projects link - link a project with a billing account
SYNOPSIS
gcloud billing projects linkPROJECT_ID--billing-account=ACCOUNT_ID[GCLOUD_WIDE_FLAG …]
DESCRIPTION
This command sets or updates the billing account associated with a project.

Billing is enabled on a project when the project is linked to a valid, activeCloud Billing account. The billing account accrues charges for the usage ofresources in all of the linked projects. If the project is already linked to abilling account, this command moves the project to the billing account youspecify, updating the billing account that is linked to the project.

Note that associating a project with a closed billing account has the sameeffect as disabling billing on the project: any paid resources in use by theproject are shut down, and your application stops functioning. Unless you wantto disable billing, you should always specify a valid, active Cloud Billingaccount when you run this command. Learn how to confirm the status of a CloudBilling account athttps://cloud.google.com/billing/docs/how-to/verify-billing-enabled#billing_account_status

EXAMPLES
To link a billing account0X0X0X-0X0X0X-0X0X0X with a projectmy-project, run:
gcloudbillingprojectslinkmy-project--billing-account=0X0X0X-0X0X0X-0X0X0X
POSITIONAL ARGUMENTS
PROJECT_ID
Specify a project id.
REQUIRED FLAGS
--billing-account=ACCOUNT_ID
Specify a billing account ID. Billing account IDs are of the form0X0X0X-0X0X0X-0X0X0X. To see available IDs, run$gcloud billing accountslist.
GCLOUD WIDE FLAGS
These flags are available to all commands:--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.

Run$gcloud help for details.

API REFERENCE
This command uses thecloudbilling/v1 API. The full documentationfor this API can be found at:https://cloud.google.com/billing/v1/getting-started
NOTES
These variants are also available:
gcloudalphabillingprojectslink
gcloudbetabillingprojectslink

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-07 UTC.