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

gcloud auth application-default login/google-cloud-sdk/lib/surface/certificate_manager/maps/entries/__init__.py

@@ -0,0 +1,30 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 Google Inc. 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 map entries command group for the Certificate Manager."""
+
+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.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class CertificateMapEntries(base.Group):
+  """Manage Certificate Manager certificate map entries.
+
+  Commands for managing certificate map entries.
+  """

gcloud auth application-default login/google-cloud-sdk/lib/surface/certificate_manager/maps/entries/create.py

@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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.
+"""`gcloud certificate-manager maps entries create` command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.certificate_manager import certificate_map_entries
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.certificate_manager import flags
+from googlecloudsdk.command_lib.certificate_manager import resource_args
+from googlecloudsdk.command_lib.certificate_manager import util
+from googlecloudsdk.command_lib.util.args import labels_util
+from googlecloudsdk.core import log
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class Create(base.CreateCommand):
+  """Create a certificate map entry.
+
+  This command creates a certificate map entry.
+
+  ## EXAMPLES
+
+  To create a certificate map entry with name simple-entry, run:
+
+    $ {command} simple-entry --map=simple-map --certificates=simple-cert
+  """
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddCertificateMapEntryAndCertificatesResourceArgs(
+        parser, entry_verb='to create')
+    labels_util.AddCreateLabelsFlags(parser)
+    flags.AddDescriptionFlagToParser(parser, 'certificate map entry')
+    flags.AddMapEntryMatcherFlagsToParser(parser)
+    flags.AddAsyncFlagToParser(parser)
+
+  def Run(self, args):
+    client = certificate_map_entries.CertificateMapEntryClient()
+    entry_ref = args.CONCEPTS.entry.Parse()
+    map_ref = entry_ref.Parent()
+    cert_refs = args.CONCEPTS.certificates.Parse()
+    labels = labels_util.ParseCreateArgs(
+        args, client.messages.CertificateMapEntry.LabelsValue)
+
+    response = client.Create(
+        map_ref,
+        entry_ref.certificateMapEntriesId,
+        hostname=args.hostname,
+        cert_refs=cert_refs,
+        description=args.description,
+        labels=labels)
+    operation_response = util.WaitForOperation(response, is_async=args.async_)
+    log.CreatedResource(
+        entry_ref.Name(), 'certificate map entry', is_async=args.async_)
+    return operation_response

gcloud auth application-default login/google-cloud-sdk/lib/surface/certificate_manager/maps/entries/delete.py

@@ -0,0 +1,63 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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.
+"""`gcloud certificate-manager maps entries delete` command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.certificate_manager import certificate_map_entries
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.certificate_manager import flags
+from googlecloudsdk.command_lib.certificate_manager import resource_args
+from googlecloudsdk.command_lib.certificate_manager import util
+from googlecloudsdk.core import log
+from googlecloudsdk.core.console import console_io
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class Delete(base.DeleteCommand):
+  """Delete a certificate map entry.
+
+  Delete a certificate map entry resource.
+
+  ## EXAMPLES
+
+  To delete the certificate map entry with name simple-entry, run:
+
+    $ {command} simple-entry --map=simple-map
+  """
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddCertificateMapEntryResourceArg(parser, 'to delete')
+    flags.AddAsyncFlagToParser(parser)
+
+  def Run(self, args):
+    client = certificate_map_entries.CertificateMapEntryClient()
+    entry_ref = args.CONCEPTS.entry.Parse()
+
+    console_io.PromptContinue(
+        'You are about to delete certificate map entry \'{}\' from certificate map \'{}\''
+        .format(entry_ref.certificateMapEntriesId, entry_ref.certificateMapsId),
+        throw_if_unattended=True,
+        cancel_on_no=True)
+
+    response = client.Delete(entry_ref)
+
+    response = util.WaitForOperation(response, is_async=args.async_)
+    log.DeletedResource(entry_ref.Name(), 'map entry', is_async=args.async_)
+    return response

gcloud auth application-default login/google-cloud-sdk/lib/surface/certificate_manager/maps/entries/describe.py

@@ -0,0 +1,47 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 Google Inc. 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.
+"""`gcloud certificate-manager maps entries describe` command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.certificate_manager import certificate_map_entries
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.certificate_manager import resource_args
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class Describe(base.DescribeCommand):
+  """Describe an existing certificate map entry.
+
+  This command fetches and prints information about an existing certificate map
+  entry.
+
+  ## EXAMPLES
+
+  To describe a certificate map entry with name simple-entry, run:
+
+    $ {command} simple-entry --map=simple-map
+  """
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddCertificateMapEntryResourceArg(parser, 'to describe')
+
+  def Run(self, args):
+    client = certificate_map_entries.CertificateMapEntryClient()
+    return client.Get(args.CONCEPTS.entry.Parse())

gcloud auth application-default login/google-cloud-sdk/lib/surface/certificate_manager/maps/entries/list.py

