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

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

@@ -0,0 +1,27 @@
+# -*- 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 telco-automation command group."""
+
+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.GA)
+class TelcoAutomationAlpha(base.Group):
+  """Manage Telco Automation resources."""
+  category = base.NETWORKING_CATEGORY

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

@@ -0,0 +1,26 @@
+# -*- 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 telco-automation operations."""
+
+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.GA)
+class Operations(base.Group):
+  """Command group for working with telco automation operations."""

gcloud auth application-default login/google-cloud-sdk/lib/surface/telco_automation/operations/describe.yaml

@@ -0,0 +1,22 @@
+- release_tracks: [ALPHA, GA]
+
+  help_text:
+    brief: Get description of a long-running telco automation operation.
+    description: |
+      Get information about a long-running telco automation operation.
+    examples: |-
+      To get information about a long-running operation with name `test-operation` in region `us-central1`, run the following command:
+
+        $ {command} test-operation --location=us-central1
+
+  request:
+    collection: telcoautomation.projects.locations.operations
+    ALPHA:
+      api_version: v1alpha1
+    GA:
+      api_version: v1
+
+  arguments:
+    resource:
+      help_text: The ID of the operation to describe.
+      spec: !REF googlecloudsdk.command_lib.telco_automation.resources:operation

gcloud auth application-default login/google-cloud-sdk/lib/surface/telco_automation/operations/wait.yaml

@@ -0,0 +1,28 @@
+- release_tracks: [ALPHA, GA]
+
+  help_text:
+    brief: Poll long-running telco automation operation until it completes.
+    description: |
+      Poll a long-running telco automation operation until it completes. When
+      the operation is complete, this command will display the results of the
+      analysis.
+    examples: |
+      To poll a long-running telco automation operation named `test-operation` in region `us-central1` until it completes, run the following:
+
+        $ {command} test-operation --location=us-central1
+
+  request:
+    collection: telcoautomation.projects.locations.operations
+    ALPHA:
+      api_version: v1alpha1
+    GA:
+      api_version: v1
+
+  arguments:
+    resource:
+      help_text: ID for the operation to poll until complete.
+      spec: !REF googlecloudsdk.command_lib.telco_automation.resources:operation
+
+  async:
+    collection: telcoautomation.projects.locations.operations
+    result_attribute: response

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

@@ -0,0 +1,26 @@
+# -*- 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 telco-automation orchestration-cluster sub-group."""
+
+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.GA)
+class TelcoAutomationOrchestrationClusterAlpha(base.Group):
+  """Manage telco automation orchestration cluster instances."""

gcloud auth application-default login/google-cloud-sdk/lib/surface/telco_automation/orchestration_cluster/create.yaml

@@ -0,0 +1,66 @@
+- release_tracks: [ALPHA, GA]
+
+  help_text:
+    brief: Create a telco automation orchestration cluster.
+    description: |
+      Create a new telco automation orchestration cluster.
+    examples: |
+      To create an orchestration cluster called `test-orchestrationCluster` in location `us-central1`, run:
+
+        $ {command} test-orchestrationCluster --location=us-central1
+
+  request:
+    collection: telcoautomation.projects.locations.orchestrationClusters
+    ALPHA:
+      api_version: v1alpha1
+    GA:
+      api_version: v1
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.telco_automation.hooks:UpdateRequestWithInput
+
+  arguments:
+    resource:
+      help_text: Telco automation orchestration cluster to create.
+      spec: !REF googlecloudsdk.command_lib.telco_automation.resources:orchestrationCluster
+    params:
+    - group:
+        params:
+        - arg_name: network
+          api_field: orchestrationCluster.managementConfig.standardManagementConfig.network
+          help_text: Name of the VPC Network to put the GKE cluster and nodes in. The VPC will be created if it doesn't exist.
+          required: true
+        - arg_name: subnet
+          api_field: orchestrationCluster.managementConfig.standardManagementConfig.subnet
+          help_text: Specifies the subnet that the interface will be part of. Network key must be specified and the subnet must be a subnetwork of the specified network.
+    - api_field: orchestrationCluster.managementConfig.standardManagementConfig.masterIpv4CidrBlock
+      arg_name: master-ipv4-cidr-block
+      help_text: /28 network that the control plane will use.
+    - api_field: orchestrationCluster.managementConfig.standardManagementConfig.clusterCidrBlock
+      arg_name: cluster-cidr-block
+      help_text: IP address range for the cluster pod IPs. Set to blank to have a range chosen with the default size. Set to /netmask (e.g. /14) to have a range chosen with a specific netmask. Set to a CIDR notation (e.g. 10.96.0.0/14) from the RFC-1918 private networks (e.g. 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) to pick a specific range to use.
+    - api_field: orchestrationCluster.managementConfig.standardManagementConfig.servicesCidrBlock
+      arg_name: services-cidr-block
+      help_text: IP address range for the cluster service IPs. Set to blank to have a range chosen with the default size. Set to /netmask (e.g. /14) to have a range chosen with a specific netmask. Set to a CIDR notation (e.g. 10.96.0.0/14) from the RFC-1918 private networks (e.g. 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16) to pick a specific range to use.
+    - api_field: orchestrationCluster.managementConfig.standardManagementConfig.clusterNamedRange
+      arg_name: cluster-named-range
+      help_text: Name of the existing secondary range in the cluster's subnetwork to use for pod IP addresses. Alternatively, cluster_cidr_block can be used to automatically create a GKE-managed one.
+    - api_field: orchestrationCluster.managementConfig.standardManagementConfig.servicesNamedRange
+      arg_name: services-named-range
+      help_text: Name of the existing secondary range in the cluster's subnetwork to use for service ClusterIPs. Alternatively, services_cidr_block can be used to automatically create a GKE-managed one.
+    - arg_name: full-management-config
+      type: bool
+      help_text: This parameter is to marked true only if the management configuration arguments which are provided, belong to full (Autopilot) cluster management.
+    - api_field:  orchestrationCluster.managementConfig.standardManagementConfig.masterAuthorizedNetworksConfig.cidrBlocks
+      arg_name: cidr-blocks
+      help_text: Master Authorized Network that supports multiple CIDR blocks. Allows access to the k8s master from multiple blocks.
+      type:
+        arg_dict:
+          flatten: false
+          spec:
+          - api_field: displayName
+            arg_name: display-name
+          - api_field: cidrBlock
+            arg_name: cidr-block
+
+  async:
+    collection: telcoautomation.projects.locations.operations

