.TH "GCLOUD_BILLING_PROJECTS_LINK" 1



.SH "NAME"
.HP
gcloud billing projects link \- link a project with a billing account



.SH "SYNOPSIS"
.HP
\f5gcloud billing projects link\fR \fIPROJECT_ID\fR \fB\-\-billing\-account\fR=\fIACCOUNT_ID\fR [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "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, active
Cloud Billing account. The billing account accrues charges for the usage of
resources in all of the linked projects. If the project is already linked to a
billing account, this command moves the project to the billing account you
specify, updating the billing account that is linked to the project.

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



.SH "EXAMPLES"

To link a billing account \f50X0X0X\-0X0X0X\-0X0X0X\fR with a project
\f5my\-project\fR, run:

.RS 2m
$ gcloud billing projects link my\-project \e
    \-\-billing\-account=0X0X0X\-0X0X0X\-0X0X0X
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIPROJECT_ID\fR

Specify a project id.


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-billing\-account\fR=\fIACCOUNT_ID\fR

Specify a billing account ID. Billing account IDs are of the form
\f50X0X0X\-0X0X0X\-0X0X0X\fR. To see available IDs, run \f5$ gcloud billing
accounts list\fR.


.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "API REFERENCE"

This command uses the \fBcloudbilling/v1\fR API. The full documentation for this
API can be found at: https://cloud.google.com/billing/v1/getting\-started



.SH "NOTES"

These variants are also available:

.RS 2m
$ gcloud alpha billing projects link
.RE

.RS 2m
$ gcloud beta billing projects link
.RE