Updating a workflow

If you do not have the Yandex Cloud CLI yet, install and initialize it.

The folder used by default is the one specified when creating the CLI profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also specify a different folder for any command using --folder-name or --folder-id. If you access a resource by its name, the search will be limited to the default folder. If you access a resource by its ID, the search will be global, i.e., through all folders based on access permissions.

1. View the description of the CLI command for updating a workflow:

   yc serverless workflow update --help
   

2. Get a list of workflows:

   yc serverless workflow list
   

   Result:

   workflows:
     - id: dfqdi6ic7c5j********
       folder_id: b1g681qpemb4********
       created_at: "2025-03-10T13:31:55.387059Z"
       name: workflow895
       status: ACTIVE
       log_options:
         folder_id: b1g681qpemb4********
     ...
     - id: dfqud9cbc4k5********
       folder_id: b1g681qpemb4********
       created_at: "2025-03-10T12:57:48.679682Z"
       name: workflow203
       status: ACTIVE
       log_options:
         folder_id: b1g681qpemb4********
   

3. In the command, specify the parameters to update, such as the workflow name:

   yc serverless workflow update \
     --yaml-spec <specification_file> \
     --name <workflow_name> \
     --new-name <new_workflow_name>
   

   Where:

   • --yaml-spec: Path to the YaWL specification file for the workflow, e.g., ./yawl-spec.json.
   • --name: Old workflow name.
   • --new-name: New workflow name.

   Result:

   id: dfqjl5hh5p90********
   folder_id: b1g681qpemb4********
   specification:
     spec_yaml: "yawl: ..."
   created_at: "2025-03-11T09:27:51.691990Z"
   name: renamed-workflow
   description: created via cli
   labels:
     owner: "admin"
     version: "alpha"
   status: ACTIVE
   log_options: {}
   service_account_id: aje4tpd9coa********
   network_id: enpm8v48ehcl********
   

To update a workflow, use the Update REST API method for the Workflows resource or the workflow/Update gRPC API call.