gcloud auth application-default login/google-cloud-sdk/lib/surface/telco_automation/orchestration_cluster/delete.yaml

@@ -0,0 +1,25 @@
+- release_tracks: [ALPHA, GA]
+
+  help_text:
+    brief: Delete a telco automation orchestration cluster.
+    description: |
+      Delete a telco automation orchestration cluster.
+    examples: |
+      To delete an orchestration cluster called `test-cluster` in region `us-central1`, run:
+
+        $ {command} test-cluster --location=us-central1
+
+  request:
+    collection: telcoautomation.projects.locations.orchestrationClusters
+    ALPHA:
+      api_version: v1alpha1
+    GA:
+      api_version: v1
+
+  arguments:
+    resource:
+      help_text: Telco automation orchestration cluster to delete.
+      spec: !REF googlecloudsdk.command_lib.telco_automation.resources:orchestrationCluster
+
+  async:
+    collection: telcoautomation.projects.locations.operations

gcloud auth application-default login/google-cloud-sdk/lib/surface/telco_automation/orchestration_cluster/describe.yaml

@@ -0,0 +1,21 @@
+release_tracks: [ALPHA, GA]
+
+help_text:
+  brief: Show details about the orchestration cluster.
+  description: Show details about the orchestration cluster.
+  examples: |
+    To show details about an orchestration cluster called `test-cluster` in region `us-central1`, run:
+
+      $ {command} test-cluster --location=us-central1
+
+request:
+  collection: telcoautomation.projects.locations.orchestrationClusters
+  ALPHA:
+    api_version: v1alpha1
+  GA:
+    api_version: v1
+
+arguments:
+  resource:
+    help_text: The orchestration cluster you want to describe.
+    spec: !REF googlecloudsdk.command_lib.telco_automation.resources:orchestrationCluster

gcloud auth application-default login/google-cloud-sdk/lib/surface/telco_automation/orchestration_cluster/list.yaml

@@ -0,0 +1,35 @@
+- release_tracks: [ALPHA, GA]
+
+  help_text:
+    brief: List telco automation orchestration clusters.
+    description: |
+      List telco automation orchestration clusters.
+    examples: |
+      To list all orchestration clusters in region `us-central1`, run:
+
+        $ {command} --location=us-central1
+
+  request:
+    collection: telcoautomation.projects.locations.orchestrationClusters
+    ALPHA:
+      api_version: v1alpha1
+    GA:
+      api_version: v1
+
+  response:
+    id_field: name
+
+  arguments:
+    resource:
+      help_text: Parent telco automation location to list all contained telco automation orchestration clusters.
+      spec: !REF googlecloudsdk.command_lib.telco_automation.resources:location
+
+  output:
+    format: |
+      table(
+        name.basename():label=NAME,
+        createTime.date("%Y-%m-%dT%H:%M:%SZ"):label=CREATETIME,
+        updateTime.date("%Y-%m-%dT%H:%M:%SZ"):label=UPDATETIME,
+        state:label=STATE,
+        tnaVersion:label=TNAVERSION
+      )