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

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

@@ -0,0 +1,28 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 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 VMware Engine network CLI."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Networks(base.Group):
+  """Manage VMware Engine networks in Google Cloud VMware Engine."""
+
+  category = base.COMPUTE_CATEGORY

gcloud auth application-default login/google-cloud-sdk/lib/surface/vmware/networks/create.py

@@ -0,0 +1,107 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 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.
+"""'vmware networks create' command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.vmware.networks import NetworksClient
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.vmware.networks import flags
+from googlecloudsdk.core import log
+
+DETAILED_HELP = {
+    'DESCRIPTION':
+        """
+          Create a VMware Engine network. VMware Engine network creation is considered finished when the VMware Engine network is in ACTIVE state. Check the progress of a VMware Engine network creation using `{parent_command} list`.
+        """,
+    'EXAMPLES':
+        """
+          To create a VMware Engine network of type `STANDARD`, run:
+
+            $ {command} my-network --type=STANDARD --location=global --project=my-project
+
+          Or:
+
+            $ {command} my-network --type=STANDARD
+
+          In the second example, the project is taken from gcloud properties core/project and the location is taken as `global`.
+
+          To create a VMware Engine network of type `LEGACY` in the `us-west2` region, run:
+
+            $ {command} my-network --type=LEGACY --location=us-west2 --project=my-project
+
+          Or:
+
+            $ {command} my-network --type=LEGACY --location=us-west2
+
+          In the last example, the project is taken from gcloud properties core/project. For VMware Engine networks of type `LEGACY`, you must always specify a region as the location.
+    """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Create(base.CreateCommand):
+  """Create a Google Cloud VMware Engine network."""
+
+  detailed_help = DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command."""
+    type_choices = {
+        'STANDARD':
+            'Standard network type used for private cloud connectivity. A '
+            'VMware Engine network of type STANDARD is a global resource.',
+        'LEGACY':
+            'Network type used by private clouds created in projects without a'
+            ' network of type STANDARD. This network type is only used for new'
+            ' PCs in existing projects that continue to use LEGACY network. A '
+            'VMware Engine network of type LEGACY is a regional resource.'
+    }
+    flags.AddNetworkToParser(parser, positional=True)
+    base.ASYNC_FLAG.AddToParser(parser)
+    base.ASYNC_FLAG.SetDefault(parser, True)
+    parser.display_info.AddFormat('yaml')
+    parser.add_argument(
+        '--description',
+        help="""\
+        Text describing the VMware Engine network.
+        """)
+    parser.add_argument(
+        '--type',
+        required=True,
+        choices=type_choices,
+        help="""Type of the VMware Engine network.""")
+
+  def Run(self, args):
+    network = args.CONCEPTS.vmware_engine_network.Parse()
+    client = NetworksClient()
+    is_async = args.async_
+    operation = client.Create(network, args.type, args.description)
+    if is_async:
+      log.CreatedResource(
+          operation.name, kind='VMware Engine network', is_async=True)
+      return
+
+    resource = client.WaitForOperation(
+        operation_ref=client.GetOperationRef(operation),
+        message='waiting for VMware Engine network [{}] to be created'.format(
+            network.RelativeName()
+        ),
+    )
+    log.CreatedResource(network.RelativeName(), kind='VMware Engine network')
+    return resource

gcloud auth application-default login/google-cloud-sdk/lib/surface/vmware/networks/delete.py

@@ -0,0 +1,83 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 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.
+"""'vmware networks delete' command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.vmware.networks import NetworksClient
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.vmware.networks import flags
+from googlecloudsdk.core import log
+
+DETAILED_HELP = {
+    'DESCRIPTION':
+        """
+          Delete a VMware Engine network.
+        """,
+    'EXAMPLES':
+        """
+          To delete a network called `my-network` of type `STANDARD` in project `my-project` and region `global`, run:
+
+            $ {command} my-network --location=global --project=my-project
+
+          Or:
+
+            $ {command} my-network
+
+          In the second example, the project is taken from gcloud properties core/project and the location is taken as `global`.
+
+          To delete a network called `my-network` of type `LEAGACY` in project `my-project` and region `us-west2`, run:
+
+            $ {command} my-network --location=us-west2 --project=my-project
+
+          Or:
+
+            $ {command} my-network --location=us-west2
+
+          In the last example, the project is taken from gcloud properties core/project. For VMware Engine networks of type `LEGACY`, you must always specify a region as the location.
+    """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Delete(base.DeleteCommand):
+  """Delete a Google Cloud VMware Engine network."""
+
+  detailed_help = DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command."""
+    flags.AddNetworkToParser(parser, positional=True)
+    base.ASYNC_FLAG.AddToParser(parser)
+    base.ASYNC_FLAG.SetDefault(parser, True)
+
+  def Run(self, args):
+    network = args.CONCEPTS.vmware_engine_network.Parse()
+    client = NetworksClient()
+    is_async = args.async_
+    operation = client.Delete(network)
+    if is_async:
+      log.DeletedResource(
+          operation.name, kind='VMware Engine network', is_async=True)
+      return operation
+
+    return client.WaitForOperation(
+        operation_ref=client.GetOperationRef(operation),
+        message='waiting for VMware Engine network [{}] to be deleted'.format(
+            network.RelativeName()),
+        has_result=False)

gcloud auth application-default login/google-cloud-sdk/lib/surface/vmware/networks/describe.py

@@ -0,0 +1,69 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 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.
+"""'vmware networks describe' command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.vmware.networks import NetworksClient
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.vmware.networks import flags
+
+DETAILED_HELP = {
+    'DESCRIPTION':
+        """
+          Describe a VMware Engine network.
+        """,
+    'EXAMPLES':
+        """
+          To get a description of a network called `my-network` of type `STANDARD` in project `my-project` and region `global`, run:
+
+            $ {command} my-network --location=global --project=my-project
+
+          Or:
+
+            $ {command} my-network
+
+          In the second example, the project is taken from gcloud properties core/project and the location is taken as `global`.
+
+          To get a description of a network called `my-network` of type `LEGACY` in project `my-project` and region `us-west2`, run:
+
+            $ {command} my-network --location=us-west2 --project=my-project
+
+          Or:
+
+            $ {command} my-network --location=us-west2
+
+          In the last example, the project is taken from gcloud properties core/project. For VMware Engine networks of type `LEGACY`, you must always specify a region as the location.
+    """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Describe(base.DescribeCommand):
+  """Describe a Google Cloud VMware Engine network."""
+
+  detailed_help = DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command."""
+    flags.AddNetworkToParser(parser, positional=True)
+
+  def Run(self, args):
+    network = args.CONCEPTS.vmware_engine_network.Parse()
+    client = NetworksClient()
+    return client.Get(network)

gcloud auth application-default login/google-cloud-sdk/lib/surface/vmware/networks/list.py

@@ -0,0 +1,74 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 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.
+"""'vmware networks list' command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.vmware.networks import NetworksClient
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.vmware.networks import flags
+
+DETAILED_HELP = {
+    'DESCRIPTION':
+        """
+          List VMware Engine networks.
+        """,
+    'EXAMPLES':
+        """
+          To list VMware Engine networks of type `STANDARD` in your project, run:
+
+            $ {command} --location=global --project=my-project
+
+          Or:
+
+            $ {command}
+
+          In the second example, the project is taken from gcloud properties core/project and the location is taken as `global`.
+
+          To list VMware Engine networks of type `LEGACY` in the location `us-west2` in your project, run:
+
+            $ {command} --location=us-west2 --project=my-project
+
+          Or:
+
+            $ {command} --location=us-west2
+
+          In the last example, the project is taken from gcloud properties core/project. For VMware Engine networks of type `LEGACY`, you must always specify a region as the location.
+    """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class List(base.ListCommand):
+  """List Google Cloud VMware Engine networks."""
+
+  detailed_help = DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command."""
+    flags.AddLocationArgToParser(parser)
+    parser.display_info.AddFormat('table(name.segment(-1):label=NAME,'
+                                  'name.segment(-5):label=PROJECT,'
+                                  'name.segment(-3):label=LOCATION,'
+                                  'createTime,state,type)')
+
+  def Run(self, args):
+    location = args.CONCEPTS.location.Parse()
+
+    client = NetworksClient()
+    return client.List(location)

gcloud auth application-default login/google-cloud-sdk/lib/surface/vmware/networks/update.py

@@ -0,0 +1,92 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2022 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.
+"""'vmware networks update' command."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.vmware.networks import NetworksClient
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.vmware.networks import flags
+from googlecloudsdk.core import log
+
+DETAILED_HELP = {
+    'DESCRIPTION':
+        """
+          Update a VMware Engine network.
+        """,
+    'EXAMPLES':
+        """
+          To update a network named `my-network` of type `STANDARD` by changing its description to `Example description`, run:
+
+            $ {command} my-network --location=global --project=my-project --description='Example description'
+
+          Or:
+
+            $ {command} my-network --description='Example description'
+
+          In the second example, the project is taken from gcloud properties core/project and the location is taken as `global`.
+
+          To update a network named `my-network` of type `LEGACY` by changing its description to `Example description`, run:
+
+            $ {command} my-network --location=us-west2 --project=my-project --description='Example description'
+
+          Or:
+
+            $ {command} my-network --location=us-west2 --description='Example description'
+
+          In the last example, the project is taken from gcloud properties core/project. For VMware Engine networks of type `LEGACY`, you must always specify a region as the location.
+    """,
+}
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Update(base.UpdateCommand):
+  """Update a Google Cloud VMware Engine network."""
+
+  detailed_help = DETAILED_HELP
+
+  @staticmethod
+  def Args(parser):
+    """Register flags for this command."""
+    flags.AddNetworkToParser(parser, positional=True)
+    base.ASYNC_FLAG.AddToParser(parser)
+    base.ASYNC_FLAG.SetDefault(parser, True)
+    parser.display_info.AddFormat('yaml')
+    parser.add_argument(
+        '--description',
+        help="""\
+        Text describing the VMware Engine network
+        """)
+
+  def Run(self, args):
+    network = args.CONCEPTS.vmware_engine_network.Parse()
+    client = NetworksClient()
+    is_async = args.async_
+    operation = client.Update(network, description=args.description)
+    if is_async:
+      log.UpdatedResource(
+          operation.name, kind='VMware Engine network', is_async=True)
+      return
+
+    resource = client.WaitForOperation(
+        operation_ref=client.GetOperationRef(operation),
+        message='waiting for VMware Engine network [{}] to be updated'.format(
+            network.RelativeName()
+        ),
+    )
+    log.UpdatedResource(network.RelativeName(), kind='VMware Engine network')
+    return resource