nebius billing v1alpha1 calculator estimate

Name

nebius billing v1alpha1 calculator estimate

Estimates prices for a single resource.
Returns both hourly and monthly cost estimates for the specified resource configuration.

Synopsis

nebius billing v1alpha1 calculator estimate
  --offer-types
  --resource-spec-compute-disk-spec-block-size-bytes
  --resource-spec-compute-disk-spec-disk-encryption-type
  --resource-spec-compute-disk-spec-forbid-deletion
  --resource-spec-compute-disk-spec-id
  --resource-spec-compute-disk-spec-labels
  --resource-spec-compute-disk-spec-name
  --resource-spec-compute-disk-spec-parent-id
  --resource-spec-compute-disk-spec-resource-version
  --resource-spec-compute-disk-spec-size-bytes
  --resource-spec-compute-disk-spec-size-gibibytes
  --resource-spec-compute-disk-spec-size-kibibytes
  --resource-spec-compute-disk-spec-size-mebibytes
  --resource-spec-compute-disk-spec-source-image-family-image-family
  --resource-spec-compute-disk-spec-source-image-family-parent-id
  --resource-spec-compute-disk-spec-source-image-id
  --resource-spec-compute-disk-spec-source-snapshot-id
  --resource-spec-compute-disk-spec-type
  --resource-spec-compute-disk-update-spec-block-size-bytes
  --resource-spec-compute-disk-update-spec-disk-encryption-type
  --resource-spec-compute-disk-update-spec-forbid-deletion
  --resource-spec-compute-disk-update-spec-id
  --resource-spec-compute-disk-update-spec-labels
  --resource-spec-compute-disk-update-spec-name
  --resource-spec-compute-disk-update-spec-parent-id
  --resource-spec-compute-disk-update-spec-resource-version
  --resource-spec-compute-disk-update-spec-size-bytes
  --resource-spec-compute-disk-update-spec-size-gibibytes
  --resource-spec-compute-disk-update-spec-size-kibibytes
  --resource-spec-compute-disk-update-spec-size-mebibytes
  --resource-spec-compute-disk-update-spec-source-image-family-image-family
  --resource-spec-compute-disk-update-spec-source-image-family-parent-id
  --resource-spec-compute-disk-update-spec-source-image-id
  --resource-spec-compute-disk-update-spec-source-snapshot-id
  --resource-spec-compute-disk-update-spec-type
  --resource-spec-compute-filesystem-spec-block-size-bytes
  --resource-spec-compute-filesystem-spec-forbid-deletion
  --resource-spec-compute-filesystem-spec-id
  --resource-spec-compute-filesystem-spec-labels
  --resource-spec-compute-filesystem-spec-name
  --resource-spec-compute-filesystem-spec-parent-id
  --resource-spec-compute-filesystem-spec-resource-version
  --resource-spec-compute-filesystem-spec-size-bytes
  --resource-spec-compute-filesystem-spec-size-gibibytes
  --resource-spec-compute-filesystem-spec-size-kibibytes
  --resource-spec-compute-filesystem-spec-size-mebibytes
  --resource-spec-compute-filesystem-spec-type
  --resource-spec-compute-filesystem-update-spec-block-size-bytes
  --resource-spec-compute-filesystem-update-spec-forbid-deletion
  --resource-spec-compute-filesystem-update-spec-id
  --resource-spec-compute-filesystem-update-spec-labels
  --resource-spec-compute-filesystem-update-spec-name
  --resource-spec-compute-filesystem-update-spec-parent-id
  --resource-spec-compute-filesystem-update-spec-resource-version
  --resource-spec-compute-filesystem-update-spec-size-bytes
  --resource-spec-compute-filesystem-update-spec-size-gibibytes
  --resource-spec-compute-filesystem-update-spec-size-kibibytes
  --resource-spec-compute-filesystem-update-spec-size-mebibytes
  --resource-spec-compute-filesystem-update-spec-type
  --resource-spec-compute-instance-spec-boot-disk-attach-mode
  --resource-spec-compute-instance-spec-boot-disk-device-id
  --resource-spec-compute-instance-spec-boot-disk-existing-disk-id
  --resource-spec-compute-instance-spec-boot-disk-managed-disk-block-size-bytes
  --resource-spec-compute-instance-spec-boot-disk-managed-disk-disk-encryption-type
  --resource-spec-compute-instance-spec-boot-disk-managed-disk-forbid-deletion
  --resource-spec-compute-instance-spec-boot-disk-managed-disk-labels
  --resource-spec-compute-instance-spec-boot-disk-managed-disk-name
  --resource-spec-compute-instance-spec-boot-disk-managed-disk-size-bytes
  --resource-spec-compute-instance-spec-boot-disk-managed-disk-size-gibibytes
  --resource-spec-compute-instance-spec-boot-disk-managed-disk-size-kibibytes
  --resource-spec-compute-instance-spec-boot-disk-managed-disk-size-mebibytes
  --resource-spec-compute-instance-spec-boot-disk-managed-disk-source-image-family-image-family
  --resource-spec-compute-instance-spec-boot-disk-managed-disk-source-image-family-parent-id
  --resource-spec-compute-instance-spec-boot-disk-managed-disk-source-image-id
  --resource-spec-compute-instance-spec-boot-disk-managed-disk-source-snapshot-id
  --resource-spec-compute-instance-spec-boot-disk-managed-disk-type
  --resource-spec-compute-instance-spec-cloud-init-user-data
  --resource-spec-compute-instance-spec-filesystems
  --resource-spec-compute-instance-spec-gpu-cluster-id
  --resource-spec-compute-instance-spec-hostname
  --resource-spec-compute-instance-spec-id
  --resource-spec-compute-instance-spec-labels
  --resource-spec-compute-instance-spec-local-disks-passthrough-group-requested
  --resource-spec-compute-instance-spec-name
  --resource-spec-compute-instance-spec-network-interfaces
  --resource-spec-compute-instance-spec-nvl-instance-group-id
  --resource-spec-compute-instance-spec-parent-id
  --resource-spec-compute-instance-spec-preemptible-on-preemption
  --resource-spec-compute-instance-spec-preemptible-priority
  --resource-spec-compute-instance-spec-recovery-policy
  --resource-spec-compute-instance-spec-reservation-policy-policy
  --resource-spec-compute-instance-spec-reservation-policy-reservation-ids
  --resource-spec-compute-instance-spec-resource-version
  --resource-spec-compute-instance-spec-resources-platform
  --resource-spec-compute-instance-spec-resources-preset
  --resource-spec-compute-instance-spec-secondary-disks
  --resource-spec-compute-instance-spec-service-account-id
  --resource-spec-compute-instance-spec-stopped
  --resource-spec-compute-instance-update-spec-boot-disk-attach-mode
  --resource-spec-compute-instance-update-spec-boot-disk-device-id
  --resource-spec-compute-instance-update-spec-boot-disk-existing-disk-id
  --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-block-size-bytes
  --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-disk-encryption-type
  --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-forbid-deletion
  --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-labels
  --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-name
  --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-bytes
  --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-gibibytes
  --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-kibibytes
  --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-mebibytes
  --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-image-family-image-family
  --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-image-family-parent-id
  --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-image-id
  --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-snapshot-id
  --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-type
  --resource-spec-compute-instance-update-spec-cloud-init-user-data
  --resource-spec-compute-instance-update-spec-filesystems
  --resource-spec-compute-instance-update-spec-gpu-cluster-id
  --resource-spec-compute-instance-update-spec-hostname
  --resource-spec-compute-instance-update-spec-id
  --resource-spec-compute-instance-update-spec-labels
  --resource-spec-compute-instance-update-spec-local-disks-passthrough-group-requested
  --resource-spec-compute-instance-update-spec-name
  --resource-spec-compute-instance-update-spec-network-interfaces
  --resource-spec-compute-instance-update-spec-nvl-instance-group-id
  --resource-spec-compute-instance-update-spec-parent-id
  --resource-spec-compute-instance-update-spec-preemptible-on-preemption
  --resource-spec-compute-instance-update-spec-preemptible-priority
  --resource-spec-compute-instance-update-spec-recovery-policy
  --resource-spec-compute-instance-update-spec-reservation-policy-policy
  --resource-spec-compute-instance-update-spec-reservation-policy-reservation-ids
  --resource-spec-compute-instance-update-spec-resource-version
  --resource-spec-compute-instance-update-spec-resources-platform
  --resource-spec-compute-instance-update-spec-resources-preset
  --resource-spec-compute-instance-update-spec-secondary-disks
  --resource-spec-compute-instance-update-spec-service-account-id
  --resource-spec-compute-instance-update-spec-stopped

