Contact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.

Linking a cloud to a billing account

Written by
Updated at February 24, 2026

You can link one or more clouds to your billing account. Both new and existing clouds can be linked. You cannot unlink a cloud from a billing account. Instead, you can relink it to a different billing account.

If a billing account is added to an organization, you can link clouds from your own organization and those from other organizations you have been granted access to in Yandex Cloud Billing.

Each cloud in Yandex Cloud must be linked to a single billing account. If you relink an existing cloud, you are effectively transferring it between billing accounts. For legal entities, you cannot relink a cloud and your DataSphere, Tracker, and DataLens services from a paid account to a trial period account.

Requirements for linking a cloud

Before linking a cloud, make sure the following conditions are met:

  1. Billing account has been successfully activated, i.e., its status is ACTIVE or TRIAL_ACTIVE.
  2. The user holds all these roles at once:

Linking a cloud

To link or re-link a cloud to a billing account:

  1. Go to Yandex Cloud Billing.

  2. Select the billing account you want to link the cloud to.

  3. In the left-hand panel, select Clouds and services.

  4. Click Link in the top-right corner.

    image

  5. In the Type field, pick the entity type you need from the list and select the resource to link to the billing account.

  6. Click Link; the cloud or service you added will appear in the list.

  7. If you are re-linking the cloud, pay any outstanding charges on the old billing account.

    image

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

To link a cloud, the service account must have the billing.accounts.editor role or higher for the billing account you are linking your cloud to.

To link a cloud to a billing account:

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

    resource "yandex_billing_cloud_binding" "mycloud" {
  billing_account_id = "<billing_account_ID>"
  cloud_id           = "<cloud_ID>"
}

    Where:

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

    For more information about yandex_billing_cloud_binding properties, see this Terraform provider guide.

  2. Create the resources:

    1. In the terminal, go to the directory where you edited the configuration file.

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

      terraform validate

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

      Success! The configuration is valid.

    3. Run this command:

      terraform plan

      You will see a detailed list of resources. No changes will be made at this step. If the configuration contains any errors, Terraform will show them.

    4. Apply the changes:

      terraform apply

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

After that, the cloud will be linked to the billing account. You can check that the cloud is linked to the account on the billing account page in Yandex Cloud Billing.

To link a cloud, use the bindBillableObject REST API method for the BillingAccount resource or the BillingAccountService/BindBillableObject gRPC API call.

If you want to stop using the old billing account, make sure it is on the free Basic service plan to avoid having your balance further debited. Otherwise, you will continue to be billed for the paid plan even if the account has no linked clouds.

Warning

Linking a cloud or another container to a suspended account will stop all your resources.

Resource management in organizations

  1. After you add your billing account to an organization, Yandex Cloud Billing will allow you to associate it with:

    To access the billable Yandex Identity Hub features, associate your billing account with your Identity Hub instance.

  2. The technical support service plan applies at the organization level and can only be changed by the organization owner. You can use a single billing account to pay the fixed support fees across multiple organizations that may have different support service plans activated.

Previous
Downloading personal data linked to a billing account
Next
Changing the billing account organization