Yandex Cloud
Search
Discuss with expertTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Yandex Cloud Router
    • All use cases
    • On-premises without redundancy and one cloud network
    • On-premises without redundancy and multiple cloud networks
    • On-premises with redundancy and one cloud network
    • On-premises with redundancy and multiple cloud networks
    • Two separate route instances without on-premises redundancy
    • Even redistribution of on-premise traffic (Active-Active)
    • Prioritizing on-premise traffic based on direction (Active-Standby)
    • Reserving an on-premise connection via a VPN gateway (PRC)
    • Prioritizing a static VPC route over routes from PRC
    • Even traffic distribution for route 0.0.0.0/0
    • Prioritizing traffic by direction for route 0.0.0.0/0
    • Connectivity for two cloud networks
    • Connectivity for two cloud networks and on-premises
  • Access management
    • Overview
      • Overview
        • Overview
        • add-private-connection
        • create
        • delete
        • get
        • get-by-cic-private-connection-id
        • get-by-vpc-network-id
        • list
        • list-operations
        • move
        • move-prefix
        • remove-prefixes
        • remove-private-connection
        • update
        • update-networks
        • update-prefix-mask
        • upsert-prefixes
  • Release notes
  1. CLI reference
  2. v1
  3. routing-instance
  4. create

yc cloudrouter v1 routing-instance create

Written by
Yandex Cloud
Updated at May 25, 2026

Creates a RoutingInstance resource in the specified folder using the data specified in the request.
Method starts an asynchronous operation that can be cancelled while it is in progress.

Command UsageCommand Usage

Syntax:

yc cloudrouter v1 routing-instance create <FOLDER-ID>

FlagsFlags

Flag

Description

-r, --request-file

string

Path to a request file.

--example-json

Generates a JSON template of the request.
The template can be customized and used as input for the command.
Usage example:

  1. Generate template: yc compute instance create --example-json > request.json
  2. Edit the template: vim request.json
  3. Run with template: yc compute instance create -r request.json

-e, --example-yaml

Generates a YAML template of the request.
The template can be customized and used as input for the command.
Usage example:

  1. Generate template: yc compute instance create --example-yaml > request.yaml
  2. Edit the template: vim request.yaml
  3. Run with template: yc compute instance create -r request.yaml

--name

string

Name of the RoutingInstance. The name must be unique within the folder. Value must match the regular expression ''\

a-zA-Z?''.

--description

string

Optional description of the RoutingInstance. 0-256 characters long.

--folder-id

string

ID of the folder that the RoutingInstance belongs to.

--vpc-info

shorthand/json

List of the info about vpcNetworks which are attached to the RoutingInstance.

Description
  • vpc-network-id (string)
    ID of the vpcNetwork that is attached to the routingInstance.
  • az-infos ([]structure)
    List of the az-related info about vpcNetworks which are attached to routingInstance
  • manual-info (structure)
    VpcInfo which is set by user
  • az-id (string)
    ID of the AZ
  • prefixes ([]string)
    List of prefixes to announce
Shorthand Syntax
[
  {
    az-infos = [
      {
        manual-info = {
          az-id = string,
          prefixes = string,...
        }
      }, ...
    ],
    vpc-network-id = string
  }, ...
]
JSON Syntax
[
  {
    "az-infos": [
      {
        "manual-info": {
          "az-id": "string",
          "prefixes": [
            "string", ...
          ]
        }
      }, ...
    ],
    "vpc-network-id": "string"
  }, ...
]

--cic-private-connection-info

shorthand/json

List of the info about privateConnections which are attached to the RoutingInstance.

Description
  • cic-private-connection-id (string)
    ID of the cicPrivateConnection that is attached to the routingInstance.
Shorthand Syntax
[
  {
    cic-private-connection-id = string
  }, ...
]
JSON Syntax
[
  {
    "cic-private-connection-id": "string"
  }, ...
]

--labels

map<string><string>

Resource labels, 'key:value' pairs. No more than 64 per resource. The maximum string length in characters for each value is 63. Each value must match the regular expression '[-_0-9a-z]'. The string length in characters for each key must be 1-63. Each key must match the regular expression '[a-z][-_0-9a-z]'.

--deletion-protection

--async

Display information about the operation in progress, without waiting for the operation to complete.

Global FlagsGlobal Flags

Flag

Description

--profile

string

Set the custom profile.

--region

string

Set the region.

--debug

Debug logging.

--debug-grpc

Debug gRPC logging. Very verbose, used for debugging connection problems.

--no-user-output

Disable printing user intended output to stderr.

--pager

string

Set the custom pager.

--no-pager

Do not pipe help output through a pager.

--format

string

Set the output format: text, yaml, json, table, summary || summary[name, instance.id, instance.disks[0].size].

--retry

int

Enable gRPC retries. By default, retries are enabled with maximum 5 attempts.
Pass 0 to disable retries. Pass any negative value for infinite retries.
Even infinite retries are capped with 2 minutes timeout.

--timeout

string

Set the timeout.

--token

string

Set the IAM token to use.

--impersonate-service-account-id

string

Set the ID of the service account to impersonate.

--no-browser

Disable opening browser for authentication.

--query

string

Query to select values from the response using jq syntax

--print-metadata

Print operation metadata along with result.

--syntax

string

CLI syntax: this standalone binary only supports 2 (current). Use main yc for syntax 1.

--cli-auto-prompt

string[="on"]

Enable interactive auto-prompt mode. Values: on, partial, off. Bare --cli-auto-prompt is equivalent to --cli-auto-prompt=on.

--no-cli-auto-prompt

Disable interactive auto-prompt mode (overrides --cli-auto-prompt, env and profile).

-h, --help

Display help for the command.

Was the article helpful?

Previous
add-private-connection
Next
delete
© 2026 Direct Cursus Technology L.L.C.