Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
    • Yandex Cloud Partner program
  • Blog
  • Pricing
  • Documentation
© 2025 Direct Cursus Technology L.L.C.
Yandex Virtual Private Cloud
  • Getting started
    • All guides
      • Creating a static route
      • Creating and setting up a NAT gateway
      • Getting information about a NAT gateway
      • Moving a route table between folders
      • Getting information about a route table
      • Moving a NAT gateway between folders
      • Deleting a route table
      • Deleting a NAT gateway
    • Enabling a software-accelerated network
    • Chart of network connections
    • Viewing operations with resources
  • DDoS Protection
  • Access management
  • Terraform reference
  • Audit Trails events
  • Release notes
  • FAQ

In this article:

  • Examples
  • NAT gateway in a different folder
  1. Step-by-step guides
  2. Static routing
  3. Moving a NAT gateway between folders

Moving a NAT gateway to a different folder

Written by
Yandex Cloud
Updated at May 5, 2025
  • Examples
    • NAT gateway in a different folder

Note

The feature is at the Preview stage.

You can move cloud resources between folders within a single cloud.

Management console
CLI
API

To move a NAT gateway to a different folder:

  1. In the management console, go to the folder where the NAT gateway is located.
  2. In the list of services, select Virtual Private Cloud.
  3. In the left-hand panel, select Gateways.
  4. Click in the row of the NAT gateway to move and select Move.
  5. Select the destination folder from the drop-down list.
  6. Click Move.

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

The folder specified when creating the CLI profile is used by default. To change the default folder, use the yc config set folder-id <folder_ID> command. You can specify a different folder using the --folder-name or --folder-id parameter.

To move a NAT gateway to a different folder:

  1. View the description of the CLI command for moving a NAT gateway:

    yc vpc gateway move --help
    
  2. Get the name or ID of the NAT gateway to move:

    yc vpc gateway list
    

    Result:

    +----------------------+----------+-------------+
    |          ID          |   NAME   | DESCRIPTION |
    +----------------------+----------+-------------+
    | enckq19qqsr5******** | router-1 |             |
    +----------------------+----------+-------------+
    
  3. Get a list of available folders:

    yc resource-manager folder list
    

    Result:

    +----------------------+------------------------+--------+--------+
    |          ID          |          NAME          | LABELS | STATUS |
    +----------------------+------------------------+--------+--------+
    | b1cs8ie21pk1******** | default                |        | ACTIVE |
    | b1chgf288nvg******** | my-folder-1            |        | ACTIVE |
    | b1cu6g9ielh6******** | my-folder-2            |        | ACTIVE |
    +----------------------+------------------------+--------+--------+
    
  4. Move the NAT gateway by specifying the name or ID of the NAT gateway and destination folder:

    yc vpc gateway move <gateway_name_or_ID> \
      --destination-folder-name <destination_folder_name> \
      --destination-folder-id <destination_folder_ID>
    

    Use either --destination-folder-name or --destination-folder-id.

    If the gateway is not in the current folder (default folder), specify the source folder using --folder-name or --folder-id.

    Result:

    id: enckq19qqsr5********
    folder_id: b1chgf288nvg********
    created_at: "2022-10-06T10:14:04Z"
    name: router-1
    shared_egress_gateway: {}
    

    For more information about the yc vpc address move command, see the CLI reference.

To move a NAT gateway to a different folder, use the move REST API method for the Gateway resource or the GatewayService/Move gRPC API call, and provide the following in the request:

  • ID of the NAT gateway to move, in the gatewayId parameter.

    To get the NAT gateway ID, use the list REST API method for the Gateway resource or the GatewayService/List gRPC API call. In your request, provide the folder ID in the folderId parameter.

  • ID of the folder you want to move the NAT gateway to, in the destinationFolderId parameter.

    To learn how to find out the folder ID, see Getting the folder ID.

ExamplesExamples

NAT gateway in a different folderNAT gateway in a different folder

Move a NAT gateway from a different folder. Specify the NAT gateway ID and the source and destination folder IDs:

CLI
yc vpc gateway move enckq19qqsr5******** \
  --folder-id b1chgf288nvg******** \
  --destination-folder-id b1cs8ie21pk1********

See alsoSee also

  • Moving a cloud network to a different folder
  • Moving a subnet to a different folder

Was the article helpful?

Previous
Getting information about a route table
Next
Deleting a route table
© 2025 Direct Cursus Technology L.L.C.