Options

--offer-types (enum array)

Type of offers to be applied to the cost estimate.

--resource-spec-compute-disk-spec-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: --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-disk-spec-disk-encryption-type (string)

A value must be one of:

disk_encryption_unspecified
disk_encryption_managed

--resource-spec-compute-disk-spec-forbid-deletion (bool)

Prevents deletion whilst set.

--resource-spec-compute-disk-spec-id (string)

Identifier for the resource, unique for its resource type.

--resource-spec-compute-disk-spec-labels (string->string)

Labels associated with the resource.

--resource-spec-compute-disk-spec-name (string)

Human readable name for the resource.

--resource-spec-compute-disk-spec-parent-id (string)

Identifier of the parent resource to which the resource belongs.

--resource-spec-compute-disk-spec-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.

--resource-spec-compute-disk-spec-size-bytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-size-gibibytes, --resource-spec-compute-disk-spec-size-kibibytes, --resource-spec-compute-disk-spec-size-mebibytes, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-disk-spec-size-gibibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-size-bytes, --resource-spec-compute-disk-spec-size-kibibytes, --resource-spec-compute-disk-spec-size-mebibytes, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-disk-spec-size-kibibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-size-bytes, --resource-spec-compute-disk-spec-size-gibibytes, --resource-spec-compute-disk-spec-size-mebibytes, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-disk-spec-size-mebibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-size-bytes, --resource-spec-compute-disk-spec-size-gibibytes, --resource-spec-compute-disk-spec-size-kibibytes, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-disk-spec-source-image-family-image-family (string)

