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.
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 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 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.
-
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>
-
--parent-id: 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>"
}
parent_id: Tenant ID.name: Name of the project.region: Name of the region where the project is created.
-
Check that the configuration is correct:
-
Apply the changes:
How to get a project ID
To get the ID of a project:
Web console
CLI
Terraform
- In the web console, expand the top-left 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>
-
--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>
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: 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>]
-
--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
--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:
- Apply the changes:
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:
- Apply the changes:
