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

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

@@ -0,0 +1,61 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 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 main command group for Cloud Workflows."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+@base.DefaultUniverseOnly
+class Workflows(base.Group):
+  """Manage your Cloud Workflows resources."""
+
+  category = base.TOOLS_CATEGORY
+
+  def Filter(self, context, args):
+    # TODO(b/190541902):  Determine if command group works with project number
+    base.RequireProjectID(args)
+    del context, args
+
+
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+@base.DefaultUniverseOnly
+class WorkflowsBeta(base.Group):
+  """Manage your Cloud Workflows resources."""
+
+  category = base.TOOLS_CATEGORY
+
+  def Filter(self, context, args):
+    # TODO(b/190541902):  Determine if command group works with project number
+    base.RequireProjectID(args)
+    del context, args
+
+
+@base.Hidden
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class WorkflowsAlpha(base.Group):
+  """Manage your Cloud Workflows resources."""
+
+  category = base.TOOLS_CATEGORY
+
+  def Filter(self, context, args):
+    # TODO(b/190541902):  Determine if command group works with project number
+    base.RequireProjectID(args)
+    del context, args

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

@@ -0,0 +1,39 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: |
+      Delete a workflow
+    description: |
+      Delete a workflow and all of its executions.
+    examples: |
+      To delete the workflow 'my-workflow', run:
+
+          $ {command} my-workflow
+
+      You may also skip waiting for the operation to finish:
+
+          $ {command} my-workflow --async
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.workflows.resources:workflow
+      help_text: |
+        The name of the workflow to delete.
+
+  async:
+    collection: workflows.projects.locations.operations
+
+  input:
+    confirmation_prompt: |
+      You are about to delete workflow [{__name__}] in [{locationsId}].
+      Any associated data will be lost.
+
+  request:
+    ALPHA:
+      api_version: v1alpha1
+    BETA:
+      api_version: v1beta
+    GA:
+      api_version: v1
+    collection: workflows.projects.locations.workflows
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.workflows.hooks:print_default_location_warning

gcloud auth application-default login/google-cloud-sdk/lib/surface/workflows/deploy.py

