Specifying a cloud network in which to run a workflow
Note
Currently, there are two UIs that support Workflows: Yandex Cloud and Yandex AI Studio. In this case, the following applies:
- Workflows created in the Yandex Cloud UI are automatically available in the AI Studio UI.
- Workflows created in the AI Studio UI are not available in the Yandex Cloud UI.
Starting September 3, 2026, Workflows will no longer be supported in the Yandex Cloud UI. To create and manage workflows, use the AI Studio UI.
You can specify a cloud network in which to run a workflow.
A cloud network must have:
- Subnets in all availability zones.
- At least one resource with an IP address in the specified cloud network.
Note
If the network does not meet the conditions above, the service does not guarantee it will function properly.
- In the management console, select the folder containing the workflow.
- Navigate to Serverless Integrations.
- In the left-hand panel, click Workflows.
- Click in the workflow row and select Edit.
- Expand the Additional parameters section and specify the network in the Network field.
- Click Save.
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.
To specify a cloud network, run this command:
yc serverless workflow update <workflow_name_or_ID> \
--yaml-spec <specification_file> \
--network-id <network_ID>
Where:
--yaml-spec: Path to the YaWL specification file for the workflow, e.g.,./yawl-spec.json.--network-id: ID of the cloud network the workflow will run in.
Result:
id: dfqjl5hh5p90********
folder_id: b1g681qpemb4********
specification:
spec_yaml: "yawl: ..."
created_at: "2025-03-11T09:27:51.691990Z"
name: my-workflow
description: created via cli
labels:
owner: "admin"
version: "alpha"
status: ACTIVE
log_options: {}
service_account_id: aje4tpd9coa********
network_id: enpm8v48ehcl********
To specify a cloud network, use the Update REST API method for the Workflows resource or the workflow/Update gRPC API call.