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

gcloud auth application-default login/google-cloud-sdk/lib/surface/saas_runtime/flags/releases/__init__.py

@@ -0,0 +1,25 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2025 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 flags releases command group for the SaaS Runtime CLI."""
+
+from googlecloudsdk.calliope import base
+
+
+@base.UniverseCompatible
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+@base.Hidden
+class SaasFlagsReleases(base.Group):
+  category = base.SAAS_CATEGORY
+  detailed_help = {'brief': 'Manage SaaS Runtime Flags Releases.'}

gcloud auth application-default login/google-cloud-sdk/lib/surface/saas_runtime/flags/releases/create.yaml

@@ -0,0 +1,83 @@
+- release_tracks:
+  - ALPHA
+  hidden: true
+  help_text:
+    brief: Create Flag Release
+    description: Create a Flag Release.
+    examples: |-
+      To create a Flag Release, run:
+
+          $ {command}
+  arguments:
+    params:
+    - help_text: |-
+        ID of the Flag Release:
+
+          "projects/{project}/locations/{location}/flagReleases/{flag_release_id}"
+
+        This follows the standard Google Cloud naming scheme (URI).
+      is_positional: true
+      request_id_field: flagReleaseId
+      resource_spec: !REF googlecloudsdk.command_lib.saas_runtime.resources:flag_release
+      required: true
+      repeated: false
+
+    - arg_name: flag-revisions
+      help_text: |-
+        Flag Revisions (IDs) to be rolled out. This is the ultimate source of truth
+        of what a Rollout or a UnitOperation carries.
+      is_positional: false
+      resource_spec: !REF googlecloudsdk.command_lib.saas_runtime.resources:flag_revision
+      resource_method_params:
+        flagRelease.flagRevisions: '{__relative_name__}'
+      required: false
+      repeated: true
+
+    - arg_name: obsolete-flags
+      help_text: |-
+        Flags (IDs) to be removed from the given UnitKind and all the related Units.
+        If Flag (ID) is provided here, its Flag Revisions will be removed from the
+        UnitKind and Units.
+      is_positional: false
+      resource_spec: !REF googlecloudsdk.command_lib.saas_runtime.resources:flag
+      resource_method_params:
+        flagRelease.obsoleteFlags: '{__relative_name__}'
+      required: false
+      repeated: true
+
+    - arg_name: unit-kind
+      help_text: |-
+        UnitKind (ID) this Flag Release applies to.
+      is_positional: false
+      resource_spec: !REF googlecloudsdk.command_lib.saas_runtime.resources:unit_kind
+      resource_method_params:
+        flagRelease.unitKind: '{__relative_name__}'
+      required: true
+      repeated: false
+
+    - arg_name: labels
+      api_field: flagRelease.labels
+      required: false
+      repeated: true
+      help_text: |-
+        Labels on the resource, which can be used for categorization.
+      spec:
+      - api_field: key
+      - api_field: value
+
+    - arg_name: annotations
+      api_field: flagRelease.annotations
+      required: false
+      repeated: true
+      help_text: |-
+        Unstructured key-value map stored with a resource that may be set by
+        external tools to store and retrieve arbitrary metadata. Annotations
+        are not queryable and should be preserved when modifying objects.
+      spec:
+      - api_field: key
+      - api_field: value
+
+  request:
+    api_version: v1beta1
+    collection:
+    - saasservicemgmt.projects.locations.flagReleases

gcloud auth application-default login/google-cloud-sdk/lib/surface/saas_runtime/flags/releases/delete.yaml

@@ -0,0 +1,21 @@
+- release_tracks:
+  - ALPHA
+  hidden: true
+  help_text:
+    brief: Delete Flag Release
+    description: Delete a Flag Release
+    examples: |-
+      To delete a Flag Release, run:
+
+          $ {command}
+  arguments:
+    params:
+    - help_text: |-
+        Flag Release ID of the Flag Release to delete.
+      is_positional: true
+      resource_spec: !REF googlecloudsdk.command_lib.saas_runtime.resources:flag_release
+      required: true
+  request:
+    api_version: v1beta1
+    collection:
+    - saasservicemgmt.projects.locations.flagReleases

gcloud auth application-default login/google-cloud-sdk/lib/surface/saas_runtime/flags/releases/describe.yaml

@@ -0,0 +1,21 @@
+- release_tracks:
+  - ALPHA
+  hidden: true
+  help_text:
+    brief: Describe Flag Revision
+    description: Describe a Flag Release
+    examples: |-
+      To describe a Flag Release, run:
+
+          $ {command}
+  arguments:
+    params:
+    - help_text: |-
+        Flag Release ID of the Flag Release to describe.
+      is_positional: true
+      resource_spec: !REF googlecloudsdk.command_lib.saas_runtime.resources:flag_release
+      required: true
+  request:
+    api_version: v1beta1
+    collection:
+    - saasservicemgmt.projects.locations.flagReleases

gcloud auth application-default login/google-cloud-sdk/lib/surface/saas_runtime/flags/releases/list.yaml

@@ -0,0 +1,21 @@
+- release_tracks:
+  - ALPHA
+  hidden: true
+  help_text:
+    brief: List Flags Releases
+    description: List Flags Releases
+    examples: |-
+      To list all Flags Releases, run:
+
+          $ {command}
+  arguments:
+    resource:
+      help_text: |-
+        Location in which to list Flag Releases.
+      spec: !REF googlecloudsdk.command_lib.saas_runtime.resources:project_location_with_default
+  request:
+    api_version: v1beta1
+    collection:
+    - saasservicemgmt.projects.locations.flagReleases
+  response:
+    id_field: name

gcloud auth application-default login/google-cloud-sdk/lib/surface/saas_runtime/flags/releases/update.yaml

@@ -0,0 +1,53 @@
+- release_tracks:
+  - ALPHA
+  hidden: true
+  help_text:
+    brief: Update Flag Release
+    description: Update a Flag Release
+    examples: |-
+      To update a Flag Release, run:
+
+          $ {command}
+  arguments:
+    params:
+    - help_text: |-
+        ID of the Flag Release:
+
+          "projects/{project}/locations/{location}/flagReleases/{flag_release_id}"
+
+        This follows the standard Google Cloud naming scheme (URI).
+      is_positional: true
+      request_id_field: flagReleaseId
+      resource_spec: !REF googlecloudsdk.command_lib.saas_runtime.resources:flag_release
+      required: true
+
+    - arg_name: labels
+      api_field: flagRelease.labels
+      clearable: true
+      required: false
+      repeated: true
+      help_text: |-
+        The labels on the resource, which can be used for categorization.
+      spec:
+      - api_field: key
+      - api_field: value
+
+    - arg_name: annotations
+      api_field: flagRelease.annotations
+      clearable: true
+      required: false
+      repeated: true
+      help_text: |-
+        Unstructured key-value map stored with a resource that may be set by
+        external tools to store and retrieve arbitrary metadata. Annotations
+        are not queryable and should be preserved when modifying objects.
+      spec:
+      - api_field: key
+      - api_field: value
+
+  request:
+    api_version: v1beta1
+    collection:
+    - saasservicemgmt.projects.locations.flagReleases
+  update:
+    read_modify_update: true