101 lines
3.7 KiB
Python
101 lines
3.7 KiB
Python
# -*- coding: utf-8 -*- #
|
|
# Copyright 2017 Google LLC. All Rights Reserved.
|
|
#
|
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
# you may not use this file except in compliance with the License.
|
|
# You may obtain a copy of the License at
|
|
#
|
|
# http://www.apache.org/licenses/LICENSE-2.0
|
|
#
|
|
# Unless required by applicable law or agreed to in writing, software
|
|
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
# See the License for the specific language governing permissions and
|
|
# limitations under the License.
|
|
"""Command to update a new project."""
|
|
|
|
from __future__ import absolute_import
|
|
from __future__ import division
|
|
from __future__ import unicode_literals
|
|
|
|
from googlecloudsdk.api_lib.billing import billing_client
|
|
from googlecloudsdk.calliope import base
|
|
from googlecloudsdk.command_lib.billing import flags
|
|
from googlecloudsdk.command_lib.billing import utils
|
|
|
|
|
|
_DETAILED_HELP = {
|
|
'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
|
|
""",
|
|
'EXAMPLES': """\
|
|
To link a billing account `0X0X0X-0X0X0X-0X0X0X` with a project
|
|
`my-project`, run:
|
|
|
|
$ {command} my-project --billing-account=0X0X0X-0X0X0X-0X0X0X
|
|
""",
|
|
'API REFERENCE': """\
|
|
This command uses the *cloudbilling/v1* API. The full documentation
|
|
for this API can be found at:
|
|
https://cloud.google.com/billing/v1/getting-started
|
|
"""
|
|
}
|
|
|
|
|
|
def _RunLink(args):
|
|
client = billing_client.ProjectsClient()
|
|
project_ref = utils.ParseProject(args.project_id)
|
|
account_ref = utils.ParseAccount(args.billing_account)
|
|
return client.Link(project_ref, account_ref)
|
|
|
|
|
|
@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
|
|
class LinkAlpha(base.Command):
|
|
"""Link a project with a billing account."""
|
|
|
|
detailed_help = _DETAILED_HELP
|
|
|
|
@staticmethod
|
|
def Args(parser):
|
|
account_args_group = parser.add_mutually_exclusive_group(required=True)
|
|
flags.GetOldAccountIdArgument(positional=False).AddToParser(
|
|
account_args_group)
|
|
flags.GetAccountIdArgument(positional=False).AddToParser(account_args_group)
|
|
|
|
flags.GetProjectIdArgument().AddToParser(parser)
|
|
|
|
def Run(self, args):
|
|
return _RunLink(args)
|
|
|
|
|
|
@base.ReleaseTracks(base.ReleaseTrack.BETA, base.ReleaseTrack.GA)
|
|
class Link(base.Command):
|
|
"""Link a project with a billing account."""
|
|
|
|
detailed_help = _DETAILED_HELP
|
|
|
|
@staticmethod
|
|
def Args(parser):
|
|
flags.GetAccountIdArgument(positional=False,
|
|
required=True).AddToParser(parser)
|
|
flags.GetProjectIdArgument().AddToParser(parser)
|
|
|
|
def Run(self, args):
|
|
return _RunLink(args)
|