@@ -0,0 +1,92 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 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.
+"""Creates or updates a workflow."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.workflows import validate
+from googlecloudsdk.api_lib.workflows import workflows
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.util.args import labels_util
+from googlecloudsdk.command_lib.workflows import flags
+from googlecloudsdk.command_lib.workflows import hooks
+from googlecloudsdk.core import log
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(
+    base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA, base.ReleaseTrack.GA
+)
+class Deploy(base.CacheCommand):
+  """Create or update a workflow."""
+
+  detailed_help = {
+      'DESCRIPTION': '{description}',
+      'EXAMPLES': """\
+          To deploy a workflow with source code myWorkflow.yaml on Workflows:
+
+            $ {command} my-workflow --source=myWorkflow.yaml
+
+          You may also skip waiting for the operation to finish:
+
+            $ {command} my-workflow --source=myWorkflow.yaml --async
+
+          To specify a service account as the workflow identity:
+
+            $ {command} my-workflow --source=myWorkflow.yaml --service-account=my-account@my-project.iam.gserviceaccount.com
+          """,
+  }
+
+  @classmethod
+  def Args(cls, parser):
+    base.ASYNC_FLAG.AddToParser(parser)
+    labels_util.AddCreateLabelsFlags(parser)
+    flags.AddWorkflowResourceArg(parser, verb='to deploy')
+    flags.AddSourceArg(parser)
+    flags.AddDescriptionArg(parser)
+    flags.AddServiceAccountArg(parser)
+    if cls.ReleaseTrack() is base.ReleaseTrack.GA:
+      flags.AddKmsKeyFlags(parser)
+      flags.AddWorkflowLoggingArg(parser)
+      flags.AddWorkflowExecutionHistoryLevelArg(parser)
+      flags.AddUserEnvVarsFlags(parser)
+      flags.AddWorkflowTagsArg(parser)
+
+  def Run(self, args):
+    """Deploy a workflow."""
+    hooks.print_default_location_warning(None, args, None)
+    api_version = workflows.ReleaseTrackToApiVersion(self.ReleaseTrack())
+    client = workflows.WorkflowsClient(api_version)
+    workflow_ref = flags.ParseWorkflow(args)
+    validate.WorkflowNameConforms(workflow_ref.Name())
+    old_workflow = client.Get(workflow_ref)
+    first_deployment = old_workflow is None
+    workflow, updated_fields = client.BuildWorkflowFromArgs(
+        args, old_workflow, self.ReleaseTrack(),
+    )
+    validate.ValidateWorkflow(workflow, first_deployment=first_deployment)
+    if first_deployment:
+      operation = client.Create(workflow_ref, workflow)
+    else:
+      if not updated_fields:
+        log.status.Print('No updates provided, quitting as a no-op.')
+        return None
+      operation = client.Patch(workflow_ref, workflow, updated_fields)
+    if args.async_:
+      return operation
+    else:
+      return client.WaitForOperation(operation, workflow_ref)

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

@@ -0,0 +1,54 @@
+- release_tracks: [ALPHA, BETA]
+  help_text:
+    brief: |
+      Show metadata for a workflow
+    description: |
+      Display all metadata associated with a workflow of given name.
+    examples: |
+      To describe the workflow 'my-workflow', run:
+
+          $ {command} my-workflow
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.workflows.resources:workflow
+      help_text: |
+        The name of the workflow to describe.
+
+  request:
+    ALPHA:
+      api_version: v1alpha1
+    BETA:
+      api_version: v1beta
+    collection: workflows.projects.locations.workflows
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.workflows.hooks:print_default_location_warning
+
+- release_tracks: [GA]
+  help_text:
+    brief: |
+      Show metadata for a workflow
+    description: |
+      Display all metadata associated with a workflow of given name and revisionID.
+      If revisionID is not provided, the metadata for the latest revision is retrieved.
+    examples: |
+      To describe the workflow 'my-workflow' at revision '000001-dc1', run:
+
+          $ {command} my-workflow `--revision-id=000001-dc1`
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.workflows.resources:workflow
+      help_text: |
+        The name of the workflow to describe.
+    params:
+    - arg_name: revision-id
+      api_field: revisionId
+      help_text: |
+        The revision ID of the workflow to describe.
+
+  request:
+    api_version: v1
+    collection: workflows.projects.locations.workflows
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.workflows.hooks:print_default_location_warning

gcloud auth application-default login/google-cloud-sdk/lib/surface/workflows/execute.yaml

@@ -0,0 +1,118 @@
+- release_tracks: [ALPHA, BETA, GA]
+  command_type: CREATE
+  help_text:
+    brief: |
+      Execute a workflow
+    description: |
+      Execute a workflow.
+    examples: |
+      To execute a workflow named 'my-workflow' with the data that will be passed
+      to the workflow, run:
+
+          $ {command} my-workflow --data=my-data
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.workflows.resources:workflow_for_executions
+      is_parent_resource: true
+      help_text: |
+        Name of the workflow to execute.
+    params:
+    - arg_name: data
+      api_field: execution.argument
+      help_text: |
+        JSON string with data that will be passed to the workflow as an argument.
+    - arg_name: call-log-level
+      api_field: execution.callLogLevel
+      help_text: |
+        Level of call logging to apply during execution.
+      release_tracks: [BETA]
+      choices:
+      - enum_value: CALL_LOG_LEVEL_UNSPECIFIED
+        arg_value: none
+        help_text: |
+          Perform no call logging.
+      - enum_value: LOG_ALL_CALLS
+        arg_value: log-all-calls
+        help_text: |
+          Log all calls to subworkflows or library functions and their results.
+      - enum_value: LOG_ERRORS_ONLY
+        arg_value: log-errors-only
+        help_text: |
+          Log when a call is stopped due to an exception.
+      default: none
+    - arg_name: call-log-level
+      api_field: execution.callLogLevel
+      help_text: |
+        Level of call logging to apply during execution.
+      release_tracks: [GA]
+      choices:
+      - enum_value: CALL_LOG_LEVEL_UNSPECIFIED
+        arg_value: none
+        help_text: |
+          No call logging level specified.
+      - enum_value: LOG_ALL_CALLS
+        arg_value: log-all-calls
+        help_text: |
+          Log all calls to subworkflows or library functions and their results.
+      - enum_value: LOG_ERRORS_ONLY
+        arg_value: log-errors-only
+        help_text: |
+          Log when a call is stopped due to an exception.
+      - enum_value: LOG_NONE
+        arg_value: log-none
+        help_text: |
+          Perform no call logging.
+      default: none
+    - arg_name: execution-history-level
+      api_field: execution.executionHistoryLevel
+      help_text: |
+        Level of execution history to apply during execution.
+      release_tracks: [GA]
+      choices:
+      - enum_value: EXECUTION_HISTORY_LEVEL_UNSPECIFIED
+        arg_value: none
+        help_text: |
+          No execution history level specified.
+      - enum_value: EXECUTION_HISTORY_BASIC
+        arg_value: execution-history-basic
+        help_text: |
+          Enable basic execution history.
+      - enum_value:  EXECUTION_HISTORY_DETAILED
+        arg_value: execution-history-detailed
+        help_text: |
+          Enable detailed execution history, including expected iterations and in-scope variable values.
+      default: none
+    - arg_name: labels
+      metavar: KEY=VALUE
+      api_field: execution.labels
+      help_text: |
+        List of label KEY=VALUE pairs to add.
+
+        Keys must start with a lowercase character and contain only hyphens, underscores,
+        lowercase characters, and numbers. Values must contain only hyphens, underscores,
+        lowercase characters, and numbers.
+      release_tracks: [GA]
+      type: 'googlecloudsdk.calliope.arg_parsers:ArgDict:'
+    - arg_name: disable-concurrency-quota-overflow-buffering
+      api_field: execution.disableConcurrencyQuotaOverflowBuffering
+      help_text: |
+        If set, the execution will not be backlogged when the concurrency quota is exhausted.
+        Backlogged executions start when the concurrency quota becomes available.
+      release_tracks: [GA]
+
+  request:
+    ALPHA:
+      api_version: v1alpha1
+    BETA:
+      api_version: v1beta
+    GA:
+      api_version: v1
+    collection: workflowexecutions.projects.locations.workflows.executions
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.workflows.hooks:print_default_location_warning
+
+  response:
+    modify_response_hooks:
+    - googlecloudsdk.command_lib.workflows.hooks:print_describe_instruction
+    - googlecloudsdk.command_lib.workflows.hooks:cache_execution_name

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

@@ -0,0 +1,43 @@
+# -*- coding: utf-8 -*- #
+# Copyright 2019 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 main command group for Cloud Workflow executions."""
+
+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 Executions(base.Group):
+  """Manage your Cloud Workflow execution resources."""
+
+  category = base.TOOLS_CATEGORY
+
+
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class ExecutionsBeta(base.Group):
+  """Manage your Cloud Workflow execution resources."""
+
+  category = base.TOOLS_CATEGORY
+
+
+@base.Hidden
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class ExecutionsAlpha(base.Group):
+  """Manage your Cloud Workflow execution resources."""
+
+  category = base.TOOLS_CATEGORY