Mutually exclusive with: --resource-spec-compute-disk-spec-source-image-id, --resource-spec-compute-disk-spec-source-snapshot-id, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-disk-spec-source-image-family-parent-id (string)

--resource-spec-compute-disk-spec-source-image-id (string)

Mutually exclusive with: --resource-spec-compute-disk-spec-source-image-family-image-family, --resource-spec-compute-disk-spec-source-image-family-parent-id, --resource-spec-compute-disk-spec-source-snapshot-id, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-disk-spec-source-snapshot-id (string)

Mutually exclusive with: --resource-spec-compute-disk-spec-source-image-family-image-family, --resource-spec-compute-disk-spec-source-image-family-parent-id, --resource-spec-compute-disk-spec-source-image-id, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-disk-spec-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.

A value must be one of:

unspecified
network_ssd
network_hdd
network_ssd_non_replicated
network_ssd_io_m3

--resource-spec-compute-disk-update-spec-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: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-disk-update-spec-disk-encryption-type (string)

A value must be one of:

disk_encryption_unspecified
disk_encryption_managed

--resource-spec-compute-disk-update-spec-forbid-deletion (bool)

Prevents deletion whilst set.

--resource-spec-compute-disk-update-spec-id (string)

Identifier for the resource, unique for its resource type.

--resource-spec-compute-disk-update-spec-labels (string->string)

Labels associated with the resource.

--resource-spec-compute-disk-update-spec-name (string)

Human readable name for the resource.

--resource-spec-compute-disk-update-spec-parent-id (string)

Identifier of the parent resource to which the resource belongs.

--resource-spec-compute-disk-update-spec-resource-version (int64)

--resource-spec-compute-disk-update-spec-size-bytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-size-gibibytes, --resource-spec-compute-disk-update-spec-size-kibibytes, --resource-spec-compute-disk-update-spec-size-mebibytes, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-disk-update-spec-size-gibibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-size-bytes, --resource-spec-compute-disk-update-spec-size-kibibytes, --resource-spec-compute-disk-update-spec-size-mebibytes, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-disk-update-spec-size-kibibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-size-bytes, --resource-spec-compute-disk-update-spec-size-gibibytes, --resource-spec-compute-disk-update-spec-size-mebibytes, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-disk-update-spec-size-mebibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-size-bytes, --resource-spec-compute-disk-update-spec-size-gibibytes, --resource-spec-compute-disk-update-spec-size-kibibytes, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-disk-update-spec-source-image-family-image-family (string)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-source-image-id, --resource-spec-compute-disk-update-spec-source-snapshot-id, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-disk-update-spec-source-image-family-parent-id (string)

--resource-spec-compute-disk-update-spec-source-image-id (string)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-source-image-family-image-family, --resource-spec-compute-disk-update-spec-source-image-family-parent-id, --resource-spec-compute-disk-update-spec-source-snapshot-id, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-disk-update-spec-source-snapshot-id (string)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-source-image-family-image-family, --resource-spec-compute-disk-update-spec-source-image-family-parent-id, --resource-spec-compute-disk-update-spec-source-image-id, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-disk-update-spec-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.

A value must be one of:

unspecified
network_ssd
network_hdd
network_ssd_non_replicated
network_ssd_io_m3

--resource-spec-compute-filesystem-spec-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).

--resource-spec-compute-filesystem-spec-forbid-deletion (bool)

Prevents deletion whilst set.

--resource-spec-compute-filesystem-spec-id (string)

Identifier for the resource, unique for its resource type.

--resource-spec-compute-filesystem-spec-labels (string->string)

Labels associated with the resource.

--resource-spec-compute-filesystem-spec-name (string)

Human readable name for the resource.

--resource-spec-compute-filesystem-spec-parent-id (string)

Identifier of the parent resource to which the resource belongs.

--resource-spec-compute-filesystem-spec-resource-version (int64)

--resource-spec-compute-filesystem-spec-size-bytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-size-gibibytes, --resource-spec-compute-filesystem-spec-size-kibibytes, --resource-spec-compute-filesystem-spec-size-mebibytes, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-filesystem-spec-size-gibibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-size-bytes, --resource-spec-compute-filesystem-spec-size-kibibytes, --resource-spec-compute-filesystem-spec-size-mebibytes, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-filesystem-spec-size-kibibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-size-bytes, --resource-spec-compute-filesystem-spec-size-gibibytes, --resource-spec-compute-filesystem-spec-size-mebibytes, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-filesystem-spec-size-mebibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-size-bytes, --resource-spec-compute-filesystem-spec-size-gibibytes, --resource-spec-compute-filesystem-spec-size-kibibytes, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-filesystem-spec-type (string)

The Shared Filesystem type determines its limits and performance characteristics.
For details, see https://docs.nebius.com/compute/storage/types#filesystems-types.

A value must be one of:

unspecified
network_ssd
network_hdd
weka
vast

--resource-spec-compute-filesystem-update-spec-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).

--resource-spec-compute-filesystem-update-spec-forbid-deletion (bool)

Prevents deletion whilst set.

--resource-spec-compute-filesystem-update-spec-id (string)

Identifier for the resource, unique for its resource type.

--resource-spec-compute-filesystem-update-spec-labels (string->string)

Labels associated with the resource.

--resource-spec-compute-filesystem-update-spec-name (string)

Human readable name for the resource.

--resource-spec-compute-filesystem-update-spec-parent-id (string)

Identifier of the parent resource to which the resource belongs.

--resource-spec-compute-filesystem-update-spec-resource-version (int64)

--resource-spec-compute-filesystem-update-spec-size-bytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-size-gibibytes, --resource-spec-compute-filesystem-update-spec-size-kibibytes, --resource-spec-compute-filesystem-update-spec-size-mebibytes, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-filesystem-update-spec-size-gibibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-size-bytes, --resource-spec-compute-filesystem-update-spec-size-kibibytes, --resource-spec-compute-filesystem-update-spec-size-mebibytes, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-filesystem-update-spec-size-kibibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-size-bytes, --resource-spec-compute-filesystem-update-spec-size-gibibytes, --resource-spec-compute-filesystem-update-spec-size-mebibytes, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-filesystem-update-spec-size-mebibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-size-bytes, --resource-spec-compute-filesystem-update-spec-size-gibibytes, --resource-spec-compute-filesystem-update-spec-size-kibibytes, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-filesystem-update-spec-type (string)

The Shared Filesystem type determines its limits and performance characteristics.
For details, see https://docs.nebius.com/compute/storage/types#filesystems-types.

A value must be one of:

unspecified
network_ssd
network_hdd
weka
vast

--resource-spec-compute-instance-spec-boot-disk-attach-mode (string)

A value must be one of:

unspecified
read_only
read_write

--resource-spec-compute-instance-spec-boot-disk-device-id (string)

Specifies the user-defined identifier, allowing to use ‘/dev/disk/by-id/virtio-’ as a device path in mount command.

--resource-spec-compute-instance-spec-boot-disk-existing-disk-id (string)

--resource-spec-compute-instance-spec-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).

--resource-spec-compute-instance-spec-boot-disk-managed-disk-disk-encryption-type (string)

A value must be one of:

disk_encryption_unspecified
disk_encryption_managed

--resource-spec-compute-instance-spec-boot-disk-managed-disk-forbid-deletion (bool)

Prevents deletion whilst set.

--resource-spec-compute-instance-spec-boot-disk-managed-disk-labels (string->string)

Labels associated with disk resource.

--resource-spec-compute-instance-spec-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.

