Name
nebius compute instance update
Updates an existing VM instance with new configuration parameters.
Synopsis
Options
--boot-disk-attach-mode (string)
A value must be one of:
unspecifiedread_onlyread_write
--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.
--boot-disk-existing-disk-id (string)
--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.
--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:
--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.
--id (string)
Identifier for the resource, unique for its resource type.
--labels (string->string)
Labels associated with the resource.
--labels-add (string->string)
Add values to Labels associated with the resource.
--labels-remove (string array)
Remove values from Labels associated with the resource.
--local-disks-passthrough-group-requested (bool)
Passthrough local disks from the underlying host.
Devices are expected to appear in the guest as NVMe devices (nvme0, nvme1, …),
but the exact number depends on the preset.
Enabled only when this field is explicitly set.
--name (string)
Human readable name for the resource.
--network-interfaces (json)
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.
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.
JSON Schema:
--parent-id (string)
Identifier of the parent resource to which the resource belongs.
--reservation-policy-policy (string)
A value must be one of:
autoforbidstrict
--reservation-policy-reservation-ids (string array)
Capacity block groups, order matters.
--resource-version (int64)
Version of the resource for safe concurrent modifications and consistent reads.
Positive and monotonically increases on each resource spec change (but not on each change of the
resource’s container(s) or status).
Service allows zero value or current.
--resources-preset (string)
--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).
- To delete the disk together with the instance, switch to ManagedDisk in the instance spec.
- For the switch,
ManagedDisk.nameMUST match the current diskname
(see DiskService.Get for the disk referenced byExistingDisk.id). - When converting an ExistingDisk to a ManagedDisk, you must provide
ManagedDisk.nameandManagedDisk.spec
exactly as they are currently defined in the disk resource.
Obtain the current values viaDiskService.Getand copy them verbatim.
IfManagedDisk.specdiffers from the current disk spec, the instance update will fail.
id -> (string)[required]
JSON Schema:
--stopped (bool)
Indicates whether the instance should be stopped.
--async (bool)
If set, returns operation id. Otherwise, waits for the operation to complete and returns its resource.
--clear-mask (string array)
Reset-mask field paths to clear in patch mode. Can be repeated.
--diff (bool)
Show diff of resource before commiting update.
--full (bool)
Update full resource state. Automatically set to true if the —file or argument provided.
--patch (bool)
Update only specified fields.
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.
--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.