gcloud auth application-default login/google-cloud-sdk/lib/surface/workflows/executions/cancel.yaml

@@ -0,0 +1,33 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: |
+      Cancel a workflow execution
+    description: |
+      Cancel a workflow execution.
+    examples: |
+      To cancel an execution with ID 'my-workflow-execution-ID' from a
+      workflow named 'my-workflow', run:
+
+          $ {command} my-workflow-execution-ID --workflow=my-workflow
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.workflows.resources:execution
+      help_text: |
+        The name of the workflow execution to cancel.
+
+  input:
+    confirmation_prompt: |
+      You are about to cancel execution [{__name__}] of workflow [{workflowsId}].
+
+  request:
+    ALPHA:
+      api_version: v1alpha1
+    BETA:
+      api_version: v1beta
+    GA:
+      api_version: v1
+    method: cancel
+    collection: workflowexecutions.projects.locations.workflows.executions
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.workflows.hooks:print_default_location_warning

gcloud auth application-default login/google-cloud-sdk/lib/surface/workflows/executions/describe.yaml

@@ -0,0 +1,28 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: |
+      Show metadata for a workflow execution
+    description: |
+      Display all metadata associated with a workflow execution of given ID.
+    examples: |
+      To describe an execution with ID 'my-workflow-execution-ID' from a
+      workflow named 'my-workflow', run:
+
+          $ {command} my-workflow-execution-ID --workflow=my-workflow
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.workflows.resources:execution
+      help_text: |
+        The name of the workflow execution to describe.
+
+  request:
+    ALPHA:
+      api_version: v1alpha1
+    BETA:
+      api_version: v1beta
+    GA:
+      api_version: v1
+    collection: workflowexecutions.projects.locations.workflows.executions
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.workflows.hooks:print_default_location_warning

gcloud auth application-default login/google-cloud-sdk/lib/surface/workflows/executions/describe_last.py

