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

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

@@ -0,0 +1,35 @@
+# -*- 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.
+"""Commands for reading and manipulating instance settings."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+@base.Hidden
+class InstanceSettings(base.Group):
+  """Describe and update Compute Engine instance settings."""
+
+
+InstanceSettings.category = base.INSTANCES_CATEGORY
+
+InstanceSettings.detailed_help = {
+    'brief': 'Describe and update Compute Engine instance settings',
+}

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/instance_settings/describe.py

@@ -0,0 +1,53 @@
+# -*- 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 for describing instance settings."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.compute import base_classes
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.compute.instance_settings import flags
+from googlecloudsdk.core import properties
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+@base.Hidden
+class Describe(base.DescribeCommand):
+  """Describe zonal instance settings."""
+
+  detailed_help = {
+      'EXAMPLES': """
+        To describe the instance settings in the zone called ``us-central1-a''
+        in the project ``my-gcp-project'', run:
+
+          $ {command} --zone=us-central1-a --project=my-gcp-project
+      """
+  }
+
+  @staticmethod
+  def Args(parser):
+    flags.AddDescribeInstanceSettingsFlags(parser)
+
+  def Run(self, args):
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    client = holder.client
+    service = client.apitools_client.instanceSettings
+    request = client.messages.ComputeInstanceSettingsGetRequest(
+        project=properties.VALUES.core.project.GetOrFail(), zone=args.zone
+    )
+
+    return client.MakeRequests([(service, 'Get', request)])[0]

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/instance_settings/set_service_account.py

@@ -0,0 +1,66 @@
+# -*- 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 set service account email to zonal instance settings."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.compute import base_classes
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.compute.instance_settings import flags
+from googlecloudsdk.core import properties
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+@base.Hidden
+class SetServiceAccount(base.UpdateCommand):
+  """Set service account in zonal instance settings."""
+
+  detailed_help = {'EXAMPLES': """
+        To update the instance settings in the zone called ``us-central1-a''
+        in the project ``my-gcp-project'' with service account email ``example@serviceaccount.com'', run:
+
+          $ {command} example@serviceaccount.com --zone=us-central1-a --project=my-gcp-project
+      """}
+
+  @staticmethod
+  def Args(parser):
+    flags.AddServiceAccountFlags(parser)
+
+  def Run(self, args):
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    client = holder.client
+    service = client.apitools_client.instanceSettings
+    get_request = client.messages.ComputeInstanceSettingsGetRequest(
+        project=properties.VALUES.core.project.GetOrFail(), zone=args.zone
+    )
+    fingerprint = client.MakeRequests([(service, 'Get', get_request)])[
+        0
+    ].fingerprint
+    request = client.messages.ComputeInstanceSettingsPatchRequest(
+        instanceSettings=client.messages.InstanceSettings(
+            email=getattr(args, 'SERVICE_ACCOUNT_EMAIL', None),
+            fingerprint=fingerprint,
+        ),
+        project=properties.VALUES.core.project.GetOrFail(),
+        updateMask='email',
+        zone=args.zone,
+    )
+    # TODO(b/271293873):Remove no_followup=True once singleton support is added.
+    return client.MakeRequests(
+        [(service, 'Patch', request)],
+        no_followup=True,
+    )[0]

gcloud auth application-default login/google-cloud-sdk/lib/surface/compute/instance_settings/update.py

@@ -0,0 +1,65 @@
+# -*- 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 update zonal instance settings."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.compute import base_classes
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.compute.instance_settings import flags
+from googlecloudsdk.core import properties
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+@base.Hidden
+class Update(base.UpdateCommand):
+  """Update zonal instance settings."""
+
+  detailed_help = {'EXAMPLES': """
+        To update the instance settings in the zone called ``us-central1-a''
+        in the project ``my-gcp-project'' with service account email ``example@serviceaccount.com'', run:
+
+          $ {command} --service-account=example@serviceaccount.com --zone=us-central1-a --project=my-gcp-project
+      """}
+
+  @staticmethod
+  def Args(parser):
+    flags.AddUpdateInstanceSettingsFlags(parser)
+
+  def Run(self, args):
+    holder = base_classes.ComputeApiHolder(self.ReleaseTrack())
+    client = holder.client
+    service = client.apitools_client.instanceSettings
+    request = client.messages.ComputeInstanceSettingsGetRequest(
+        project=properties.VALUES.core.project.GetOrFail(), zone=args.zone
+    )
+    fingerprint = client.MakeRequests([(service, 'Get', request)])[
+        0
+    ].fingerprint
+    request = client.messages.ComputeInstanceSettingsPatchRequest(
+        instanceSettings=client.messages.InstanceSettings(
+            email=args.service_account, fingerprint=fingerprint
+        ),
+        project=properties.VALUES.core.project.GetOrFail(),
+        updateMask='email',
+        zone=args.zone,
+    )
+    # TODO(b/271293873):Remove no_followup=True once singleton support is added.
+    return client.MakeRequests(
+        [(service, 'Patch', request)],
+        no_followup=True,
+    )[0]