> ## 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.

# nebius compute instance create

## Name

`nebius compute instance create`

Creates a new VM instance based on the provided specification.\

For details, see [https://docs.nebius.com/compute/virtual-machines/manage](https://docs.nebius.com/compute/virtual-machines/manage.md).

## Synopsis

```
nebius compute instance create
  --boot-disk-attach-mode [required]
  --boot-disk-device-id
  --boot-disk-existing-disk-id
  --boot-disk-managed-disk-block-size-bytes
  --boot-disk-managed-disk-disk-encryption-type
  --boot-disk-managed-disk-forbid-deletion
  --boot-disk-managed-disk-labels
  --boot-disk-managed-disk-name
  --boot-disk-managed-disk-size-bytes
  --boot-disk-managed-disk-size-gibibytes
  --boot-disk-managed-disk-size-kibibytes
  --boot-disk-managed-disk-size-mebibytes
  --boot-disk-managed-disk-source-image-family-image-family
  --boot-disk-managed-disk-source-image-family-parent-id
  --boot-disk-managed-disk-source-image-id
  --boot-disk-managed-disk-source-snapshot-id
  --boot-disk-managed-disk-type
  --cloud-init-user-data
  --filesystems
  --follows-spot-price
  --gpu-cluster-id
  --hostname
  --labels
  --local-disks-passthrough-group-requested
  --name
  --network-interfaces [required]
  --nvl-instance-group-id
  --on-demand
  --parent-id [required]
  --preemptible-on-preemption
  --preemptible-priority
  --recovery-policy
  --reservation-policy-policy
  --reservation-policy-reservation-ids
  --resource-version
  --resources-platform [required]
  --resources-preset [required]
  --secondary-disks
  --service-account-id
  --spot-pricing-policy-id
  --stopped
  --async
  -i, --interactive
```

## Examples

**Create a VM without an additional disk**

```
nebius compute instance create \
   --name <VM_name> \
   --resources-platform <platform> \
   --resources-preset <preset> \
   --boot-disk-managed-disk-name managed-boot-disk \
   --boot-disk-managed-disk-type network_ssd \
   --boot-disk-managed-disk-size-gibibytes 10 \
   --boot-disk-managed-disk-source-image-family-image-family ubuntu24.04-driverless \
   --boot-disk-attach-mode READ_WRITE \
   --network-interfaces '[{"name": "eth0", "ip_address": {}, "public_ip_address": {}, "subnet_id": "<subnet_ID>"}]'
```

**Create a VM from a file via stdin**

```
nebius compute instance create \
  "$(cat /path-to-spec/instance.yaml)" \
  --service-account-id <service_account_ID>
```

**Create a VM in a GPU cluster**

```
nebius compute instance create \
  --name <VM_name> \
  --resources-platform <platform> \
  --resources-preset <preset> \
  --boot-disk-managed-disk-name managed-boot-disk \
  --boot-disk-managed-disk-type network_ssd \
  --boot-disk-managed-disk-size-gibibytes 10 \
  --boot-disk-managed-disk-source-image-family-image-family ubuntu24.04-cuda13.0 \
  --boot-disk-attach-mode READ_WRITE \
  --network-interfaces '[{"name": "eth0", "ip_address": {}, "public_ip_address": {}, "subnet_id": "<subnet_ID>"}]' \
  --gpu-cluster-id <GPU_cluster_ID>
```

## Options

`--boot-disk-attach-mode` (string)* \[required]*

A value must be one of:

<ul>
  <li>
    `read_only`
  </li>

  <li>
    `read_write`
  </li>
</ul>

`--boot-disk-device-id` (string)

Specifies the user-defined device identifier.\

Use `/dev/disk/by-id/virtio-{device_id}` as the device path in a mount command.

`--boot-disk-existing-disk-id` (string)

Mutually exclusive with: `--boot-disk-managed-disk-... flags group`.

`--boot-disk-managed-disk-block-size-bytes` (int64)

Block size in bytes.\

The block size must be a power of two between 4096 bytes (4 KiB) and 131072 bytes (128 KiB).\

The default value is 4096 bytes (4 KiB).

Mutually exclusive with: `--boot-disk-existing-disk-id`.

`--boot-disk-managed-disk-disk-encryption-type` (string)

A value must be one of:

<ul>
  <li>
    `disk_encryption_unspecified`
  </li>

  <li>
    `disk_encryption_managed`
  </li>
</ul>

Mutually exclusive with: `--boot-disk-existing-disk-id`.

`--boot-disk-managed-disk-forbid-deletion` (bool)

Prevents deletion whilst set.

Mutually exclusive with: `--boot-disk-existing-disk-id`.

`--boot-disk-managed-disk-labels` (string->string)

Labels associated with disk resource.

Mutually exclusive with: `--boot-disk-existing-disk-id`.

`--boot-disk-managed-disk-name` (string)

Name of a dependent disk.\

Use it to convert an ExistingDisk to a dependent disk.\

Changing the name will replace the disk and cause data loss.

Mutually exclusive with: `--boot-disk-existing-disk-id`.

`--boot-disk-managed-disk-size-bytes` (int64)

Mutually exclusive with: `--boot-disk-existing-disk-id`, `--boot-disk-managed-disk-size-gibibytes`, `--boot-disk-managed-disk-size-kibibytes`, `--boot-disk-managed-disk-size-mebibytes`.

`--boot-disk-managed-disk-size-gibibytes` (int64)

Mutually exclusive with: `--boot-disk-existing-disk-id`, `--boot-disk-managed-disk-size-bytes`, `--boot-disk-managed-disk-size-kibibytes`, `--boot-disk-managed-disk-size-mebibytes`.

`--boot-disk-managed-disk-size-kibibytes` (int64)

Mutually exclusive with: `--boot-disk-existing-disk-id`, `--boot-disk-managed-disk-size-bytes`, `--boot-disk-managed-disk-size-gibibytes`, `--boot-disk-managed-disk-size-mebibytes`.

`--boot-disk-managed-disk-size-mebibytes` (int64)

Mutually exclusive with: `--boot-disk-existing-disk-id`, `--boot-disk-managed-disk-size-bytes`, `--boot-disk-managed-disk-size-gibibytes`, `--boot-disk-managed-disk-size-kibibytes`.

`--boot-disk-managed-disk-source-image-family-image-family` (string)

Mutually exclusive with: `--boot-disk-existing-disk-id`, `--boot-disk-managed-disk-source-image-id`, `--boot-disk-managed-disk-source-snapshot-id`.

`--boot-disk-managed-disk-source-image-family-parent-id` (string)

Mutually exclusive with: `--boot-disk-existing-disk-id`, `--boot-disk-managed-disk-source-image-id`, `--boot-disk-managed-disk-source-snapshot-id`.

`--boot-disk-managed-disk-source-image-id` (string)

Mutually exclusive with: `--boot-disk-existing-disk-id`, `--boot-disk-managed-disk-source-image-family-image-family`, `--boot-disk-managed-disk-source-image-family-parent-id`, `--boot-disk-managed-disk-source-snapshot-id`.

`--boot-disk-managed-disk-source-snapshot-id` (string)

Mutually exclusive with: `--boot-disk-existing-disk-id`, `--boot-disk-managed-disk-source-image-family-image-family`, `--boot-disk-managed-disk-source-image-family-parent-id`, `--boot-disk-managed-disk-source-image-id`.

`--boot-disk-managed-disk-type` (string)

The type of disk defines the performance and reliability characteristics of the block device.\

For details, see [https://docs.nebius.com/compute/storage/types#disks-types](https://docs.nebius.com/compute/storage/types.md#disks-types).

A value must be one of:

<ul>
  <li>
    `unspecified`
  </li>

  <li>
    `network_ssd`
  </li>

  <li>
    `network_hdd`
  </li>

  <li>
    `network_ssd_non_replicated`
  </li>

  <li>
    `network_ssd_io_m3`
  </li>
</ul>

Mutually exclusive with: `--boot-disk-existing-disk-id`.

`--cloud-init-user-data` (string)

Data in cloud-init format for customizing instance initialization.\

For details, see [https://docs.nebius.com/compute/virtual-machines/manage#user-data](https://docs.nebius.com/compute/virtual-machines/manage.md#user-data).

`--filesystems` (json)

List of Shared Filesystems attached to the instance.

(structure)

**attach\_mode** -> (string)*\[required]*

A value must be one of:

<ul>
  <li>
    `"unspecified"`
  </li>

  <li>
    `"read_only"`
  </li>

  <li>
    `"read_write"`
  </li>
</ul>

**existing\_filesystem** -> (structure)

**id** -> (string)*\[required]*

**mount\_tag** -> (string)*\[required]*

Specifies the user-defined identifier, allowing to use it as a device in mount command.

JSON Schema:

```json theme={null}
[{                                                     
  "attach_mode": "unspecified"|"read_only"|"read_write",
  "existing_filesystem": {
    "id": ""              
  },
  "mount_tag": ""                                      
}]
```

`--follows-spot-price` (bool)

The preemptible VM accepts the current spot price.

Mutually exclusive with: `--on-demand`, `--spot-pricing-policy-id`.

`--gpu-cluster-id` (string)

If you want to interconnect several instances in a GPU cluster via NVIDIA InfiniBand,\

set the ID of an existing GPU cluster.\

You can only add the VM to the cluster when creating the VM.\

For details, see [https://docs.nebius.com/compute/clusters/gpu](https://docs.nebius.com/compute/clusters/gpu.md).

`--hostname` (string)

Instance's hostname. Used to generate default DNS record in format `<hostname>.<network_id>.compute.internal.`\

or `<instance_id>.<network_id>.compute.internal.` if hostname is not specified.

`--labels` (string->string)

Labels associated with the resource.

`--local-disks-passthrough-group-requested` (bool)

Passthrough local disks from the underlying host.\


Devices are expected to appear in the guest as NVMe devices (nvme0, nvme1, ...),\

but the exact number depends on the preset.\

Enabled only when this field is explicitly set.

`--name` (string)

Human-readable name for the resource.

`--network-interfaces` (json)* \[required]*

List of network interfaces attached to the instance.

(structure)

**aliases** -> (structure)

Assign ranges of IP addresses as aliases.

**allocation\_id** -> (string)*\[required]*

ID of allocation.

**ip\_address** -> (structure)*\[required]*
*\[immutable]*
*\[meaningful\_empty\_value]*

Private IPv4 address associated with the interface.

**allocation\_id** -> (string)

Allocation identifier if it was created before.

**name** -> (string)*\[required]*
*\[immutable]*

Interface name\

Value of this field configures the name of the network interface inside VM's OS.\

Longer values will persist in the specification but will be truncated to 15 symbols before being passed to VM configuration.

**public\_ip\_address** -> (structure)*\[meaningful\_empty\_value]*

Public IPv4 address associated with the interface.

**allocation\_id** -> (string)

Allocation identifier if it was created before.

**static** -> (bool)

If false - Allocation will be created/deleted during NetworkInterface.Allocate/NetworkInterface.Deallocate\

If true  - Allocation will be created/deleted during NetworkInterface.Create/NetworkInterface.Delete\

False by default.

**security\_groups** -> (structure)

Security groups associated with the network interface.\

If an empty list is provided, the default security group for the network will be used.\

Effective security groups can be seen in the status.

**id** -> (string)

Security group identifier.

**subnet\_id** -> (string)*\[immutable]*

Subnet ID.

JSON Schema:

```json theme={null}
[{                      
  "aliases": [{         
    "allocation_id": "" 
  }],
  "ip_address": {       
    "allocation_id": "" 
  },
  "name": "",           
  "public_ip_address": {
    "allocation_id": "",
    "static": false     
  },
  "security_groups": [{
    "id": ""           
  }],
  "subnet_id": ""       
}]
```

`--nvl-instance-group-id` (string)

NVLink Instance Group ID associated with the VM.

`--on-demand` (bool)

A regular, non-preemptible VM.

Mutually exclusive with: `--follows-spot-price`, `--spot-pricing-policy-id`.

`--parent-id` (string)* \[required]*

Identifier of the parent resource to which the resource belongs.

`--preemptible-on-preemption` (string)

Specifies what happens when the VM is preempted. The only supported value is STOP:\

Compute stops the VM without deleting or restarting it.

A value must be one of:

<ul>
  <li>
    `unspecified`
  </li>

  <li>
    `stop`
  </li>
</ul>

`--preemptible-priority` (int32)

`--recovery-policy` (string)

Recovery policy defines how the instance will be treated in case of a failure.\

Common source of failure is a host failure, but it can be any other failure.\

Instance undergoing a guest shutdown (poweroff, etc.) will be subject to recovery policy, meaning that it could\

be restarted and billed accordingly. Stop instance via API or UI to stop it to avoid recovering.\


* If set to RECOVER, instance will be restarted, if possible. It could be restarted on the same host or on another host.\

* If set to FAIL, instance will be stopped and not restarted.\

* If set to ALWAYS, keep retrying recovery indefinitely until the instance is recovered. Available only for instances in\

  nvlinstancegroup.

A value must be one of:

<ul>
  <li>
    `recover`
  </li>

  <li>
    `fail`
  </li>

  <li>
    `always`
  </li>
</ul>

`--reservation-policy-policy` (string)

A value must be one of:

<ul>
  <li>
    `auto`
  </li>

  <li>
    `forbid`
  </li>

  <li>
    `strict`
  </li>
</ul>

`--reservation-policy-reservation-ids` (string array)

Capacity block groups, order matters.

`--resource-version` (int64)

Version of the resource for safe concurrent modifications and consistent reads.\

Positive and monotonically increases on each resource spec change (but *not* on each change of the\

resource's container(s) or status).\

Service allows zero value or current.

`--resources-platform` (string)* \[required]*

`--resources-preset` (string)* \[required]*

`--secondary-disks` (json)

List of additional data disks attached to the instance beyond the boot disk.

(structure)

**attach\_mode** -> (string)*\[required]*

A value must be one of:

<ul>
  <li>
    `"unspecified"`
  </li>

  <li>
    `"read_only"`
  </li>

  <li>
    `"read_write"`
  </li>
</ul>

**device\_id** -> (string)

Specifies the user-defined device identifier.\

Use `/dev/disk/by-id/virtio-{device_id}` as the device path in a mount command.

**existing\_disk** -> (structure)

Attach an existing disk.\


Lifecycle:\


* The disk is preserved when the instance is deleted (it will be detached).\


Switching to a managed disk:\


* To delete the disk together with the instance, switch to ManagedDisk in the instance spec.\

* For the switch, `ManagedDisk.name` MUST match the current disk `name`\

  (see DiskService.Get for the disk referenced by `ExistingDisk.id`).\

* When converting an ExistingDisk to a ManagedDisk, you must provide `ManagedDisk.name` and `ManagedDisk.spec`\

  exactly as they are currently defined in the disk resource.\

  Obtain the current values via `DiskService.Get` and copy them verbatim.\

  If `ManagedDisk.spec` differs from the current disk spec, the instance update will fail.

Mutually exclusive with: *managed\_disk*.

**id** -> (string)*\[required]*

**managed\_disk** -> (structure)

Attach a managed disk.\


Lifecycle:\


* The disk is deleted when the instance is deleted.\


Semantics:\


* Specifying a ManagedDisk expresses an intent to have that managed disk attached.\

* If this intent cannot be satisfied, the entire operation fails.\

* You can check the intent status in `instance.status.disk_attachments`.\


Updates and matching:\


* Managed disks can be updated only via instance spec updates. Updates via DiskService are not allowed.\

* During updates, disks are matched by `name`.\


Renaming and data loss:\


* Changing the disk `name` triggers disk replacement (create a new disk and delete the old one),\

  which causes data loss.\

* To rename a managed disk safely:\

  1. switch it to ExistingDisk in the instance spec, and\

  2. update/rename it via DiskService.\


Conflicts:\


* Instance create/update fails if there is already a disk with the same `name`.\

  as requested by any ManagedDisk.\


Finding the disk ID:\


* The disk ID is available in `instance.status.disk_attachments` after it is created.\

  Use `DiskAttachmentStatus.name` to find the desired disk which matches `name`.\


Switching to an existing (non-managed) disk:\


* To preserve the disk after instance deletion, switch it to ExistingDisk in the instance spec,\

  use the disk ID from `instance.status.disk_attachments`.\


Deletion protection:\


* Switching ExistingDisk to ManagedDisk fails if `Disk.spec.deletion_protection` is enabled.\

* Deleting an instance that has a ManagedDisk fails if `Disk.spec.deletion_protection` is enabled.

Mutually exclusive with: *existing\_disk*.

**labels** -> (map)*\[map]*

Labels associated with disk resource.

**key** -> (string)

**value** -> (string)

**name** -> (string)*\[required]*

Name of a dependent disk.\

Use it to convert an ExistingDisk to a dependent disk.\

Changing the name will replace the disk and cause data loss.

**spec** -> (structure)*\[required]*

Specification of a dependent disk to be created.

**block\_size\_bytes** -> (int64)*\[immutable]*

Block size in bytes.\

The block size must be a power of two between 4096 bytes (4 KiB) and 131072 bytes (128 KiB).\

The default value is 4096 bytes (4 KiB).

**disk\_encryption** -> (structure)*\[immutable]*

Defines how data on the disk is encrypted. By default, no encryption is applied.

**type** -> (string)

A value must be one of:

<ul>
  <li>
    `"disk_encryption_unspecified"`
  </li>

  <li>
    `"disk_encryption_managed"`
  </li>
</ul>

**forbid\_deletion** -> (bool)

Prevents deletion whilst set.

**size\_bytes** -> (int64)

Mutually exclusive with: *size\_gibibytes*, *size\_kibibytes*, *size\_mebibytes*.

**size\_gibibytes** -> (int64)

Mutually exclusive with: *size\_bytes*, *size\_kibibytes*, *size\_mebibytes*.

**size\_kibibytes** -> (int64)

Mutually exclusive with: *size\_bytes*, *size\_gibibytes*, *size\_mebibytes*.

**size\_mebibytes** -> (int64)

Mutually exclusive with: *size\_bytes*, *size\_gibibytes*, *size\_kibibytes*.

**source\_image\_family** -> (structure)*\[immutable]*

Mutually exclusive with: *source\_image\_id*, *source\_snapshot\_id*.

**image\_family** -> (string)*\[required]*

**parent\_id** -> (string)

**source\_image\_id** -> (string)*\[immutable]*

Mutually exclusive with: *source\_image\_family*, *source\_snapshot\_id*.

**source\_snapshot\_id** -> (string)*\[immutable]*

Mutually exclusive with: *source\_image\_family*, *source\_image\_id*.

**type** -> (string)*\[required]*
*\[immutable]*

The type of disk defines the performance and reliability characteristics of the block device.\

For details, see [https://docs.nebius.com/compute/storage/types#disks-types](https://docs.nebius.com/compute/storage/types.md#disks-types).

A value must be one of:

<ul>
  <li>
    `"unspecified"`
  </li>

  <li>
    `"network_ssd"`
  </li>

  <li>
    `"network_hdd"`
  </li>

  <li>
    `"network_ssd_non_replicated"`
  </li>

  <li>
    `"network_ssd_io_m3"`
  </li>
</ul>

JSON Schema:

```json theme={null}
[{                                                     
  "attach_mode": "unspecified"|"read_only"|"read_write",
  "device_id": "",                                     
  "existing_disk": {
    "id": ""        
  }
}]
```

`--service-account-id` (string)

Unique identifier of the service account associated with this instance.\

For details, see [https://docs.nebius.com/iam/service-accounts/manage](https://docs.nebius.com/iam/service-accounts/manage.md).

`--spot-pricing-policy-id` (string)

PricingPolicy ID used as the maximum agreed price for the preemptible VM.

Mutually exclusive with: `--follows-spot-price`, `--on-demand`.

`--stopped` (bool)

Indicates whether the instance should be stopped.

`--async` (bool)

If set, returns operation id. Otherwise, waits for the operation to complete and returns its resource.

`-i, --interactive` (bool)

If set, suggests to insert field values in interactive mode.

## Global Options

`-h, --help` (bool)

Show this message.

`-p, --profile` (string)

Set a profile for interacting with the cloud.

`--format` (string)

Output format. Supported values: yaml|json|jsonpath|table|text.

`-f, --file` (string)

Input file. For 'update' commands automatically set --full=true.

`-c, --config` (string)

Provide path to config file.

`--debug` (bool)

Write debug logs to stderr. Commands save debug logs in the config directory under logs/, except help and shell completion.

`-I, --impersonate-service-account-id` (string)

Impersonate into the service account and use its token for a command.

`--color` (bool)

Enable colored output.

`--no-browser` (bool)

Do not open browser automatically on auth.

`--insecure` (bool)

Disable transport security.

`--auth-timeout` (duration: 2h30m10s)

Set the timeout for the request including authentication process, default is 15m0s.

`--per-retry-timeout` (duration: 2h30m10s)

Set the timeout for each retry attempt, default is 20s.

`--retries` (uint)

Set the number of retry attempts, 1 is disable retries, default is 3.

`--timeout` (duration: 2h30m10s)

Set the timeout for the main request, default is 1m0s.

`--no-check-update` (bool)

Suppress check for updates.

`--no-progress` (bool)

Suppress progress indicators and spinners.

**Input argument JSON Schema**

> [tab] Full
>
> ```json theme={null}
> {              
>   "metadata": {               
>     "labels": {                // [map]
>                                // Labels associated with the resource.
>       string: string                  
>     },
>     "name": string,            // Human-readable name for the resource.
>     "parent_id": string,       // [required]
>                                // Identifier of the parent resource to which the resource belongs.
>     "resource_version": int64  // Version of the resource for safe concurrent modifications and consistent reads.
>                                // Positive and monotonically increases on each resource spec change (but *not* on each change of the
>                                // resource's container(s) or status).
>                                // Service allows zero value or current.
>   },
>   "spec": {                         
>     "boot_disk": {         // [required]
>                            // Specified boot disk attached to the instance.
>       "attach_mode": enum( // [required]
>         "UNSPECIFIED",    
>         "READ_ONLY",      
>         "READ_WRITE"      
>       ),
>       "device_id": string, // Specifies the user-defined device identifier.
>                            // Use `/dev/disk/by-id/virtio-{device_id}` as the device path in a mount command.
>       "existing_disk": { // Cannot be set together with: managed_disk
>                          // Attach an existing disk.
>                          // 
>                          // Lifecycle:
>                          // - The disk is preserved when the instance is deleted (it will be detached).
>                          // 
>                          // Switching to a managed disk:
>                          // - To delete the disk together with the instance, switch to ManagedDisk in the instance spec.
>                          // - For the switch, `ManagedDisk.name` MUST match the current disk `name`
>                          //   (see DiskService.Get for the disk referenced by `ExistingDisk.id`).
>                          // - When converting an ExistingDisk to a ManagedDisk, you must provide `ManagedDisk.name` and `ManagedDisk.spec`
>                          //   exactly as they are currently defined in the disk resource.
>                          //   Obtain the current values via `DiskService.Get` and copy them verbatim.
>                          //   If `ManagedDisk.spec` differs from the current disk spec, the instance update will fail.
>         "id": string     // [required]
>       },
>       "managed_disk": { // Cannot be set together with: existing_disk
>                         // Attach a managed disk.
>                         // 
>                         // Lifecycle:
>                         // - The disk is deleted when the instance is deleted.
>                         // 
>                         // Semantics:
>                         // - Specifying a ManagedDisk expresses an intent to have that managed disk attached.
>                         // - If this intent cannot be satisfied, the entire operation fails.
>                         // - You can check the intent status in `instance.status.disk_attachments`.
>                         // 
>                         // Updates and matching:
>                         // - Managed disks can be updated only via instance spec updates. Updates via DiskService are not allowed.
>                         // - During updates, disks are matched by `name`.
>                         // 
>                         // Renaming and data loss:
>                         // - Changing the disk `name` triggers disk replacement (create a new disk and delete the old one),
>                         //   which causes data loss.
>                         // - To rename a managed disk safely:
>                         //   1) switch it to ExistingDisk in the instance spec, and
>                         //   2) update/rename it via DiskService.
>                         // 
>                         // Conflicts:
>                         // - Instance create/update fails if there is already a disk with the same `name`.
>                         //   as requested by any ManagedDisk.
>                         // 
>                         // Finding the disk ID:
>                         // - The disk ID is available in `instance.status.disk_attachments` after it is created.
>                         //   Use `DiskAttachmentStatus.name` to find the desired disk which matches `name`.
>                         // 
>                         // Switching to an existing (non-managed) disk:
>                         // - To preserve the disk after instance deletion, switch it to ExistingDisk in the instance spec,
>                         //   use the disk ID from `instance.status.disk_attachments`.
>                         // 
>                         // Deletion protection:
>                         // - Switching ExistingDisk to ManagedDisk fails if `Disk.spec.deletion_protection` is enabled.
>                         // - Deleting an instance that has a ManagedDisk fails if `Disk.spec.deletion_protection` is enabled.
>         "labels": {        // [map]
>                            // Labels associated with disk resource.
>           string: string          
>         },
>         "name": string, // [required]
>                         // Name of a dependent disk.
>                         // Use it to convert an ExistingDisk to a dependent disk.
>                         // Changing the name will replace the disk and cause data loss.
>         "spec": {                       // [required]
>                                         // Specification of a dependent disk to be created.
>           "block_size_bytes": int64,    // [immutable]
>                                         // Block size in bytes.
>                                         // The block size must be a power of two between 4096 bytes (4 KiB) and 131072 bytes (128 KiB).
>                                         // The default value is 4096 bytes (4 KiB).
>           "disk_encryption": { // [immutable]
>                                // Defines how data on the disk is encrypted. By default, no encryption is applied.
>             "type": enum(                   
>               "DISK_ENCRYPTION_UNSPECIFIED", // No encryption is applied unless explicitly specified.
>               "DISK_ENCRYPTION_MANAGED"      // Enables encryption using the platform's default root key from KMS.
>                                              // Available for disks with NETWORK_SSD_NON_REPLICATED and NETWORK_SSD_IO_M3 types only.
>             )
>           },
>           "forbid_deletion": bool,      // Prevents deletion whilst set.
>           "size_bytes": int64,          // Cannot be set together with: size_kibibytes, size_mebibytes, size_gibibytes
>           "size_gibibytes": int64,      // Cannot be set together with: size_bytes, size_kibibytes, size_mebibytes
>           "size_kibibytes": int64,      // Cannot be set together with: size_bytes, size_mebibytes, size_gibibytes
>           "size_mebibytes": int64,      // Cannot be set together with: size_bytes, size_kibibytes, size_gibibytes
>           "source_image_family": {  // [immutable]
>                                     // Cannot be set together with: source_image_id, source_snapshot_id
>             "image_family": string, // [required]
>             "parent_id": string    
>           },
>           "source_image_id": string,    // [immutable]
>                                         // Cannot be set together with: source_image_family, source_snapshot_id
>           "source_snapshot_id": string, // [immutable]
>                                         // Cannot be set together with: source_image_id, source_image_family
>           "type": enum(                   // [required] [immutable]
>                                           // The type of disk defines the performance and reliability characteristics of the block device.
>                                           // For details, see https://docs.nebius.com/compute/storage/types#disks-types.
>             "UNSPECIFIED",               
>             "NETWORK_SSD",               
>             "NETWORK_HDD",               
>             "NETWORK_SSD_NON_REPLICATED",
>             "NETWORK_SSD_IO_M3"          
>           )
>         }
>       }
>     },
>     "cloud_init_user_data": string,  // [sensitive]
>                                      // Data in cloud-init format for customizing instance initialization.
>                                      // For details, see https://docs.nebius.com/compute/virtual-machines/manage#user-data.
>     "filesystems": [{          // List of Shared Filesystems attached to the instance.
>       "attach_mode": enum( // [required]
>         "UNSPECIFIED",    
>         "READ_ONLY",      
>         "READ_WRITE"      
>       ),
>       "existing_filesystem": {
>         "id": string           // [required]
>       },
>       "mount_tag": string      // [required]
>                                // Specifies the user-defined identifier, allowing to use it as a device in mount command.
>     }],
>     "follows_spot_price": { // [meaningful_empty_value]
>                             // Cannot be set together with: on_demand, spot_pricing_policy
>                             // The preemptible VM accepts the current spot price.
>     },
>     "gpu_cluster": { // [immutable]
>                      // If you want to interconnect several instances in a GPU cluster via NVIDIA InfiniBand,
>                      // set the ID of an existing GPU cluster.
>                      // You can only add the VM to the cluster when creating the VM.
>                      // For details, see https://docs.nebius.com/compute/clusters/gpu.
>       "id": string   // If you want to interconnect several instances in a GPU cluster via NVIDIA InfiniBand,
>                      // set the ID of an existing GPU cluster.
>                      // You can only add the VM to the cluster when creating the VM.
>                      // For details, see https://docs.nebius.com/compute/clusters/gpu.
>     },
>     "hostname": string,              // Instance's hostname. Used to generate default DNS record in format `<hostname>.<network_id>.compute.internal.`
>                                      // or `<instance_id>.<network_id>.compute.internal.` if hostname is not specified.
>     "local_disks": {         // Local disks are meaningfully different from regular (remote) disks:
>                              // they are provided by the underlying host and are tied to a particular VM run.
>                              // Local disk data is not preserved across Stop-Start initiated via Compute API.
>                              // Local disks are not provided by default. To get them, explicitly request them via this field.
>                              // Availability depends on the selected platform, preset and region.
>                              // Changing this field will result in disks change and content loss, but only after stop and start the instance.
>       "passthrough_group": { // Requests passthrough local disks from the host.
>                              // Topology of the provided disks is preserved during stop and start
>                              // for every instance of a specific platform and preset in the region.
>         "requested": bool    // Passthrough local disks from the underlying host.
>                              // 
>                              // Devices are expected to appear in the guest as NVMe devices (nvme0, nvme1, ...),
>                              // but the exact number depends on the preset.
>                              // Enabled only when this field is explicitly set.
>       }
>     },
>     "network_interfaces": [{ // [required]
>                              // List of network interfaces attached to the instance.
>       "aliases": [{              // Assign ranges of IP addresses as aliases.
>         "allocation_id": string  // [required]
>                                  // ID of allocation.
>       }],
>       "ip_address": {            // [required] [immutable] [meaningful_empty_value]
>                                  // Private IPv4 address associated with the interface.
>         "allocation_id": string  // Allocation identifier if it was created before.
>       },
>       "name": string,        // [required] [immutable]
>                              // Interface name
>                              // Value of this field configures the name of the network interface inside VM's OS.
>                              // Longer values will persist in the specification but will be truncated to 15 symbols before being passed to VM configuration.
>       "public_ip_address": {     // [meaningful_empty_value]
>                                  // Public IPv4 address associated with the interface.
>         "allocation_id": string, // Allocation identifier if it was created before.
>         "static": bool           // If false - Allocation will be created/deleted during NetworkInterface.Allocate/NetworkInterface.Deallocate
>                                  // If true  - Allocation will be created/deleted during NetworkInterface.Create/NetworkInterface.Delete
>                                  // False by default.
>       },
>       "security_groups": [{ // Security groups associated with the network interface.
>                             // If an empty list is provided, the default security group for the network will be used.
>                             // Effective security groups can be seen in the status.
>         "id": string        // Security group identifier.
>       }],
>       "subnet_id": string    // [immutable]
>                              // Subnet ID.
>     }],
>     "nvl_instance_group_id": string, // NVLink Instance Group ID associated with the VM.
>     "on_demand": { // [meaningful_empty_value]
>                    // Cannot be set together with: follows_spot_price, spot_pricing_policy
>                    // A regular, non-preemptible VM.
>     },
>     "preemptible": {         // Set this field to create a preemptible VM, or omit it to create a regular VM.
>                              // For details, see https://docs.nebius.com/compute/virtual-machines/preemptible
>                              // A preemptible VM cannot be converted to a regular VM or vice versa. Once set, this field cannot be removed; if the
>                              // VM was created without it, the field cannot be added later.
>       "on_preemption": enum( // [required] [immutable]
>                              // Specifies what happens when the VM is preempted. The only supported value is STOP:
>                              // Compute stops the VM without deleting or restarting it.
>         "UNSPECIFIED",      
>         "STOP"              
>       ),
>       "priority": int32      // [deprecated: supported until 2026-05-11] [immutable]
>                              // It is deprecated and doesn't affect preemption behavior anymore.
>     },
>     "recovery_policy": enum( // [immutable]
>                              // Recovery policy defines how the instance will be treated in case of a failure.
>                              // Common source of failure is a host failure, but it can be any other failure.
>                              // Instance undergoing a guest shutdown (poweroff, etc.) will be subject to recovery policy, meaning that it could
>                              // be restarted and billed accordingly. Stop instance via API or UI to stop it to avoid recovering.
>                              // - If set to RECOVER, instance will be restarted, if possible. It could be restarted on the same host or on another host.
>                              // - If set to FAIL, instance will be stopped and not restarted.
>                              // - If set to ALWAYS, keep retrying recovery indefinitely until the instance is recovered. Available only for instances in
>                              //   nvlinstancegroup.
>       "RECOVER",            
>       "FAIL",               
>       "ALWAYS"              
>     ),
>     "reservation_policy": {       
>       "policy": enum(
>         "AUTO",       // 1) Will try to launch instance in any reservation_ids if provided.
>                       // 2) Will try to launch instance in any of the available capacity block.
>                       // 3) Will try to launch instance in PAYG if 1 & 2 are not satisfied.
>         "FORBID",     // The instance is launched only using on-demand (PAYG) capacity.
>                       // No attempt is made to find or use a Capacity Block.
>                       // It's an error to provide reservation_ids with policy = FORBID.
>         "STRICT"      // 1) Will try to launch the instance in Capacity Blocks from reservation_ids if provided.
>                       // 2) If reservation_ids are not provided will try to launch instance in suitable & available Capacity Block.
>                       // 3) Fail otherwise.
>       ),
>       "reservation_ids": [string]  // Capacity block groups, order matters.
>     },
>     "resources": {        // [required]
>                           // Specification of compute resources allocated to the instance.
>                           // For details, see https://docs.nebius.com/compute/virtual-machines/types.
>       "platform": string, // [required] [immutable]
>       "preset": string   
>     },
>     "secondary_disks": [{  // List of additional data disks attached to the instance beyond the boot disk.
>       "attach_mode": enum( // [required]
>         "UNSPECIFIED",    
>         "READ_ONLY",      
>         "READ_WRITE"      
>       ),
>       "device_id": string, // Specifies the user-defined device identifier.
>                            // Use `/dev/disk/by-id/virtio-{device_id}` as the device path in a mount command.
>       "existing_disk": { // Cannot be set together with: managed_disk
>                          // Attach an existing disk.
>                          // 
>                          // Lifecycle:
>                          // - The disk is preserved when the instance is deleted (it will be detached).
>                          // 
>                          // Switching to a managed disk:
>                          // - To delete the disk together with the instance, switch to ManagedDisk in the instance spec.
>                          // - For the switch, `ManagedDisk.name` MUST match the current disk `name`
>                          //   (see DiskService.Get for the disk referenced by `ExistingDisk.id`).
>                          // - When converting an ExistingDisk to a ManagedDisk, you must provide `ManagedDisk.name` and `ManagedDisk.spec`
>                          //   exactly as they are currently defined in the disk resource.
>                          //   Obtain the current values via `DiskService.Get` and copy them verbatim.
>                          //   If `ManagedDisk.spec` differs from the current disk spec, the instance update will fail.
>         "id": string     // [required]
>       },
>       "managed_disk": { // Cannot be set together with: existing_disk
>                         // Attach a managed disk.
>                         // 
>                         // Lifecycle:
>                         // - The disk is deleted when the instance is deleted.
>                         // 
>                         // Semantics:
>                         // - Specifying a ManagedDisk expresses an intent to have that managed disk attached.
>                         // - If this intent cannot be satisfied, the entire operation fails.
>                         // - You can check the intent status in `instance.status.disk_attachments`.
>                         // 
>                         // Updates and matching:
>                         // - Managed disks can be updated only via instance spec updates. Updates via DiskService are not allowed.
>                         // - During updates, disks are matched by `name`.
>                         // 
>                         // Renaming and data loss:
>                         // - Changing the disk `name` triggers disk replacement (create a new disk and delete the old one),
>                         //   which causes data loss.
>                         // - To rename a managed disk safely:
>                         //   1) switch it to ExistingDisk in the instance spec, and
>                         //   2) update/rename it via DiskService.
>                         // 
>                         // Conflicts:
>                         // - Instance create/update fails if there is already a disk with the same `name`.
>                         //   as requested by any ManagedDisk.
>                         // 
>                         // Finding the disk ID:
>                         // - The disk ID is available in `instance.status.disk_attachments` after it is created.
>                         //   Use `DiskAttachmentStatus.name` to find the desired disk which matches `name`.
>                         // 
>                         // Switching to an existing (non-managed) disk:
>                         // - To preserve the disk after instance deletion, switch it to ExistingDisk in the instance spec,
>                         //   use the disk ID from `instance.status.disk_attachments`.
>                         // 
>                         // Deletion protection:
>                         // - Switching ExistingDisk to ManagedDisk fails if `Disk.spec.deletion_protection` is enabled.
>                         // - Deleting an instance that has a ManagedDisk fails if `Disk.spec.deletion_protection` is enabled.
>         "labels": {        // [map]
>                            // Labels associated with disk resource.
>           string: string          
>         },
>         "name": string, // [required]
>                         // Name of a dependent disk.
>                         // Use it to convert an ExistingDisk to a dependent disk.
>                         // Changing the name will replace the disk and cause data loss.
>         "spec": {                       // [required]
>                                         // Specification of a dependent disk to be created.
>           "block_size_bytes": int64,    // [immutable]
>                                         // Block size in bytes.
>                                         // The block size must be a power of two between 4096 bytes (4 KiB) and 131072 bytes (128 KiB).
>                                         // The default value is 4096 bytes (4 KiB).
>           "disk_encryption": { // [immutable]
>                                // Defines how data on the disk is encrypted. By default, no encryption is applied.
>             "type": enum(                   
>               "DISK_ENCRYPTION_UNSPECIFIED", // No encryption is applied unless explicitly specified.
>               "DISK_ENCRYPTION_MANAGED"      // Enables encryption using the platform's default root key from KMS.
>                                              // Available for disks with NETWORK_SSD_NON_REPLICATED and NETWORK_SSD_IO_M3 types only.
>             )
>           },
>           "forbid_deletion": bool,      // Prevents deletion whilst set.
>           "size_bytes": int64,          // Cannot be set together with: size_kibibytes, size_mebibytes, size_gibibytes
>           "size_gibibytes": int64,      // Cannot be set together with: size_bytes, size_kibibytes, size_mebibytes
>           "size_kibibytes": int64,      // Cannot be set together with: size_bytes, size_mebibytes, size_gibibytes
>           "size_mebibytes": int64,      // Cannot be set together with: size_bytes, size_kibibytes, size_gibibytes
>           "source_image_family": {  // [immutable]
>                                     // Cannot be set together with: source_image_id, source_snapshot_id
>             "image_family": string, // [required]
>             "parent_id": string    
>           },
>           "source_image_id": string,    // [immutable]
>                                         // Cannot be set together with: source_image_family, source_snapshot_id
>           "source_snapshot_id": string, // [immutable]
>                                         // Cannot be set together with: source_image_id, source_image_family
>           "type": enum(                   // [required] [immutable]
>                                           // The type of disk defines the performance and reliability characteristics of the block device.
>                                           // For details, see https://docs.nebius.com/compute/storage/types#disks-types.
>             "UNSPECIFIED",               
>             "NETWORK_SSD",               
>             "NETWORK_HDD",               
>             "NETWORK_SSD_NON_REPLICATED",
>             "NETWORK_SSD_IO_M3"          
>           )
>         }
>       }
>     }],
>     "service_account_id": string,    // [immutable]
>                                      // Unique identifier of the service account associated with this instance.
>                                      // For details, see https://docs.nebius.com/iam/service-accounts/manage.
>     "spot_pricing_policy": { // Cannot be set together with: on_demand, follows_spot_price
>                              // The preemptible VM accepts the current spot price unless it exceeds the maximum price specified by the selected
>                              // pricing policy. When the spot price exceeds that maximum price, the VM is preempted.
>       "id": string           // [required]
>                              // PricingPolicy ID used as the maximum agreed price for the preemptible VM.
>     },
>     "stopped": bool                  // Indicates whether the instance should be stopped.
>   }
> }
> ```

> [tab] CopyPaste Friendly
>
> ```json theme={null}
> nebius compute instance create '
> {              
>   "metadata": {           
>     "labels": {           
>       "": ""                  
>     },
>     "name": "",           
>     "parent_id": "",      
>     "resource_version": 0 
>   },
>   "spec": {                                     
>     "boot_disk": {                                         
>       "attach_mode": "unspecified"|"read_only"|"read_write",
>       "device_id": "",                                     
>       "existing_disk": {
>         "id": ""        
>       }
>     },
>     "cloud_init_user_data": "",                 
>     "filesystems": [{                                      
>       "attach_mode": "unspecified"|"read_only"|"read_write",
>       "existing_filesystem": {
>         "id": ""              
>       },
>       "mount_tag": ""                                      
>     }],
>     "follows_spot_price": {
>     },
>     "gpu_cluster": {
>       "id": ""      
>     },
>     "hostname": "",                             
>     "local_disks": {        
>       "passthrough_group": {
>         "requested": false  
>       }
>     },
>     "network_interfaces": [{
>       "aliases": [{         
>         "allocation_id": "" 
>       }],
>       "ip_address": {       
>         "allocation_id": "" 
>       },
>       "name": "",           
>       "public_ip_address": {
>         "allocation_id": "",
>         "static": false     
>       },
>       "security_groups": [{
>         "id": ""           
>       }],
>       "subnet_id": ""       
>     }],
>     "nvl_instance_group_id": "",                
>     "preemptible": {                       
>       "on_preemption": "unspecified"|"stop",
>       "priority": 0                        
>     },
>     "recovery_policy": "recover"|"fail"|"always",
>     "reservation_policy": {             
>       "policy": "auto"|"forbid"|"strict",
>       "reservation_ids": [""]           
>     },
>     "resources": {   
>       "platform": "",
>       "preset": ""   
>     },
>     "secondary_disks": [{                                  
>       "attach_mode": "unspecified"|"read_only"|"read_write",
>       "device_id": "",                                     
>       "existing_disk": {
>         "id": ""        
>       }
>     }],
>     "service_account_id": "",                   
>     "stopped": false                            
>   }
> }
> '
> ```

*Auto generated on 11-Nov-2026*
