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
    • Start testing with double trial credits
    • 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.
Getting started with Yandex Cloud
    • Step 1. Registration
    • Step 2. Billing
    • Step 3. Resource hierarchy
    • Step 4. Selecting a service plan
    • Step 5. Setting up a secure network configuration
    • Step 6. Logging
  • Initial grant

In this article:

  • Create a folder
  • Update a folder
  1. For individuals
  2. Step 3. Resource hierarchy

Configure your cloud

Written by
Yandex Cloud
Improved by
Danila N.
Updated at April 22, 2025
  • Create a folder
  • Update a folder

When a user registers with Yandex Cloud, a cloud is created for the user. The cloud is a separate workspace with this user as the owner. In this cloud, the default folder and default network will be created.

The owner can create new folders and resources in this cloud, and manage access rights to them.

Create a folderCreate a folder

Management console
CLI
API
  1. In the management console, select the appropriate cloud from the list on the left.

  2. At the top right, click Create folder.

  3. Give your folder a name. The naming requirements are as follows:

    • It must be from 2 to 63 characters long.
    • It may contain lowercase Latin letters, numbers, and hyphens.
    • It must start with a letter and cannot end with a hyphen.
  4. Optionally, specify the description for your folder.

  5. Select Create a default network. This will create a network with subnets in each availability zone. Within this network, you will also have a default security group, inside which all network traffic will be allowed.

  6. Click Create.

  1. View the description of the create folder command:

    $ yc resource-manager folder create --help
    
  2. Create a new folder:

    • with a name and without a description:

      $ yc resource-manager folder create \
          --name new-folder
      

      The folder naming requirements are as follows:

      • It must be from 2 to 63 characters long.
      • It may contain lowercase Latin letters, numbers, and hyphens.
      • It must start with a letter and cannot end with a hyphen.
    • with a name and description:

      $ yc resource-manager folder create \
          --name new-folder \
          --description "my first folder with description"
      

To create a folder, use the create method for the Folder.

Update a folderUpdate a folder

The management console only allows you to change the name of a folder. To change its description, use the CLI or API.

Management console
CLI
API
  1. On the management console home page, select the folder. This page displays folders for the selected cloud. You can switch to another cloud, if required.
  2. Click next to the folder and select Edit.
  3. Enter a new name for the folder.
  4. Click Save.
  1. View the description of the update folder command:

    $ yc resource-manager folder update --help
    
  2. If you know the folder ID or name, proceed to the next step. Otherwise, use one of these methods to get them:

    • Get a list of folders:

      $ yc resource-manager folder list
      +----------------------+--------------------+--------+--------+-------------+
      |          ID          |        NAME        | LABELS | STATUS | DESCRIPTION |
      +----------------------+--------------------+--------+--------+-------------+
      | b1gppulhhm2aaufq9eug | yet-another-folder |        | ACTIVE |             |
      | b1gvmob95yysaplct532 | default            |        | ACTIVE |             |
      +----------------------+--------------------+--------+--------+-------------+
      
    • If you know the ID of the resource that belongs to the required folder, you can get the folder ID from the information about that resource:

      $ yc <SERVICE-NAME> <RESOURCE> get <RESOURCE-ID>
      

      Where:

      • <SERVICE-NAME>: Service name, e.g., compute.
      • <RESOURCE>: Resource category, e.g., instance.
      • <RESOURCE-ID>: Resource ID.

      For example, the fhmp74bfis2aim728p2a VM belongs to the b1gpvjd9ir42nsng55ck folder:

      $ yc compute instance get fhmp74bfis2ais728p2a
      id: fhmp74bfis2ais728p2a
      folder_id: b1gpvjd9ia42nsng55ck
      ...
      
  3. Change the folder parameters, e.g., name and description. You can specify the folder to update by its name or ID.

    $ yc resource-manager folder update default \
        --new-name myfolder \
        --description "this is my default-folder"
    

    The command will rename the default folder to myfolder and update its description.

    The folder naming requirements are as follows:

    • It must be from 2 to 63 characters long.
    • It may contain lowercase Latin letters, numbers, and hyphens.
    • It must start with a letter and cannot end with a hyphen.

To edit the folder, use the update method for the Folder resource.

Was the article helpful?

Previous
Step 2. Billing
Next
Step 4. Selecting a service plan
© 2025 Direct Cursus Technology L.L.C.