--resource-spec-compute-instance-spec-boot-disk-managed-disk-size-bytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-boot-disk-existing-disk-id, --resource-spec-compute-instance-spec-boot-disk-managed-disk-size-gibibytes, --resource-spec-compute-instance-spec-boot-disk-managed-disk-size-kibibytes, --resource-spec-compute-instance-spec-boot-disk-managed-disk-size-mebibytes, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-instance-spec-boot-disk-managed-disk-size-gibibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-boot-disk-existing-disk-id, --resource-spec-compute-instance-spec-boot-disk-managed-disk-size-bytes, --resource-spec-compute-instance-spec-boot-disk-managed-disk-size-kibibytes, --resource-spec-compute-instance-spec-boot-disk-managed-disk-size-mebibytes, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-instance-spec-boot-disk-managed-disk-size-kibibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-boot-disk-existing-disk-id, --resource-spec-compute-instance-spec-boot-disk-managed-disk-size-bytes, --resource-spec-compute-instance-spec-boot-disk-managed-disk-size-gibibytes, --resource-spec-compute-instance-spec-boot-disk-managed-disk-size-mebibytes, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-instance-spec-boot-disk-managed-disk-size-mebibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-boot-disk-existing-disk-id, --resource-spec-compute-instance-spec-boot-disk-managed-disk-size-bytes, --resource-spec-compute-instance-spec-boot-disk-managed-disk-size-gibibytes, --resource-spec-compute-instance-spec-boot-disk-managed-disk-size-kibibytes, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-instance-spec-boot-disk-managed-disk-source-image-family-image-family (string)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-boot-disk-existing-disk-id, --resource-spec-compute-instance-spec-boot-disk-managed-disk-source-image-id, --resource-spec-compute-instance-spec-boot-disk-managed-disk-source-snapshot-id, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-instance-spec-boot-disk-managed-disk-source-image-family-parent-id (string)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-boot-disk-existing-disk-id, --resource-spec-compute-instance-spec-boot-disk-managed-disk-source-image-id, --resource-spec-compute-instance-spec-boot-disk-managed-disk-source-snapshot-id, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-instance-spec-boot-disk-managed-disk-source-image-id (string)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-boot-disk-existing-disk-id, --resource-spec-compute-instance-spec-boot-disk-managed-disk-source-image-family-image-family, --resource-spec-compute-instance-spec-boot-disk-managed-disk-source-image-family-parent-id, --resource-spec-compute-instance-spec-boot-disk-managed-disk-source-snapshot-id, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-instance-spec-boot-disk-managed-disk-source-snapshot-id (string)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-boot-disk-existing-disk-id, --resource-spec-compute-instance-spec-boot-disk-managed-disk-source-image-family-image-family, --resource-spec-compute-instance-spec-boot-disk-managed-disk-source-image-family-parent-id, --resource-spec-compute-instance-spec-boot-disk-managed-disk-source-image-id, --resource-spec-compute-instance-update-spec-... flags group.

--resource-spec-compute-instance-spec-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.

A value must be one of:

unspecified
network_ssd
network_hdd
network_ssd_non_replicated
network_ssd_io_m3

--resource-spec-compute-instance-spec-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.

--resource-spec-compute-instance-spec-filesystems (json)

List of Shared Filesystems attached to the instance.

(structure)

attach_mode -> (string)[required]

A value must be one of:

“unspecified"
"read_only"
"read_write”

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:

[{                                                     
  "attach_mode": "unspecified"|"read_only"|"read_write",
  "existing_filesystem": {
    "id": ""              
  },
  "mount_tag": ""                                      
}]

--resource-spec-compute-instance-spec-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.

--resource-spec-compute-instance-spec-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.

--resource-spec-compute-instance-spec-id (string)

Identifier for the resource, unique for its resource type.

--resource-spec-compute-instance-spec-labels (string->string)

Labels associated with the resource.

--resource-spec-compute-instance-spec-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.

--resource-spec-compute-instance-spec-name (string)

Human readable name for the resource.

--resource-spec-compute-instance-spec-network-interfaces (json)

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)[required] [immutable]

Subnet ID.

JSON Schema:

[{                      
  "aliases": [{         
    "allocation_id": "" 
  }],
  "ip_address": {       
    "allocation_id": "" 
  },
  "name": "",           
  "public_ip_address": {
    "allocation_id": "",
    "static": false     
  },
  "security_groups": [{
    "id": ""           
  }],
  "subnet_id": ""       
}]

