Yandex Cloud
Documentation
PresentationContact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.
Yandex Resource Manager
  • Getting started
    • All guides
    • Managing labels
      • Creating a cloud
      • Creating a cloud in another region
      • Renaming a cloud
      • Deleting a cloud
      • Canceling cloud deletion
      • Managing access policies
      • Setting up access rights
      • Getting a cloud ID
      • Switch clouds
      • Changing an organization for a cloud
      • Getting notifications from services in a cloud
    • Viewing service resource operations
  • Access management
  • Pricing policy
  • Terraform reference
  • Audit Trails events
  • Release notes
  • FAQ
  1. Step-by-step guides
  2. Cloud
  3. Creating a cloud

Creating a new cloud

Written by
Yandex Cloud
Improved by
Danila N.
Updated at November 17, 2026
View in Markdown

After you sign up with Yandex Cloud and create an organization, you can create your first cloud. If you need an additional cloud, follow the same guide to create it.

To create a cloud, you need the resource-manager.editor or editor role for the organization you are creating the cloud in or a broader role. If you created an organization, you already have the required permissions as its owner.

Note

When creating a cloud, you automatically get the owner role in this cloud.

To create a cloud:

Management console
CLI
Terraform
API
  1. Navigate to the Yandex Cloud Billing page and make sure your billing account status is ACTIVE or TRIAL_ACTIVE. If you do not have a billing account, create one or ask your administrator to assign you the billing.accounts.member role for a billing account.

  2. In the management console, in the top panel, click or and select the organization.

  3. Click to the right of the organization name.

  4. Select Create cloud.

    create-cloud1

  5. Enter a name for your cloud. The naming requirements are as follows:

    • Length: between 3 and 63 characters.
    • It can only contain lowercase Latin letters, numbers, and hyphens.
    • It must start with a letter and cannot end with a hyphen.
  6. Optionally, add a cloud label.

  7. Click Create.

    create-cloud2

Note

To create a new cloud using the Yandex Cloud CLI, link the organization to a CLI profile.

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

  1. View the description of the create cloud command:

    yc resource-manager cloud create --help
    
  2. If you do not have a linked organization yet, link the one you want to create the cloud in to the CLI profile.

    yc config set organization-id <organization_ID>
    

    Where <organization_ID> is the ID of the organization to create the cloud in.

  3. To create the cloud, run this command:

    yc resource-manager cloud create \
      --name <cloud_name> \
      --billing-account-id <billing_account_ID>
    

    Where:

    • --name: Name of the new cloud. The naming requirements are as follows:

      • Length: between 3 and 63 characters.
      • It can only contain lowercase Latin letters, numbers, and hyphens.
      • It must start with a letter and cannot end with a hyphen.
    • --billing-account-id: ID of the billing account to link the new cloud to.

      You can get the billing account ID in the Yandex Cloud Billing interface under Account information on the billing account page.

    Result:

    done (4s)
    id: b1gbi30tq0m9********
    created_at: "2024-12-10T09:25:22Z"
    name: my-new-cloud
    organization_id: bpfaidqca8vd********
    

If you do not have Terraform yet, install it and configure the Yandex Cloud provider.

To manage infrastructure using Terraform under a service account or user accounts (a Yandex account, a federated account, or a local user), authenticate using the appropriate method.

Warning

To activate the cloud, make sure to link it to your billing account. Until then, the new cloud will remain in the Creating status. To link the cloud to your billing account, use the yandex_billing_cloud_binding resource and specify the cloud ID in the cloud_id field.

  1. In the Terraform configuration file, describe the resources you want to create:

    # Creating a cloud
    
    resource "yandex_resourcemanager_cloud" "cloud1" {
      name            = "<cloud_name>"
      organization_id = "<organization_ID>"
    }
    
    # Linking the cloud to the billing account
    
    resource "yandex_billing_cloud_binding" "mycloud" {
      billing_account_id = "<billing_account_ID>"
      cloud_id           = yandex_resourcemanager_cloud.cloud1.id
    }
    

    Where:

    • name: Cloud name. The naming requirements are as follows:

      • Length: between 3 and 63 characters.
      • It can only contain lowercase Latin letters, numbers, and hyphens.
      • It must start with a letter and cannot end with a hyphen.
    • organization_id: Organization ID. Terraform allows you to create a cloud only for an existing organization.

    • billing_account_id: ID of the billing account to link the new cloud to.

      You can get the billing account ID in the Yandex Cloud Billing interface under Account information on the billing account page.

    • cloud_id: ID of the cloud to link to the billing account.

    For more on the properties of the yandex_resourcemanager_cloud and yandex_billing_cloud_binding resources in Terraform, see this provider guide.

  2. Create the resources:

    1. In the terminal, navigate to the configuration file directory.

    2. Make sure the configuration is correct using this command:

      terraform validate
      

      If the configuration is valid, you will get this message:

      Success! The configuration is valid.
      
    3. Run this command:

      terraform plan
      

      You will see a list of resources and their properties. No changes will be made at this step. Terraform will show any errors in the configuration.

    4. Apply the configuration changes:

      terraform apply
      
    5. Type yes and press Enter to confirm the changes.

This will create a cloud linked to your billing account in the organization. You can check the new cloud and its parameters in the management console or using this CLI command:

yc resource-manager cloud list

To create a cloud, use the create REST API method for the Cloud resource or the CloudService/Create gRPC API call.

Useful linksUseful links

  • Renaming a cloud
  • Setting up cloud access permissions
  • Switch clouds
  • Creating a folder
  • Billing accounts

Was the article helpful?

Previous
Managing labels
Next
Creating a cloud in another region
© 2026 Direct Cursus Technology L.L.C.