feat: Add new gcloud commands, API clients, and third-party libraries across various services.

gcloud auth application-default login/google-cloud-sdk/lib/surface/billing/accounts/__init__.py

@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2016 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.
+"""Commands managing cloud billing accounts."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+class Accounts(base.Group):
+  """Manage billing accounts."""

gcloud auth application-default login/google-cloud-sdk/lib/surface/billing/accounts/add_iam_policy_binding.yaml

@@ -0,0 +1,23 @@
+release_tracks: [ALPHA, BETA, GA]
+
+help_text:
+  brief: Add an IAM policy binding to a Cloud Billing account.
+  description: |
+    Add an IAM policy binding to the IAM policy of a Cloud Billing account. A
+    binding consists of a member and a role.
+  examples: |
+    To add someone@example.com as a Billing Account Administrator for billing account
+    123456-789876-543210, run:
+
+      $ {command} 123456-789876-543210 --member='user:someone@example.com' --role='roles/billing.admin'
+
+request:
+  collection: cloudbilling.billingAccounts
+
+arguments:
+  resource:
+    help_text: Name of the Cloud Billing account for which to add the IAM policy binding.
+    spec: !REF googlecloudsdk.command_lib.billing.resources:account
+
+iam:
+  enable_condition: false

gcloud auth application-default login/google-cloud-sdk/lib/surface/billing/accounts/describe.py

@@ -0,0 +1,60 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2016 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 show metadata for a specified 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
+
+
+class Describe(base.DescribeCommand):
+  """Show metadata for a billing account."""
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          This command shows info for a billing account, given its ID.
+
+          This call can fail for the following reasons:
+
+          * The account specified does not exist.
+          * The active user does not have permission to access the given
+            account.
+          """,
+      'EXAMPLES': """\
+          To see details for billing account `0X0X0X-0X0X0X-0X0X0X`, run:
+
+              $ {command} 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
+          """
+  }
+
+  @staticmethod
+  def Args(parser):
+    flags.GetAccountIdArgument().AddToParser(parser)
+
+  def Run(self, args):
+    client = billing_client.AccountsClient()
+    account_ref = utils.ParseAccount(args.account_id)
+    return client.Get(account_ref)

gcloud auth application-default login/google-cloud-sdk/lib/surface/billing/accounts/get_iam_policy.yaml

@@ -0,0 +1,25 @@
+- release_tracks: [ALPHA, BETA, GA]
+
+  help_text:
+    brief: Get the IAM policy for a Cloud Billing account.
+
+    description: |
+      *{command}* displays the IAM policy associated with a Cloud Billing
+      account. If formatted as JSON, the output can be edited and used as a
+      policy file for *set-iam-policy*. The output includes an "etag" field
+      identifying the version emitted and allowing detection of concurrent
+      policy updates; see
+      $ {parent} set-iam-policy for additional details.
+
+    examples: |
+      To print the IAM policy for a given Cloud Billing account, run:
+
+        $ {command} my-account
+
+  request:
+    collection: cloudbilling.billingAccounts
+
+  arguments:
+    resource:
+      help_text: The Cloud Billing account for which to display the IAM policy.
+      spec: !REF googlecloudsdk.command_lib.billing.resources:account

gcloud auth application-default login/google-cloud-sdk/lib/surface/billing/accounts/list.py

@@ -0,0 +1,64 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2016 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 list all billing accounts associated with the active user."""
+
+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.core import resources
+
+
+class List(base.ListCommand):
+  """List all active billing accounts.
+
+  `{command}` lists all billing accounts and subaccounts owned by the currently
+  authenticated user. Subaccounts have a non-empty MASTER_ACCOUNT_ID value.
+
+  ## EXAMPLES
+
+  To list only open billing accounts, run:
+
+      $ {command} --filter=open=true
+
+  ## 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
+  """
+
+  @staticmethod
+  def ToSelfLink(account):
+    return resources.REGISTRY.Parse(
+        account.name, collection='cloudbilling.billingAccounts').SelfLink()
+
+  @staticmethod
+  def Args(parser):
+    parser.display_info.AddFormat("""
+          table(
+            name.basename():label=ACCOUNT_ID,
+            displayName:label=NAME,
+            open,
+            masterBillingAccount.basename():label=MASTER_ACCOUNT_ID
+          )
+    """)
+    parser.display_info.AddUriFunc(List.ToSelfLink)
+
+  def Run(self, args):
+    """Run the list command."""
+    client = billing_client.AccountsClient()
+    return client.List(limit=args.limit)

gcloud auth application-default login/google-cloud-sdk/lib/surface/billing/accounts/projects/__init__.py

@@ -0,0 +1,33 @@
+# -*- 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.
+"""Manage the billing account configuration of your projects."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+_BASE_MESSAGE = """\
+The `gcloud alpha billing accounts projects` group has been moved to `gcloud
+billing projects`. Please use the new, shorter commands instead."""
+
+
+# Don't promote this group beyond alpha, since the new alias is preferred.
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+@base.Deprecate(is_removed=False, warning=_BASE_MESSAGE, error=_BASE_MESSAGE)
+class Projects(base.Group):
+  """Manage the billing account configuration of your projects."""

gcloud auth application-default login/google-cloud-sdk/lib/surface/billing/accounts/projects/describe.py

@@ -0,0 +1,54 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2016 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 show metadata for a specified 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
+
+
+class Describe(base.DescribeCommand):
+  """Show detailed billing information for a project."""
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          This command shows billing info for a project, given its ID.
+
+          This call can fail for the following reasons:
+
+          * The project specified does not exist.
+          * The active user does not have permission to access the given
+            project.
+          """,
+      'EXAMPLES': """\
+          To see detailed billing information for a project `my-project`, run:
+
+              $ {command} my-project
+          """
+  }
+
+  @staticmethod
+  def Args(parser):
+    flags.GetProjectIdArgument().AddToParser(parser)
+
+  def Run(self, args):
+    client = billing_client.ProjectsClient()
+    project_ref = utils.ParseProject(args.project_id)
+    return client.Get(project_ref)