--resource-spec-compute-instance-spec-nvl-instance-group-id (string)

NVLink Instance Group ID associated with the VM.

--resource-spec-compute-instance-spec-parent-id (string)

Identifier of the parent resource to which the resource belongs.

--resource-spec-compute-instance-spec-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:

unspecified
stop

--resource-spec-compute-instance-spec-preemptible-priority (int32)

--resource-spec-compute-instance-spec-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:

recover
fail
always

--resource-spec-compute-instance-spec-reservation-policy-policy (string)

A value must be one of:

auto
forbid
strict

--resource-spec-compute-instance-spec-reservation-policy-reservation-ids (string array)

Capacity block groups, order matters.

--resource-spec-compute-instance-spec-resource-version (int64)

--resource-spec-compute-instance-spec-resources-platform (string)

--resource-spec-compute-instance-spec-resources-preset (string)

--resource-spec-compute-instance-spec-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:

“unspecified"
"read_only"
"read_write”

device_id -> (string)

Specifies the user-defined identifier, allowing to use ‘/dev/disk/by-id/virtio-’ as a device path in 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:

“disk_encryption_unspecified"
"disk_encryption_managed”

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.

A value must be one of:

“unspecified"
"network_ssd"
"network_hdd"
"network_ssd_non_replicated"
"network_ssd_io_m3”

JSON Schema:

[{                                                     
  "attach_mode": "unspecified"|"read_only"|"read_write",
  "device_id": "",                                     
  "existing_disk": {
    "id": ""        
  }
}]

--resource-spec-compute-instance-spec-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.

--resource-spec-compute-instance-spec-stopped (bool)

Indicates whether the instance should be stopped.

--resource-spec-compute-instance-update-spec-boot-disk-attach-mode (string)

A value must be one of:

unspecified
read_only
read_write

--resource-spec-compute-instance-update-spec-boot-disk-device-id (string)

Specifies the user-defined identifier, allowing to use ‘/dev/disk/by-id/virtio-’ as a device path in mount command.

--resource-spec-compute-instance-update-spec-boot-disk-existing-disk-id (string)

--resource-spec-compute-instance-update-spec-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).

--resource-spec-compute-instance-update-spec-boot-disk-managed-disk-disk-encryption-type (string)

A value must be one of:

disk_encryption_unspecified
disk_encryption_managed

--resource-spec-compute-instance-update-spec-boot-disk-managed-disk-forbid-deletion (bool)

Prevents deletion whilst set.

--resource-spec-compute-instance-update-spec-boot-disk-managed-disk-labels (string->string)

Labels associated with disk resource.

--resource-spec-compute-instance-update-spec-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.

--resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-bytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-boot-disk-existing-disk-id, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-gibibytes, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-kibibytes, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-mebibytes.

--resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-gibibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-boot-disk-existing-disk-id, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-bytes, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-kibibytes, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-mebibytes.

--resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-kibibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-boot-disk-existing-disk-id, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-bytes, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-gibibytes, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-mebibytes.

--resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-mebibytes (int64)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-boot-disk-existing-disk-id, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-bytes, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-gibibytes, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-size-kibibytes.

--resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-image-family-image-family (string)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-boot-disk-existing-disk-id, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-image-id, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-snapshot-id.

--resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-image-family-parent-id (string)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-boot-disk-existing-disk-id, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-image-id, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-snapshot-id.

--resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-image-id (string)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-boot-disk-existing-disk-id, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-image-family-image-family, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-image-family-parent-id, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-snapshot-id.

--resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-snapshot-id (string)

Mutually exclusive with: --resource-spec-compute-disk-spec-... flags group, --resource-spec-compute-disk-update-spec-... flags group, --resource-spec-compute-filesystem-spec-... flags group, --resource-spec-compute-filesystem-update-spec-... flags group, --resource-spec-compute-instance-spec-... flags group, --resource-spec-compute-instance-update-spec-boot-disk-existing-disk-id, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-image-family-image-family, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-image-family-parent-id, --resource-spec-compute-instance-update-spec-boot-disk-managed-disk-source-image-id.

--resource-spec-compute-instance-update-spec-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.

A value must be one of:

unspecified
network_ssd
network_hdd
network_ssd_non_replicated
network_ssd_io_m3

--resource-spec-compute-instance-update-spec-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.

--resource-spec-compute-instance-update-spec-filesystems (json)

List of Shared Filesystems attached to the instance.

(structure)

attach_mode -> (string)[required]

A value must be one of:

“unspecified"
"read_only"
"read_write”

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:

[{                                                     
  "attach_mode": "unspecified"|"read_only"|"read_write",
  "existing_filesystem": {
    "id": ""              
  },
  "mount_tag": ""                                      
}]

--resource-spec-compute-instance-update-spec-gpu-cluster-id (string)

--resource-spec-compute-instance-update-spec-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.

--resource-spec-compute-instance-update-spec-id (string)

Identifier for the resource, unique for its resource type.

--resource-spec-compute-instance-update-spec-labels (string->string)

Labels associated with the resource.

--resource-spec-compute-instance-update-spec-local-disks-passthrough-group-requested (bool)

--resource-spec-compute-instance-update-spec-name (string)

Human readable name for the resource.

--resource-spec-compute-instance-update-spec-network-interfaces (json)

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]

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)

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)[required] [immutable]

Subnet ID.

JSON Schema:

[{                      
  "aliases": [{         
    "allocation_id": "" 
  }],
  "ip_address": {       
    "allocation_id": "" 
  },
  "name": "",           
  "public_ip_address": {
    "allocation_id": "",
    "static": false     
  },
  "security_groups": [{
    "id": ""           
  }],
  "subnet_id": ""       
}]

--resource-spec-compute-instance-update-spec-nvl-instance-group-id (string)

NVLink Instance Group ID associated with the VM.

--resource-spec-compute-instance-update-spec-parent-id (string)

Identifier of the parent resource to which the resource belongs.

--resource-spec-compute-instance-update-spec-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:

unspecified
stop

--resource-spec-compute-instance-update-spec-preemptible-priority (int32)

--resource-spec-compute-instance-update-spec-recovery-policy (string)

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:

recover
fail
always

--resource-spec-compute-instance-update-spec-reservation-policy-policy (string)

A value must be one of:

auto
forbid
strict

--resource-spec-compute-instance-update-spec-reservation-policy-reservation-ids (string array)

Capacity block groups, order matters.

--resource-spec-compute-instance-update-spec-resource-version (int64)

--resource-spec-compute-instance-update-spec-resources-platform (string)

--resource-spec-compute-instance-update-spec-resources-preset (string)

--resource-spec-compute-instance-update-spec-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:

“unspecified"
"read_only"
"read_write”

device_id -> (string)

Specifies the user-defined identifier, allowing to use ‘/dev/disk/by-id/virtio-’ as a device path in 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:

“disk_encryption_unspecified"
"disk_encryption_managed”

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.

A value must be one of:

“unspecified"
"network_ssd"
"network_hdd"
"network_ssd_non_replicated"
"network_ssd_io_m3”

JSON Schema:

[{                                                     
  "attach_mode": "unspecified"|"read_only"|"read_write",
  "device_id": "",                                     
  "existing_disk": {
    "id": ""        
  }
}]

--resource-spec-compute-instance-update-spec-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.

--resource-spec-compute-instance-update-spec-stopped (bool)

Indicates whether the instance should be stopped.

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)

Enable debug logs.

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

Show Input argument JSON Schema

Full
CopyPaste Friendly

