.TH "GCLOUD_ALPHA_BILLING_PROJECTS_LINK" 1



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



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



.SH "DESCRIPTION"

\fB(ALPHA)\fR 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 alpha 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

Exactly one of these must be specified:


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

(DEPRECATED) 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.

The \f5\-\-account\-id\fR flag has been renamed \f5\-\-billing\-account\fR.

.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
.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"

This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation\-only early access
allowlist. These variants are also available:

.RS 2m
$ gcloud billing projects link
.RE

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