@@ -0,0 +1,85 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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.
+"""`gcloud certificate-manager maps entries list` command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+import re
+
+from googlecloudsdk.api_lib.certificate_manager import certificate_map_entries
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.certificate_manager import resource_args
+from googlecloudsdk.command_lib.certificate_manager import util
+
+_FORMAT = """\
+table(
+    name.scope(certificateMapEntries):sort=1,
+    description,
+    hostname,
+    matcher,
+    certificates.certNamesToIDs(undefined=''),
+    state,
+    createTime.date('%Y-%m-%d %H:%M:%S %Oz', undefined='')
+)
+"""
+
+_CERT_NAME_REGEX = 'projects/([a-z0-9-]{1,63})/locations/([a-z0-9-]{1,63})/certificates/([a-z0-9-]{1,63})'
+
+
+def _TransformCertificateNames(cert_names, undefined=''):
+  """Transforms fully qualified cert names to their IDs."""
+  if not cert_names:
+    return undefined
+  result = []
+  for name in cert_names:
+    match = re.match(_CERT_NAME_REGEX, name)
+    result.append(match.group(3) if match else name)
+  return '\n'.join(result) if result else undefined
+
+
+_TRANSFORMS = {
+    'certNamesToIDs': _TransformCertificateNames,
+}
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class List(base.ListCommand):
+  """List certificate map entries.
+
+  List Certificate Manager certificate map entries in the certificate map.
+
+  ## EXAMPLES
+
+  To list all certificate map entries in the certificate map, run:
+
+    $ {command} --map=simple-map
+  """
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddCertificateMapResourceArg(
+        parser, 'to list map entries for', positional=False)
+    parser.display_info.AddUriFunc(util.CertificateMapEntryUriFunc)
+    parser.display_info.AddFormat(_FORMAT)
+    parser.display_info.AddTransforms(_TRANSFORMS)
+
+  def Run(self, args):
+    client = certificate_map_entries.CertificateMapEntryClient()
+    map_ref = args.CONCEPTS.map.Parse()
+    return client.List(map_ref, args.limit, args.page_size)

gcloud auth application-default login/google-cloud-sdk/lib/surface/certificate_manager/maps/entries/update.py

@@ -0,0 +1,90 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2020 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.
+"""`gcloud certificate-manager maps entries update` command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.certificate_manager import certificate_map_entries
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.certificate_manager import flags
+from googlecloudsdk.command_lib.certificate_manager import resource_args
+from googlecloudsdk.command_lib.certificate_manager import util
+from googlecloudsdk.command_lib.util.args import labels_util
+from googlecloudsdk.core import exceptions
+from googlecloudsdk.core import log
+from googlecloudsdk.core.console import console_io
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class Update(base.UpdateCommand):
+  """Update a certificate map entry.
+
+  This command updates existing certificate map entry.
+
+  ## EXAMPLES
+
+  To update a certificate map entry with name simple-entry, run:
+
+    $ {command} simple-entry --map="simple-map" --description="desc"
+    --update-labels="key=value" --certificates="simple-cert"
+  """
+
+  @staticmethod
+  def Args(parser):
+    resource_args.AddCertificateMapEntryAndCertificatesResourceArgs(
+        parser, entry_verb='to update')
+    labels_util.AddUpdateLabelsFlags(parser)
+    flags.AddDescriptionFlagToParser(parser, 'certificate map entry')
+    flags.AddAsyncFlagToParser(parser)
+
+  def Run(self, args):
+    client = certificate_map_entries.CertificateMapEntryClient()
+    entry_ref = args.CONCEPTS.entry.Parse()
+
+    new_description = None
+    if args.IsSpecified('description'):
+      new_description = args.description
+
+    new_certs = None
+    if args.IsSpecified('certificates'):
+      new_certs = args.CONCEPTS.certificates.Parse()
+      console_io.PromptContinue(
+          'You are about to overwrite certificates from map entry \'{}\''
+          .format(entry_ref.certificateMapEntriesId),
+          throw_if_unattended=True,
+          cancel_on_no=True)
+
+    labels_update = None
+    labels_diff = labels_util.Diff.FromUpdateArgs(args)
+    if labels_diff.MayHaveUpdates():
+      orig_resource = client.Get(entry_ref)
+      labels_update = labels_diff.Apply(
+          client.messages.CertificateMapEntry.LabelsValue,
+          orig_resource.labels).GetOrNone()
+
+    if new_description is None and labels_update is None and new_certs is None:
+      raise exceptions.Error('Nothing to update.')
+    response = client.Patch(
+        entry_ref,
+        labels=labels_update,
+        description=new_description,
+        cert_refs=new_certs)
+    response = util.WaitForOperation(response, is_async=args.async_)
+    log.UpdatedResource(
+        entry_ref.Name(), 'certificate map entry', is_async=args.async_)
+    return response