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.
When you create a resource or list resources in interactive mode, the CLI prompts you for parameter values step by step, validates each value before continuing and shows the resulting configuration before you apply it. To use the interactive mode, add the -i or --interactive parameter to your CLI command.
Creating resources interactively
When you run a resource creation command in the interactive mode, the CLI prompts for parameters in this order:
- Metadata parameters.
- Required parameters.
- Optional parameters.
How the parameters are filled in depends on their data type:
-
For
string parameters, specify the string directly or use the contents of a file if the string is too long. For example:
cloud-init-user-data (string): file: ./user-data.txt
-
For the
oneof, enum and bool parameters, the CLI prompts you to select one of the supported values.
If some parameters repeat, the CLI prompts you to fill in each of them separately.
After you fill in the parameters, the CLI shows the full resource configuration and lets you apply it, correct the values or abort creation.
For example, to create a virtual machine (VM) in the interactive mode:
-
Create a boot disk.
-
Run the VM creation command:
nebius compute instance create --interactive
Example session:
...
parent-id (required) (string): project-***
Human readable name for the resource.
name (string): example-vm
Labels associated with the resource.
labels (map) string=string[,string=string]:
Populate required fields
resources-platform (required) (string): gpu-l40s-d
resources-preset (required) (string): 1gpu-16vcpu-96gb
network-interfaces-0-subnet-id (required) (string): vpcsubnet-***
network-interfaces-0-name (required) (string): eth0
Do you want to populate the network-interfaces-0-ip-address message ? [Y/n]: y
network-interfaces-0-ip-address-allocation-id (string): vpcallocation-***
Do you want to populate the network-interfaces-0-public-ip-address message ? [Y/n]: y
network-interfaces-0-public-ip-address-allocation-id (string): vpcallocation-***
network-interfaces-0-public-ip-address-static (bool): true
Do you want to populate the network-interfaces-0-aliases message ? [Y/n]: n
Do you want to populate the network-interfaces-0-security-groups message ? [Y/n]: n
Add another entry to the network-interfaces list? [Y/n]: n
Do you want to populate the optional fields? [y/N]: y
...
Do you want to populate the boot-disk message ? [Y/n]: y
boot-disk-attach-mode (required) (enum): READ_WRITE
Select one of (boot-disk-type (required)): boot-disk-existing-disk (message)
Do you want to populate the boot-disk-existing-disk message ? [Y/n]: y
boot-disk-existing-disk-id (required) (string): computedisk-***
boot-disk-device-id (string): dev-1
...
First, set the metadata parameters, such as parent-id and name.
Then, set the required parameters, such as resources-platform and resources-preset.
Finally, set the optional parameters, such as boot-disk-attach-mode and boot-disk-existing-disk-id. Although the boot disk parameters are marked as optional, they still require input for the command to succeed.
To create a VM, you can either create a boot disk in advance and then set it in the boot-disk-existing-disk configuration. Alternatively, use the boot-disk-managed-disk configuration, and create the boot disk and the VM simultaneously.
After you fill in the parameters, the CLI shows the full resource and lets you apply it.
Listing resources interactively
When you run a command in interactive mode, the CLI displays the output in an alternate screen with pagination.
In this mode, you can:
- Use the keyboard to switch between pages.
- Use the keyboard or mouse to scroll through the current page.
For example, to check Audit Logs in the interactive mode, run:
nebius audit v2 audit-event list \
--interactive \
--parent-id <tenant_ID> \
--start 2025-09-01T00:00:00Z \
--end 2025-10-01T00:00:00Z \
--page-size 10 \
--format 'table(action,resource.metadata.type,status,time)'
The --page-size parameter sets the number of items per page. If you do not specify this parameter, the default value is 100.
The --format parameter sets the output format. Supported values are yaml, json, jsonpath, table and text. In the given example, the --format parameter displays the output as a table and includes only the action, resource.metadata.type, status and time columns.
Example output:
ACTION TIME RESOURCE.METADATA.TYPE STATUS
GET 2025-09-30T23:41:01.735292820Z vpcsubnet DONE
GET 2025-09-30T23:39:57.822525674Z vpcsubnet DONE
GET 2025-09-30T23:39:57.732298637Z vpcsubnet DONE
DELETE 2025-09-30T23:35:46.248317235Z serviceaccount DONE
DELETE 2025-09-30T23:35:46.019666980Z serviceaccount DONE
LIST 2025-09-30T23:35:45.868348266Z serviceaccount DONE
LIST 2025-09-30T23:35:45.225734490Z group DONE
LIST 2025-09-30T23:35:43.908091679Z accesskey DONE
LIST 2025-09-30T23:35:43.458795049Z statickey DONE
LIST 2025-09-30T23:35:33.063804463Z computeimage DONE
page 5 • ←/→ pages • ↑/↓ scroll • A/D = horizontal scroll • q/Esc exit • Enter = next page