[Yandex Cloud documentation](../../../index.md) > [Yandex Resource Manager](../../index.md) > [Step-by-step guides](../index.md) > Cloud > Creating a cloud

# Creating a new cloud

[After you sign up](../../../billing/quickstart/index.md#create_billing_account) with Yandex Cloud and create an [organization](../../../organization/concepts/organization.md), you can create your first [cloud](../../concepts/resources-hierarchy.md#cloud). If you need an additional cloud, follow the same guide to create it.

{% note info %}

When creating a cloud, you automatically get the [owner](../../concepts/resources-hierarchy.md#owner) role in this cloud.

{% endnote %}

To create a cloud:

{% list tabs group=instructions %}

- Management console {#console}

  1. On the [**Yandex Cloud Billing**](https://center.yandex.cloud/billing/accounts) page, make sure that the [billing account](../../../billing/concepts/billing-account.md) is in the `ACTIVE` or `TRIAL_ACTIVE` status. If you do not have a billing account, [create one](../../../billing/quickstart/index.md#create_billing_account) or ask your administrator to assign you the `billing.accounts.member` role for a billing account.
  1. In the [management console](https://console.yandex.cloud), in the top panel, click ![image](../../../_assets/console-icons/layout-side-content-left.svg) or ![image](../../../_assets/console-icons/chevron-down.svg) and select the [organization](../../../organization/concepts/organization.md).
  1. Click ![image](../../../_assets/console-icons/ellipsis.svg) to the right of the organization name.
  1. Select ![image](../../../_assets/console-icons/plus.svg) **Create cloud**.
  
     ![create-cloud1](../../../_assets/resource-manager/create-cloud-1.png)
  
  1. Enter a name for [your cloud](../../concepts/resources-hierarchy.md#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.
  
  1. Optionally, add a cloud label.
  1. Click **Create**.
  
     ![create-cloud2](../../../_assets/resource-manager/create-cloud-2.png)

- CLI {#cli}

  {% note info %}

  To create a new cloud using the Yandex Cloud CLI, [link](../../../cli/operations/profile/manage-properties.md#set) the organization to a [CLI profile](../../../cli/operations/profile/profile-list.md).

  {% endnote %}

  If you do not have the Yandex Cloud CLI yet, [install and initialize it](../../../cli/quickstart.md#install).

  1. View the description of the create cloud command:

      ```bash
      yc resource-manager cloud create --help
      ```

  1. If you do not have a linked organization yet, link the one you want to create the cloud in to the CLI profile.

      ```bash
      yc config set organization-id <organization_ID>
      ```

      Where `<organization_ID>` is the [ID](../../../organization/operations/organization-get-id.md) of the organization to create the cloud in.

  1. To create the cloud, run this command:

      ```bash
      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](../../../billing/concepts/billing-account.md) to link the new cloud to.

          You can get the billing account ID in the [Yandex Cloud Billing interface](https://center.yandex.cloud/billing/accounts) under **Account information** on the billing account page.

      Result:

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

- Terraform {#tf}

  If you do not have Terraform yet, [install it and configure the Yandex Cloud provider](../../../tutorials/infrastructure-management/terraform-quickstart.md#install-terraform).
  
  
  To manage infrastructure using Terraform under a service account or user accounts (a Yandex account, a federated account, or a local user), [authenticate](../../../terraform/authentication.md) using the appropriate method.

  {% note 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.

  {% endnote %}

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

      ```hcl
      # 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](../../../organization/operations/organization-get-id.md). Terraform allows you to create a cloud only for an existing organization.
      * `billing_account_id`: ID of the [billing account](../../../billing/concepts/billing-account.md) to link the new cloud to.

          You can get the [billing account ID](../../../billing/concepts/billing-account.md#billing-account-id) in the [Yandex Cloud Billing](https://center.yandex.cloud/billing/accounts) interface under **Account information** on the billing account page.
      * `cloud_id`: [ID](get-id.md) of the cloud to link to the billing account.

      For more information about the `yandex_resourcemanager_cloud` and `yandex_billing_cloud_binding` resource parameters in Terraform, see the [relevant provider documentation](../../../terraform/index.md).

  1. Create the resources:

      1. In the terminal, navigate to the configuration file directory.
      1. Make sure the configuration is correct using this command:
      
         ```bash
         terraform validate
         ```
      
         If the configuration is valid, you will get this message:
      
         ```bash
         Success! The configuration is valid.
         ```
      
      1. Run this command:
      
         ```bash
         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.
      1. Apply the configuration changes:
      
         ```bash
         terraform apply
         ```
      
      1. 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](https://console.yandex.cloud) or using this [CLI](../../../cli/quickstart.md) command:

    ```bash
    yc resource-manager cloud list
    ```

- API {#api}

  To create a cloud, use the [create](../../api-ref/Cloud/create.md) REST API method for the [Cloud](../../api-ref/Cloud/index.md) resource or the [CloudService/Create](../../api-ref/grpc/Cloud/create.md) gRPC API call.

{% endlist %}


#### See also {#see-also}

* [Renaming a cloud](update.md)
* [Setting up cloud access permissions](set-access-bindings.md)
* [Switch clouds](switch-cloud.md)
* [Creating a folder](../folder/create.md)
* [Billing accounts](../../../billing/concepts/billing-account.md)