{                     
  "offer_types": enum(           // Type of offers to be applied to the cost estimate.
    "OFFER_TYPE_UNSPECIFIED",   
    "OFFER_TYPE_CONTRACT_PRICE"  // Contract price is a special price for SKU.
  ),
  "resource_spec": {                    // [required]
                                        // Resource specification for cost estimation.
                                        // Must contain exactly one resource type.
    "compute_disk_spec": { // Cannot be set together with: compute_instance_spec, compute_instance_update_spec, compute_disk_update_spec, compute_filesystem_spec, compute_filesystem_update_spec
      "metadata": {               
        "id": string,              // [identifier]
                                   // Identifier for the resource, unique for its resource type.
        "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": {                      
        "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"          
        )
      }
    },
    "compute_disk_update_spec": { // Cannot be set together with: compute_instance_spec, compute_instance_update_spec, compute_disk_spec, compute_filesystem_spec, compute_filesystem_update_spec
      "metadata": {               
        "id": string,              // [identifier]
                                   // Identifier for the resource, unique for its resource type.
        "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": {                      
        "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"          
        )
      }
    },
    "compute_filesystem_spec": { // Cannot be set together with: compute_instance_spec, compute_instance_update_spec, compute_disk_spec, compute_disk_update_spec, compute_filesystem_update_spec
      "metadata": {               
        "id": string,              // [identifier]
                                   // Identifier for the resource, unique for its resource type.
        "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": {                   
        "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).
        "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
        "type": enum(    // [required] [immutable]
                         // The Shared Filesystem type determines its limits and performance characteristics.
                         // For details, see https://docs.nebius.com/compute/storage/types#filesystems-types.
          "UNSPECIFIED",
          "NETWORK_SSD", // The list of available types will be clarified later, it is not final version.
          "NETWORK_HDD",
          "WEKA",       
          "VAST"        
        )
      }
    },
    "compute_filesystem_update_spec": { // Cannot be set together with: compute_instance_spec, compute_instance_update_spec, compute_disk_spec, compute_disk_update_spec, compute_filesystem_spec
      "metadata": {               
        "id": string,              // [identifier]
                                   // Identifier for the resource, unique for its resource type.
        "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": {                   
        "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).
        "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
        "type": enum(    // [required] [immutable]
                         // The Shared Filesystem type determines its limits and performance characteristics.
                         // For details, see https://docs.nebius.com/compute/storage/types#filesystems-types.
          "UNSPECIFIED",
          "NETWORK_SSD", // The list of available types will be clarified later, it is not final version.
          "NETWORK_HDD",
          "WEKA",       
          "VAST"        
        )
      }
    },
    "compute_instance_spec": { // Cannot be set together with: compute_instance_update_spec, compute_disk_spec, compute_disk_update_spec, compute_filesystem_spec, compute_filesystem_update_spec
      "metadata": {               
        "id": string,              // [identifier]
                                   // Identifier for the resource, unique for its resource type.
        "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 identifier, allowing to use '/dev/disk/by-id/virtio-{device_id}' as a device path in 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.
        }],
        "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    // [required] [immutable]
                                 // Subnet ID.
        }],
        "nvl_instance_group_id": string, // NVLink Instance Group ID associated with the VM.
        "preemptible": {         // [immutable]
                                 // Include these parameters to create a Preemptible VM and omit them to create a Regular VM
                                 // For details, see https://docs.nebius.com/compute/virtual-machines/preemptible.
          "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 identifier, allowing to use '/dev/disk/by-id/virtio-{device_id}' as a device path in 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.
        "stopped": bool                  // Indicates whether the instance should be stopped.
      }
    },
    "compute_instance_update_spec": { // Cannot be set together with: compute_instance_spec, compute_disk_spec, compute_disk_update_spec, compute_filesystem_spec, compute_filesystem_update_spec
      "metadata": {               
        "id": string,              // [identifier]
                                   // Identifier for the resource, unique for its resource type.
        "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 identifier, allowing to use '/dev/disk/by-id/virtio-{device_id}' as a device path in 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.
        }],
        "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    // [required] [immutable]
                                 // Subnet ID.
        }],
        "nvl_instance_group_id": string, // NVLink Instance Group ID associated with the VM.
        "preemptible": {         // [immutable]
                                 // Include these parameters to create a Preemptible VM and omit them to create a Regular VM
                                 // For details, see https://docs.nebius.com/compute/virtual-machines/preemptible.
          "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 identifier, allowing to use '/dev/disk/by-id/virtio-{device_id}' as a device path in 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.
        "stopped": bool                  // Indicates whether the instance should be stopped.
      }
    }
  }
}

nebius billing v1alpha1 calculator estimate '
{                                                                    
  "offer_types": "offer_type_unspecified"|"offer_type_contract_price",
  "resource_spec": {                   
    "compute_disk_spec": {
      "metadata": {           
        "id": "",             
        "labels": {           
          "": ""                  
        },
        "name": "",           
        "parent_id": "",      
        "resource_version": 0 
      },
      "spec": {                                                                                           
        "block_size_bytes": 0,                                                                            
        "disk_encryption": {                                             
          "type": "disk_encryption_unspecified"|"disk_encryption_managed"
        },
        "forbid_deletion": false,                                                                         
        "size_bytes": 0,                                                                                  
        "source_image_family": {
          "image_family": "",   
          "parent_id": ""       
        },
        "type": "unspecified"|"network_ssd"|"network_hdd"|"network_ssd_non_replicated"|"network_ssd_io_m3"
      }
    }
  }
}
'

Auto generated on 19-Aug-2026

Developer tools in Nebius AI Cloud

CLI

Terraform provider

REST API

gRPC API

Agent Resources

nebius billing v1alpha1 calculator estimate

Name

Synopsis

Options

Global Options

​Name

​Synopsis

​Options

​Global Options

Name

Synopsis

Options

Global Options