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

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

@@ -0,0 +1,42 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 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 autokey config."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.cloudkms import base as cloudkms_base
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.kms import flags
+from googlecloudsdk.core import resources
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(
+    base.ReleaseTrack.GA, base.ReleaseTrack.BETA, base.ReleaseTrack.ALPHA
+)
+class AutokeyConfig(base.Group):
+  """Update and retrieve the AutokeyConfig.
+
+  Autokey config is a folder level resource which configures the key project
+  for the folder and the resources inside it.
+  """
+
+  category = base.IDENTITY_AND_SECURITY_CATEGORY
+
+  @staticmethod
+  def Args(parser):
+    pass

gcloud auth application-default login/google-cloud-sdk/lib/surface/kms/autokey_config/describe.py

@@ -0,0 +1,52 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 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.
+"""Describe the AutokeyConfig of a folder."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.cloudkms import base as cloudkms_base
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.kms import flags
+
+
+@base.UniverseCompatible
+class Describe(base.DescribeCommand):
+  r"""Describe the AutokeyConfig of a folder.
+
+  {command} can be used to retrieve the AutokeyConfig of a folder.
+
+  ## EXAMPLES
+
+  The following command retrieves the AutokeyConfig of a folder having folder-id
+  `123`:
+
+  $ {command} --folder=123
+  """
+
+  @staticmethod
+  def Args(parser):
+    flags.AddFolderIdFlag(parser, True)
+
+  def Run(self, args):
+    client = cloudkms_base.GetClientInstance()
+    messages = cloudkms_base.GetMessagesModule()
+    autokey_config_name = 'folders/{0}/autokeyConfig'.format(
+        args.folder)
+
+    return client.folders.GetAutokeyConfig(
+        messages.CloudkmsFoldersGetAutokeyConfigRequest(
+            name=autokey_config_name))

gcloud auth application-default login/google-cloud-sdk/lib/surface/kms/autokey_config/show_effective_config.py

@@ -0,0 +1,55 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 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.
+"""Gets the effective Cloud KMS AutokeyConfig for a given project."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.cloudkms import base as cloudkms_base
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.kms import resource_args
+
+
+@base.UniverseCompatible
+class ShowEffectiveConfig(base.Command):
+  r"""Gets the effective Cloud KMS AutokeyConfig for a given project.
+
+  {command} can be used to get the effective Cloud KMS AutokeyConfig for a given
+  project.
+
+  ## EXAMPLES
+
+  The following command retrieves the effective Cloud KMS AutokeyConfig for a
+  given project `my-project`:
+
+  $ {command} --project=my-project
+
+  If --project flag is not provided, then the current project will be used.
+  """
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddKmsProjectResourceArgForKMS(parser, True, 'project')
+
+  def Run(self, args):
+    client = cloudkms_base.GetClientInstance()
+    messages = cloudkms_base.GetMessagesModule()
+    project_ref = args.CONCEPTS.project.Parse()
+
+    return client.projects.ShowEffectiveAutokeyConfig(
+        messages.CloudkmsProjectsShowEffectiveAutokeyConfigRequest(
+            parent=project_ref.RelativeName()))
+

gcloud auth application-default login/google-cloud-sdk/lib/surface/kms/autokey_config/update.py

@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2024 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.
+"""Describe the AutokeyConfig of a folder."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.cloudkms import base as cloudkms_base
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.kms import flags
+from googlecloudsdk.command_lib.kms import parsing
+
+
+@base.UniverseCompatible
+class Describe(base.DescribeCommand):
+  r"""Updates the AutokeyConfig for a folder.
+
+  {command} can be used to update the AutokeyConfig of a folder.
+
+  ## EXAMPLES
+
+  The following command updates the AutokeyConfig for the folder mentioned in
+  the config.yaml file:
+
+  $ {command} config.yaml
+  """
+
+  @staticmethod
+  def Args(parser):
+    flags.AddAutokeyConfigFileFlag(parser)
+
+  def Run(self, args):
+    client = cloudkms_base.GetClientInstance()
+    messages = cloudkms_base.GetMessagesModule()
+
+    name, key_project, etag = parsing.ReadAutokeyConfigFromConfigFile(
+        args.CONFIG_FILE
+    )
+    if not etag:
+      return client.folders.UpdateAutokeyConfig(
+          messages.CloudkmsFoldersUpdateAutokeyConfigRequest(
+              autokeyConfig=messages.AutokeyConfig(
+                  name=name, keyProject=key_project
+              ),
+              name=name,
+              updateMask="keyProject",
+          ),
+      )
+    return client.folders.UpdateAutokeyConfig(
+        messages.CloudkmsFoldersUpdateAutokeyConfigRequest(
+            autokeyConfig=messages.AutokeyConfig(
+                name=name, keyProject=key_project, etag=etag
+            ),
+            name=name,
+            updateMask="keyProject",
+        )
+    )