gcloud auth application-default login/google-cloud-sdk/lib/surface/billing/accounts/projects/link.py

@@ -0,0 +1,58 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2016 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
+
+
+class Link(base.Command):
+  """Link a project with a billing account."""
+
+  detailed_help = {
+      'DESCRIPTION': """\
+          This command links a billing account to a project.
+
+          If the specified billing account is open, this enables billing on the
+          project.
+          """,
+      'EXAMPLES': """\
+          To link a billing account `0X0X0X-0X0X0X-0X0X0X` with a project
+          `my-project`, run:
+
+            $ {command} my-project --billing-account=0X0X0X-0X0X0X-0X0X0X
+          """
+  }
+
+  @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):
+    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)

gcloud auth application-default login/google-cloud-sdk/lib/surface/billing/accounts/projects/list.py

@@ -0,0 +1,61 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2016 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 list all Project IDs linked with a billing account."""
+
+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
+
+
+class List(base.ListCommand):
+  """List all active projects associated with the specified billing account.
+
+  *{command}* ACCOUNT_ID -- lists all active projects, for the specified
+  billing account id.
+
+  ## EXAMPLES
+
+  To list projects linked to billing account `0X0X0X-0X0X0X-0X0X0X`, run:
+
+      $ {command} 0X0X0X-0X0X0X-0X0X0X
+  """
+
+  @staticmethod
+  def Args(parser):
+    account_args_group = parser.add_mutually_exclusive_group(required=True)
+    flags.GetOldAccountIdArgument().AddToParser(account_args_group)
+    flags.GetAccountIdArgument(positional=False).AddToParser(account_args_group)
+
+    base.URI_FLAG.RemoveFromParser(parser)
+    parser.display_info.AddFormat("""
+          table(
+            projectId,
+            billingAccountName.basename():label=BILLING_ACCOUNT_ID,
+            billingEnabled
+          )
+    """)
+    # No resource URIs.
+    parser.display_info.AddCacheUpdater(None)
+
+  def Run(self, args):
+    """Run the list command."""
+    client = billing_client.ProjectsClient()
+    account_ref = utils.ParseAccount(args.id or args.billing_account)
+    return client.List(account_ref, limit=args.limit)

gcloud auth application-default login/google-cloud-sdk/lib/surface/billing/accounts/projects/unlink.py

@@ -0,0 +1,49 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2016 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 disable billing."""
+
+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
+
+
+class Unlink(base.Command):
+  """Unlink the account (if any) linked with a project."""
+  detailed_help = {
+      'DESCRIPTION': """\
+          This command unlinks a project from its linked billing
+          account. This disables billing on the project.
+          """,
+      'EXAMPLES': """\
+          To unlink the project `my-project` from its linked billing account,
+          run:
+
+            $ {command} my-project
+          """
+  }
+
+  @staticmethod
+  def Args(parser):
+    flags.GetProjectIdArgument().AddToParser(parser)
+
+  def Run(self, args):
+    client = billing_client.ProjectsClient()
+    project_ref = utils.ParseProject(args.project_id)
+    return client.Link(project_ref, None)

gcloud auth application-default login/google-cloud-sdk/lib/surface/billing/accounts/remove_iam_policy_binding.yaml

@@ -0,0 +1,23 @@
+release_tracks: [ALPHA, BETA, GA]
+
+help_text:
+  brief: Remove an IAM policy binding from a Cloud Billing account.
+  description: |
+    Remove an IAM policy binding to the IAM policy from a Cloud Billing
+    account. A binding consists of a member and a role.
+  examples: |
+    To remove someone@example.com as a Billing Account Administrator from billing account
+    123456-789876-543210, run:
+
+      $ {command} 123456-789876-543210 --member='user:someone@example.com' --role='roles/billing.admin'
+
+request:
+  collection: cloudbilling.billingAccounts
+
+arguments:
+  resource:
+    help_text: Name of the Cloud Billing account for which to remove the IAM policy binding.
+    spec: !REF googlecloudsdk.command_lib.billing.resources:account
+
+iam:
+  enable_condition: false

gcloud auth application-default login/google-cloud-sdk/lib/surface/billing/accounts/set_iam_policy.yaml

@@ -0,0 +1,28 @@
+- release_tracks: [ALPHA, BETA, GA]
+
+  help_text:
+    brief: Set the IAM policy for a Cloud Billing account.
+
+    description: |
+      *{command}* sets the IAM policy for a Cloud Billing account given an
+      account ID and a JSON or YAML file that describes the IAM policy.
+
+      Note: Setting the IAM policy for a Cloud Billing account replaces existing IAM bindings for
+      that account.
+
+    examples: |
+      The following command reads an IAM policy defined in the JSON file
+      `policy.json` and sets it for a Billing account ID *123456-789876-543210*:
+
+        $ {command} 123456-789876-543210 policy.json
+
+      See https://cloud.google.com/iam/docs/managing-policies for policy file
+      format and content details.
+
+  request:
+    collection: cloudbilling.billingAccounts
+
+  arguments:
+    resource:
+      help_text: The Cloud Billing account for which to display the IAM policy.
+      spec: !REF googlecloudsdk.command_lib.billing.resources:account