@@ -0,0 +1,44 @@
+# -*- 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.
+"""Show metadata for the last cached workflow execution."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.workflows import workflows
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class DescribeLast(base.DescribeCommand):
+  """Show metadata for the last cached workflow execution."""
+
+  detailed_help = {
+      'DESCRIPTION':
+          '{description}',
+      'EXAMPLES':
+          """\
+        To show metadata for the last cached workflow execution, run:
+
+          $ {command}
+        """,
+  }
+
+  def Run(self, args):
+    api_version = workflows.ReleaseTrackToApiVersion(self.ReleaseTrack())
+    client = workflows.WorkflowExecutionClient(api_version)
+    return client.Get(None)

gcloud auth application-default login/google-cloud-sdk/lib/surface/workflows/executions/list.yaml

@@ -0,0 +1,40 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: |
+      List workflow executions
+    description: |
+      List workflow executions for a given workflow.
+    examples: |
+      To list executions of a workflow named 'my-workflow', run:
+
+          $ {command} my-workflow
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.workflows.resources:workflow_for_executions
+      is_positional: true
+      help_text: |
+        The workflow name.
+
+  request:
+    ALPHA:
+      api_version: v1alpha1
+    BETA:
+      api_version: v1beta
+    GA:
+      api_version: v1
+    collection: workflowexecutions.projects.locations.workflows.executions
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.workflows.hooks:print_default_location_warning
+
+  response:
+    id_field: name
+
+  output:
+    format: |
+      table(
+        name,
+        state,
+        startTime,
+        endTime
+      )

gcloud auth application-default login/google-cloud-sdk/lib/surface/workflows/executions/wait.py

@@ -0,0 +1,55 @@
+# -*- 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.
+"""Wait for an execution to complete."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.workflows import workflows
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.workflows import flags
+from googlecloudsdk.command_lib.workflows import hooks
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class Wait(base.DescribeCommand):
+  """Wait for an execution to complete."""
+
+  detailed_help = {
+      'DESCRIPTION':
+          '{description}',
+      'EXAMPLES':
+          """\
+          To wait for an execution with ID 'my-workflow-execution-ID' from a
+          workflow named 'my-workflow' to finish, run:
+
+            $ {command} my-workflow-execution-ID --workflow=my-workflow
+
+          """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    flags.AddExecutionResourceArg(parser, verb='to wait on')
+
+  def Run(self, args):
+    """Starts the wait on the completion of the execution."""
+    hooks.print_default_location_warning(None, args, None)
+    api_version = workflows.ReleaseTrackToApiVersion(self.ReleaseTrack())
+    execution_ref = flags.ParseExecution(args)
+    client = workflows.WorkflowExecutionClient(api_version)
+    return client.WaitForExecution(execution_ref)

gcloud auth application-default login/google-cloud-sdk/lib/surface/workflows/executions/wait_last.py

@@ -0,0 +1,45 @@
+# -*- 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.
+"""Wait for the last cached workflow execution to complete."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.workflows import workflows
+from googlecloudsdk.calliope import base
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA, base.ReleaseTrack.BETA,
+                    base.ReleaseTrack.GA)
+class WaitLast(base.DescribeCommand):
+  """Wait for the last cached workflow execution to complete."""
+
+  detailed_help = {
+      'DESCRIPTION':
+          '{description}',
+      'EXAMPLES':
+          """\
+        To wait for the last cached workflow execution to complete, run:
+
+          $ {command}
+        """,
+  }
+
+  def Run(self, args):
+    """Starts the wait on the completion of the execution."""
+    api_version = workflows.ReleaseTrackToApiVersion(self.ReleaseTrack())
+    client = workflows.WorkflowExecutionClient(api_version)
+    return client.WaitForExecution(None)

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

@@ -0,0 +1,56 @@
+- release_tracks: [ALPHA, BETA, GA]
+  help_text:
+    brief: |
+      List workflows
+    description: |
+      List workflows under a project and location.
+    examples: |
+      To list workflows, run:
+
+          $ {command}
+
+  arguments:
+    resource:
+      spec: !REF googlecloudsdk.command_lib.workflows.resources:location
+      help_text: |
+        The name of the location to list workflows from.
+
+  request:
+    ALPHA:
+      api_version: v1alpha1
+    BETA:
+      api_version: v1beta
+    GA:
+      api_version: v1
+    collection: workflows.projects.locations.workflows
+    modify_request_hooks:
+    - googlecloudsdk.command_lib.workflows.hooks:print_default_location_warning
+
+  response:
+    id_field: name
+
+  output:
+    ALPHA:
+      format: |
+        table(
+          name,
+          state,
+          versionId,
+          updateTime
+        )
+    BETA:
+      format: |
+        table(
+          name,
+          state,
+          revisionId,
+          updateTime
+        )
+    GA:
+      format: |
+        table(
+          name,
+          state,
+          revisionId,
+          updateTime
+        )

gcloud auth application-default login/google-cloud-sdk/lib/surface/workflows/run.py

@@ -0,0 +1,160 @@
+# -*- 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.
+"""Execute a workflow and wait for the execution to complete."""
+
+from __future__ import absolute_import
+from __future__ import division
+from __future__ import unicode_literals
+
+from googlecloudsdk.api_lib.workflows import cache
+from googlecloudsdk.api_lib.workflows import workflows
+from googlecloudsdk.calliope import base
+from googlecloudsdk.command_lib.util.args import labels_util
+from googlecloudsdk.command_lib.workflows import flags
+from googlecloudsdk.command_lib.workflows import hooks
+from googlecloudsdk.core import resources
+
+EXECUTION_COLLECTION = 'workflowexecutions.projects.locations.workflows.executions'
+
+
+@base.DefaultUniverseOnly
+@base.ReleaseTracks(base.ReleaseTrack.GA)
+class Run(base.DescribeCommand):
+  """Execute a workflow and wait for the execution to complete."""
+
+  detailed_help = {
+      'DESCRIPTION':
+          '{description}',
+      'EXAMPLES':
+          """\
+        To execute a workflow named my-workflow with the data that will be passed to the workflow, run:
+
+          $ {command} my-workflow `--data=my-data`
+
+        To add two labels {foo: bar, baz: qux} to the execution, run:
+
+          $ {command} my-workflow `--data=my-data` `--labels=foo=bar,baz=qux`
+        """,
+  }
+
+  @staticmethod
+  def CommonArgs(parser):
+    flags.AddWorkflowResourceArg(parser, verb='to execute')
+    flags.AddDataArg(parser)
+
+  @staticmethod
+  def Args(parser):
+    Run.CommonArgs(parser)
+    flags.AddLoggingArg(parser)
+    flags.AddDisableOverflowBufferArg(parser)
+    flags.AddExecutionHistoryLevelArg(parser)
+    labels_util.AddCreateLabelsFlags(parser)
+
+  def CallLogLevel(self, args):
+    return args.call_log_level
+
+  def ExecutionHistoryLevel(self, args):
+    return args.execution_history_level
+
+  def Labels(self, args):
+    return flags.ParseExecutionLabels(args)
+
+  def OverflowBufferingDisabled(self, args):
+    return args.disable_concurrency_quota_overflow_buffering
+
+  def Run(self, args):
+    """Execute a workflow and wait for the completion of the execution."""
+    hooks.print_default_location_warning(None, args, None)
+    api_version = workflows.ReleaseTrackToApiVersion(self.ReleaseTrack())
+    workflow_ref = flags.ParseWorkflow(args)
+    client = workflows.WorkflowExecutionClient(api_version)
+    execution = client.Create(
+        workflow_ref,
+        args.data,
+        self.CallLogLevel(args),
+        self.ExecutionHistoryLevel(args),
+        self.Labels(args),
+        self.OverflowBufferingDisabled(args),
+    )
+    cache.cache_execution_id(execution.name)
+    execution_ref = resources.REGISTRY.Parse(
+        execution.name, collection=EXECUTION_COLLECTION
+    )
+    return client.WaitForExecution(execution_ref)
+
+
+@base.ReleaseTracks(base.ReleaseTrack.BETA)
+class BetaRun(Run):
+  """Execute a workflow and wait for the execution to complete."""
+
+  detailed_help = {
+      'DESCRIPTION':
+          '{description}',
+      'EXAMPLES':
+          """\
+        To execute a workflow named my-workflow with the data that will be passed to the workflow, run:
+
+          $ {command} my-workflow --data=my-data
+        """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    Run.CommonArgs(parser)
+    flags.AddBetaLoggingArg(parser)
+
+  def CallLogLevel(self, args):
+    return args.call_log_level
+
+  def ExecutionHistoryLevel(self, args):
+    return None
+
+  def Labels(self, args):
+    return None
+
+  def OverflowBufferingDisabled(self, args):
+    return False
+
+
+@base.ReleaseTracks(base.ReleaseTrack.ALPHA)
+class AlphaRun(Run):
+  """Execute a workflow and wait for the execution to complete."""
+
+  detailed_help = {
+      'DESCRIPTION':
+          '{description}',
+      'EXAMPLES':
+          """\
+        To execute a workflow named my-workflow with the data that will be passed to the workflow, run:
+
+          $ {command} my-workflow --data=my-data
+        """,
+  }
+
+  @staticmethod
+  def Args(parser):
+    Run.CommonArgs(parser)
+
+  def CallLogLevel(self, args):
+    return None
+
+  def ExecutionHistoryLevel(self, args):
+    return None
+
+  def Labels(self, args):
+    return None
+
+  def OverflowBufferingDisabled(self, args):
+    return False