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

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

@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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.
+
+"""The command group for the projects CLI."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+@base.Hidden
+class SpectrumAccess(base.Group):
+  """Create and manage Spectrum Access System (SAS) resources."""
+
+  category = base.MANAGEMENT_TOOLS_CATEGORY
+
+  def Filter(self, context, args):
+    del context, args

gcloud auth application-default login/google-cloud-sdk/lib/surface/spectrum_access/provision.py

@@ -0,0 +1,102 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2023 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 provision a new Spectrum Access System's deployment."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.spectrum_access import sas_portal_api
+from googlecloudsdk.calliope import base
+from googlecloudsdk.core import log
+from googlecloudsdk.core import properties
+from googlecloudsdk.core.console import console_io
+
+
+@base.Hidden
+class Provision(base.DescribeCommand):
+  """Provision a new Spectrum Access System's deployment.
+
+  ## EXAMPLES
+
+  The following command provisions a new SAS deployment:
+
+    $ gcloud spectrum-access provision --organization-name=MyOrgName
+    --deployment-name=MyDeploymentName
+  """
+
+  @staticmethod
+  def Args(parser):
+    parser.add_argument(
+        '--organization-name',
+        required=False,
+        help=(
+            'The display name to use in case a new SAS Portal organization'
+            ' needs to be created. If not set, a default display name of the'
+            ' form "Cloud organizations/[ID]" will be used where ID is the'
+            ' current Cloud Platform Organization ID.'
+        ),
+    )
+    parser.add_argument(
+        '--deployment-name',
+        required=False,
+        help=(
+            'The display name to use in case a new SAS Portal deployment needs'
+            ' to be created. If not set, a default display name of the form'
+            ' "Cloud [ID]" will be used where ID is the current Cloud Platform'
+            ' Project ID.'
+        ),
+    )
+
+  def Run(self, args):
+    log.status.Print(
+        'This command will enable the Spectrum Access System'
+        ' and create a new SAS deployment for your'
+        ' organization. The Spectrum Access System is governed by your Google'
+        ' Cloud Agreement or Cloud Master Agreement and the Spectrum Access'
+        ' System specific terms at cloud.google.com/terms.'
+    )
+    console_io.PromptContinue(
+        default=False,
+        cancel_on_no=True,
+        prompt_string='Do you accept the agreement?',
+    )
+
+    base.EnableUserProjectQuota()
+    client = sas_portal_api.GetClientInstance().customers
+    messsage_module = sas_portal_api.GetMessagesModule()
+    req = messsage_module.SasPortalProvisionDeploymentRequest()
+    req.newOrganizationDisplayName = args.organization_name
+    req.newDeploymentDisplayName = args.deployment_name
+
+    result = client.ProvisionDeployment(req)
+    if not result.errorMessage:
+      portal_api_override = properties.VALUES.api_endpoint_overrides.Property(
+          'sasportal'
+      ).Get()
+      sas_portal_url = 'g.co/sasportal'
+      if portal_api_override and ('prod-tt-sasportal' in portal_api_override):
+        sas_portal_url = 'https://wirelessconnectivity.google.com/test-sas'
+
+      project = properties.VALUES.core.project.Get()
+
+      log.status.Print(
+          'A new SAS deployment with userID: {}  has been created. Go to'
+          ' {} to check spectrum availability, pre-register CBSDs,'
+          ' check CBSD status and manage users.'.format(project, sas_portal_url)
+      )
+
+    return result