Managing projects in Nebius AI Cloud

Resources in Nebius AI Cloud are organized and managed within projects. When a tenant is created, a project per region is created by default. You can additionally create projects and edit existing ones.

Prerequisites

The prerequisites for this guide depend on the interface that you use.

Web console
CLI
Terraform

Make sure that you are in a group that has the admin role within your tenant; for example, the default admins group. You can check this in the Administration → IAM section of the web console.

Make sure that you are in a group that has the admin role within your tenant; for example, the default admins group. You can check this in the Administration → IAM section of the web console.
Install and configure the Nebius AI Cloud CLI.

Use one profile per projectCreate a separate Nebius AI Cloud CLI profile for each project to ensure correct region-specific configuration.

How to create a project

Web console
CLI
Terraform

In the web console, expand the top-left list of projects.
Click Create project. A drop-down list of available projects opens.
In this list, click Create project.
In the project creation form, specify the project settings:
- Select the tenant and region. You cannot change them later.
- Enter the name of the new project. The name should be unique in the tenant. You can edit it later.
Click Create project.

Create a project:

nebius iam v2 project create \
  --parent-id <tenant_ID> \
  --name <project_name> \
  --region <region_name>

The command contains the following parameters:

--parent-id: ID of the tenant where the project is created. To get the tenant ID, go to the web console and expand the top-left list of tenants. Next to the tenant’s name, click → Copy tenant ID.
--name: Name of the project.
--region: Name of the region where the project is created.
You can only create a project via the Nebius AI Cloud CLI in public regions. If you try to create a project in a private region, you receive an error.

Create the following configuration file:
```
resource "nebius_iam_v2_project" "<project_name>" {
  name = "<project_name>"
  parent_id = "<tenant_ID>"
  region = "<region_name>"
}
```
The resource contains the following parameters:
- --parent-id: ID of the tenant where the project is created. To get the tenant ID, go to the web console and expand the top-left list of tenants. Next to the tenant’s name, click → Copy tenant ID.
- --name: Name of the project.
- --region: Name of the region where the project is created.
Check that the configuration is correct:
```
terraform validate
```
Apply the changes:
```
terraform apply
```

How to get a project ID

To get the ID of a project:

Web console
CLI
Terraform

In the web console, expand the top list of projects.
Next to the project’s name, click → Copy project ID.

Run the following command:

nebius iam v2 project get-by-name --parent-id <tenant_ID> --name <project_name>

In this command, specify the parameters:

--parent-id: ID of the tenant where the project is created.
--name: Name of the project. If you do not know the exact name of the project, use the list command to view the list of all projects of your tenant:
```
nebius iam v2 project list --parent-id <tenant_ID>
```

In your Terraform working directory, get the attributes of your project using its name:

terraform state show nebius_iam_v2_project.<project_name>

The id attribute in the output contains the project ID.If you do not know the exact name of the project, list all the resources from your Terraform state file (.tfstate) to find the project name:

terraform state list

How to edit a project

For an existing project, you can only edit the name. You cannot move a project to another region or tenant. To edit the project name:

Web console
CLI
Terraform

In the web console, expand the top-left list of projects.
In the line of the required project, click → Configure.
Enter a new value in the Name field.
Click Save.

Run the following command:

nebius iam v2 project edit \
  --id <project_ID>
  [--editor '<editor_terminal_name> --wait'] \
  [--format <json|yaml>]

In this command, specify the parameters:

--id: ID of the project.
--editor (optional): Editor name. It can be any editor installed on your machine, such as nano or emacs. To check which of the popular editors are installed, run the following command:
```
which code emacs gedit micro nano subl vi vim
```
For an editor that opens in a separate window, add the --wait parameter to its name to ensure that the command waits until you close the editor.
--format (optional): Data format. Only json and yaml values are accepted. By default, YAML format is used.

The editor you choose opens and shows the current configuration of the project. Change the project name and save the configuration. When you exit the editor, the Nebius AI Cloud CLI checks if the data is valid and updates the resource.

In the configuration file, edit the name argument of the corresponding nebius_iam_v2_project resource.
Check that the configuration is correct:
```
terraform validate
```
Apply the changes:
```
terraform apply
```

How to delete a project

Before you delete a project, make sure to remove all resources from it. You can only delete an empty project.

Web console
CLI
Terraform

In the web console, expand the top-left list of projects.
In the line of the required project, click → Delete project.

Delete the project:

nebius iam v2 project delete --id <project_ID>

Remove the corresponding nebius_iam_v2_project resource from the configuration file.
Check that the configuration is correct:
```
terraform validate
```
Apply the changes:
```
terraform apply
```

Nebius AI Cloud signup and payments

Identity and Access Management in Nebius AI Cloud

Overview of Nebius AI Cloud

Managing projects in Nebius AI Cloud

Prerequisites

How to create a project

How to get a project ID

How to edit a project

How to delete a project

Nebius AI Cloud signup and payments

Identity and Access Management in Nebius AI Cloud

Overview of Nebius AI Cloud

​Prerequisites

​How to create a project

​How to get a project ID

​How to edit a project

​How to delete a project

Prerequisites

How to create a project

How to get a project ID

How to edit a project

How to delete a project