> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nebius.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing project limits for capacity block groups

Use [project limits](/overview/limits/project-limits) (also called capacity allowance) to control how much of a capacity block group (CBG) a project can consume. This article explains how to view, set, remove and disable project limits for capacity block groups.

## Prerequisites

Make sure you are in a [group](/iam/authorization/groups/index) that has the `admin` role within your tenant; for example, the default `admins` group. You can check this in the [Administration → IAM](https://console.nebius.com/iam) section of the web console.

## How to view project limits

<Tabs group="interfaces">
  <Tab title="Web console">
    1. In the [web console](https://console.nebius.com), go to <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/administration.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e6411dc023fd6972922c0a12a59ccf21" width="16" height="16" data-path="_assets/sidebar/administration.svg" /> **Administration** → **Limits**.
    2. Open the **Capacity block groups** tab.
    3. Click the capacity block group that you want to view.
    4. Open the **Project limits** tab.

    The table shows the following for each project:

    * **Usage**: Current GPU consumption from the CBG. If usage exceeds the project limit or the current CBG size, running workloads continue, but new CBG allocations are blocked. Usage above the CBG size is billed at [pay-as-you-go (PAYG) prices](/signup-billing/billing-models/payg#payg-prices).
    * **Limit**: Configured and effective limit of GPU consumption, if they differ. The effective limit is always capped at the current CBG size.
  </Tab>

  <Tab title="CLI">
    To view the project limits for a specific CBG, run:

    ```bash theme={null}
    nebius capacity capacity-allowance list-by-capacity-block-group \
      --capacity-block-group-id <CBG_ID>
    ```

    To get the CBG ID, run:

    ```bash theme={null}
    nebius capacity capacity-block-group list
    ```
  </Tab>
</Tabs>

## How to set a custom project limit

<Tabs group="interfaces">
  <Tab title="Web console">
    1. In the [web console](https://console.nebius.com), go to <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/administration.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e6411dc023fd6972922c0a12a59ccf21" width="16" height="16" data-path="_assets/sidebar/administration.svg" /> **Administration** → **Limits**.
    2. Open the **Capacity block groups** tab.
    3. Click the capacity block group that you want to set a project limit for.
    4. Open the **Project limits** tab.
    5. In the row of the required project, click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad" width="12" height="24" data-path="_assets/button-vellipsis.svg" /> → **Set custom limit**.
    6. Enter the limit value and click **Save changes**.
  </Tab>

  <Tab title="CLI">
    To set a custom limit for a specific CBG, run:

    ```bash theme={null}
    nebius capacity capacity-allowance create \
      --capacity-block-group-id <CBG_ID> \
      --parent-id <project_ID> \
      --limit <limit_value>
    ```

    In the command, specify the parameters:

    * `--capacity-block-group-id`: ID of the CBG where you want to set a custom limit. To get it, run:

      ```bash theme={null}
      nebius capacity capacity-block-group list
      ```

    * `--parent-id`: [Project ID](/iam/manage-projects#cli-3).

    * `--limit`: Project limit value you want to set.
  </Tab>
</Tabs>

<Note>
  Setting the limit to `0` [disables](/overview/limits/manage-project-limits#how-to-disable-cbg-usage-for-a-project) CBG usage for the project.
</Note>

## How to remove a project limit

Removing a project limit removes the configured value. The effective limit becomes the current capacity block group size.

<Tabs group="interfaces">
  <Tab title="Web console">
    1. In the [web console](https://console.nebius.com), go to <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/administration.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e6411dc023fd6972922c0a12a59ccf21" width="16" height="16" data-path="_assets/sidebar/administration.svg" /> **Administration** → **Limits**.
    2. Open the **Capacity block groups** tab.
    3. Click the capacity block group that you want to remove a project limit from.
    4. Open the **Project limits** tab.
    5. In the row of the required project, click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad" width="12" height="24" data-path="_assets/button-vellipsis.svg" /> → **Limit by CBG size**.
  </Tab>

  <Tab title="CLI">
    To remove a specific project limit from a CBG, run:

    ```bash theme={null}
    nebius capacity capacity-allowance delete <capacity_allowance_ID>
    ```

    In the command, specify the project limit ID. To get it, run:

    ```bash theme={null}
    nebius capacity capacity-allowance list-by-capacity-block-group \
      --capacity-block-group-id <CBG_ID>
    ```

    To get the CBG ID, run:

    ```bash theme={null}
    nebius capacity capacity-block-group list
    ```
  </Tab>
</Tabs>

## How to disable CBG usage for a project

<Warning>
  When you disable CBG usage, running workloads continue, but can't restart once stopped. New CBG allocations are not possible.
</Warning>

<Tabs group="interfaces">
  <Tab title="Web console">
    1. In the [web console](https://console.nebius.com), go to <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/sidebar/administration.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e6411dc023fd6972922c0a12a59ccf21" width="16" height="16" data-path="_assets/sidebar/administration.svg" /> **Administration** → **Limits**.
    2. Open the **Capacity block groups** tab.
    3. Click the capacity block group where you want to disable CBG usage for a project.
    4. Open the **Project limits** tab.
    5. In the row of the required project, click <Icon icon="https://mintcdn.com/nebius-ai-cloud/1Ha0sWR6e1mnIaHS/_assets/button-vellipsis.svg?fit=max&auto=format&n=1Ha0sWR6e1mnIaHS&q=85&s=e80b8e57c43bfd117679262e6a1334ad" width="12" height="24" data-path="_assets/button-vellipsis.svg" /> → **Disable CBG usage**.

    You can also disable CBG usage for a project by setting the project limit to `0`.
  </Tab>

  <Tab title="CLI">
    To disable CBG usage for a project, set the project limit to `0`:

    ```bash theme={null}
    nebius capacity capacity-allowance create \
      --capacity-block-group-id <CBG_ID> \
      --parent-id <project_ID> \
      --limit 0
    ```

    In the command, specify the parameters:

    * `--capacity-block-group-id`: CBG ID. To get it, run:

      ```bash theme={null}
      nebius capacity capacity-block-group list
      ```

    * `--parent-id`: [Project ID](/iam/manage-projects#cli-3).
  </Tab>
</Tabs>
