> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nebius.com/llms.txt
> Use this file to discover all available pages before exploring further.

# nebius mk8s v1alpha1 node-group update

## Name

`nebius mk8s v1alpha1 node-group update`

## Deprecated

Command node-group is deprecated. NodeGroup v1alpha1 API is deprecated, please migrate to v1.

## Synopsis

```
nebius mk8s v1alpha1 node-group update [id]
  --auto-repair-conditions
  --autoscaling-max-node-count
  --autoscaling-min-node-count
  --fixed-node-count
  --id
  --labels
  --labels-add
  --labels-remove
  --name
  --parent-id
  --resource-version
  --strategy-drain-timeout
  --strategy-max-surge-count
  --strategy-max-surge-percent
  --strategy-max-unavailable-count
  --strategy-max-unavailable-percent
  --template-boot-disk-block-size-bytes
  --template-boot-disk-size-bytes
  --template-boot-disk-size-gibibytes
  --template-boot-disk-size-kibibytes
  --template-boot-disk-size-mebibytes
  --template-boot-disk-type
  --template-cloud-init-user-data
  --template-filesystems
  --template-gpu-cluster-id
  --template-gpu-settings-drivers-preset
  --template-metadata-labels
  --template-network-interfaces
  --template-os
  --template-preemptible
  --template-resources-platform
  --template-resources-preset
  --template-service-account-id
  --template-taints
  --version
  --async
  --clear-mask
  --diff
  --full
  --patch
```

## Positional Arguments

`id`

Identifier for the resource, unique for its resource type.

## Options

`--auto-repair-conditions` (json)

Conditions that determine whether a node should be auto repaired.

(structure)

**disabled** -> (bool)

When true, disables the default auto-repair condition rules.

Mutually exclusive with: *timeout*.

**status** -> (string)

Node condition status.

A value must be one of:

<ul>
  <li>
    `"condition_status_unspecified"`
  </li>

  <li>
    `"true"`
  </li>

  <li>
    `"false"`
  </li>

  <li>
    `"unknown"`
  </li>
</ul>

**timeout** -> (duration)*\[google.protobuf.Duration]*

The duration after which the node is automatically repaired if the condition remains in the specified status.

Mutually exclusive with: *disabled*.

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

Node condition type.

JSON Schema:

```json theme={null}
[{                                                                 
  "disabled": false,                                               
  "status": "condition_status_unspecified"|"true"|"false"|"unknown",
  "type": ""                                                       
}]
```

`--autoscaling-max-node-count` (int64)

Mutually exclusive with: `--fixed-node-count`.

`--autoscaling-min-node-count` (int64)

Mutually exclusive with: `--fixed-node-count`.

`--fixed-node-count` (int64)

Mutually exclusive with: `--autoscaling-max-node-count`, `--autoscaling-min-node-count`.

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

`--name` (string)

Human-readable name for the resource.

`--parent-id` (string)

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.

`--strategy-drain-timeout` (duration: 2h30m10s)

DrainTimeout is the total amount of time that the service will spend on draining a node.\

By default, node can be drained without any time limitations.\

NOTE: NodeDrainTimeout is different from `kubectl drain --timeout`.

`--strategy-max-surge-count` (int64)

Mutually exclusive with: `--strategy-max-surge-percent`.

`--strategy-max-surge-percent` (int64)

Mutually exclusive with: `--strategy-max-surge-count`.

`--strategy-max-unavailable-count` (int64)

Mutually exclusive with: `--strategy-max-unavailable-percent`.

`--strategy-max-unavailable-percent` (int64)

Mutually exclusive with: `--strategy-max-unavailable-count`.

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

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

Mutually exclusive with: `--template-boot-disk-size-gibibytes`, `--template-boot-disk-size-kibibytes`, `--template-boot-disk-size-mebibytes`.

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

Mutually exclusive with: `--template-boot-disk-size-bytes`, `--template-boot-disk-size-kibibytes`, `--template-boot-disk-size-mebibytes`.

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

Mutually exclusive with: `--template-boot-disk-size-bytes`, `--template-boot-disk-size-gibibytes`, `--template-boot-disk-size-mebibytes`.

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

Mutually exclusive with: `--template-boot-disk-size-bytes`, `--template-boot-disk-size-gibibytes`, `--template-boot-disk-size-kibibytes`.

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

A value must be one of:

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

  <li>
    `network_ssd`
  </li>

  <li>
    `network_hdd`
  </li>

  <li>
    `network_ssd_io_m3`
  </li>

  <li>
    `network_ssd_non_replicated`
  </li>
</ul>

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

Cloud-init user-data. Must contain at least one SSH key.

`--template-filesystems` (json)

(structure)

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

A value must be one of:

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

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

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

**device\_name** -> (string)*\[required]*

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

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

JSON Schema:

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

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

`--template-gpu-settings-drivers-preset` (string)

Identifier of the predefined set of drivers included in the ComputeImage deployed on ComputeInstances that are part of the NodeGroup.\

Supported presets for different platform / k8s version combinations:\


* gpu-l40s-a, gpu-l40s-d, gpu-h100-sxm, gpu-h200-sxm:\

  * k8s: 1.30 → "cuda12" (CUDA 12.4)\

  * k8s: 1.31 → "cuda12" (CUDA 12.4), "cuda12.4", "cuda12.8"\

* gpu-b200-sxm:\

  * k8s: 1.31 → "cuda12" (CUDA 12.8), "cuda12.8"\

* gpu-b200-sxm-a:\

  * k8s: 1.31 → "cuda12.8".

`--template-metadata-labels` (string->string)

Labels will be propagated into nodes metadata.\

System labels containing "kubernetes.io" and "k8s.io" will not be propagated.\

On update labels they will not be updated in nodes right away, only on node group update.

`--template-network-interfaces` (json)

(structure)

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

Public IPv4 address associated with the interface.

**subnet\_id** -> (string)*\[non\_empty\_default]*

Subnet ID that will be attached to a node cloud instance network interface.\

By default control plane subnet\_id used.\

Subnet should be located in the same network with control plane and have same parent ID as cluster.

JSON Schema:

```json theme={null}
[{                      
  "public_ip_address": {
  },
  "subnet_id": ""       
}]
```

`--template-os` (string)

OS version that will be used to create the boot disk of Compute Instances in the NodeGroup.\

Supported platform / k8s version /  OS / driver presets combinations\


* gpu-l40s-a, gpu-l40s-d, gpu-h100-sxm, gpu-h200-sxm, cpu-e1, cpu-e2, cpu-d3:\

  * drivers\_preset: ""\

    * k8s: 1.30 → "ubuntu22.04"\

    * k8s: 1.31 → "ubuntu22.04" (default), "ubuntu24.04"\

* gpu-l40s-a, gpu-l40s-d, gpu-h100-sxm, gpu-h200-sxm:\

  * drivers\_preset: "cuda12" (CUDA 12.4)\

    * k8s: 1.30, 1.31 → "ubuntu22.04"\

  * drivers\_preset: "cuda12.4"\

    * k8s: 1.31 → "ubuntu22.04"\

  * drivers\_preset: "cuda12.8"\

    * k8s: 1.31 → "ubuntu24.04"\

* gpu-b200-sxm:\

  * drivers\_preset: ""\

    * k8s: 1.30, 1.31 → "ubuntu24.04"\

  * drivers\_preset: "cuda12" (CUDA 12.8)\

    * k8s: 1.30, 1.31 → "ubuntu24.04"\

  * drivers\_preset: "cuda12.8"\

    * k8s: 1.31 → "ubuntu24.04"\

* gpu-b200-sxm-a:\

  * drivers\_preset: ""\

    * k8s: 1.31 → "ubuntu24.04"\

  * drivers\_preset: "cuda12.8"\

    * k8s: 1.31 → "ubuntu24.04".

`--template-preemptible` (bool)

Configures whether the nodes in the group are preemptible.\

Set to empty value to enable preemptible nodes.

`--template-resources-platform` (string)

`--template-resources-preset` (string)

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

The Nebius service account whose credentials will be available on the nodes of the group. With these credentials, it is possible to\

make `nebius` CLI or public API requests from the nodes without the need for extra authentication. This service account is also used to\

make requests to container registry.\


`resource.serviceaccount.issueAccessToken` permission is required to use this field.

`--template-taints` (json)

(structure)

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

A value must be one of:

<ul>
  <li>
    `"effect_unspecified"`
  </li>

  <li>
    `"no_execute"`
  </li>

  <li>
    `"no_schedule"`
  </li>

  <li>
    `"prefer_no_schedule"`
  </li>
</ul>

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

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

JSON Schema:

```json theme={null}
[{                                                                              
  "effect": "effect_unspecified"|"no_execute"|"no_schedule"|"prefer_no_schedule",
  "key": "",                                                                    
  "value": ""                                                                   
}]
```

`--version` (string)

Version is desired Kubernetes version of the cluster. For now only acceptable format is\

`MAJOR.MINOR` like "1.31". Option for patch version update will be added later.\

By default the cluster control plane MAJOR.MINOR version will be used.

`--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 committing 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)

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

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

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

`--color` (bool)

Enable colored output.

`--no-browser` (bool)

Do not open browser automatically on auth.

`--insecure` (bool)

Disable transport security.

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

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

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

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

`--retries` (uint)

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

`--timeout` (duration: 2h30m10s)

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

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

Suppress check for updates.

`--no-progress` (bool)

Suppress progress indicators and spinners.

**Input argument JSON Schema**

> [tab] Full
>
> ```json theme={null}
> {              
>   "metadata": {                // [required]
>     "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": {                   
>     "auto_repair": {   // Parameters for nodes auto repair.
>       "conditions": [{         // Conditions that determine whether a node should be auto repaired.
>         "disabled": bool,      // Cannot be set together with: timeout
>                                // When true, disables the default auto-repair condition rules.
>         "status": enum(                   // Node condition status.
>           "CONDITION_STATUS_UNSPECIFIED",
>           "TRUE",                        
>           "FALSE",                       
>           "UNKNOWN"                      
>         ),
>         "timeout": "2h30m10s", // [google.protobuf.Duration]
>                                // Cannot be set together with: disabled
>                                // The duration after which the node is automatically repaired if the condition remains in the specified status.
>         "type": string         // [required]
>                                // Node condition type.
>       }]
>     },
>     "autoscaling": {           // Cannot be set together with: fixed_node_count
>       "max_node_count": int64,
>       "min_node_count": int64 
>     },
>     "fixed_node_count": int64, // Cannot be set together with: autoscaling
>     "strategy": {                 
>       "drain_timeout": "2h30m10s", // [google.protobuf.Duration]
>                                    // DrainTimeout is the total amount of time that the service will spend on draining a node.
>                                    // By default, node can be drained without any time limitations.
>                                    // NOTE: NodeDrainTimeout is different from `kubectl drain --timeout`.
>       "max_surge": {      // The maximum number of machines that can be scheduled above the
>                           // desired number of machines.
>                           // Value can be an absolute number (ex: 5) or a percentage of
>                           // desired machines (ex: 10%).
>                           // This can not be 0 if MaxUnavailable is 0.
>                           // Absolute number is calculated from percentage by rounding up.
>                           // Defaults to 1.
>                           // Example: when this is set to 30%, the new MachineSet can be scaled
>                           // up immediately when the rolling update starts, such that the total
>                           // number of old and new machines do not exceed 130% of desired
>                           // machines. Once old machines have been killed, new MachineSet can
>                           // be scaled up further, ensuring that total number of machines running
>                           // at any time during the update is at most 130% of desired machines.
>         "count": int64,   // Cannot be set together with: percent
>         "percent": int64  // Cannot be set together with: count
>       },
>       "max_unavailable": { // The maximum number of machines that can be unavailable during the update.
>                            // Value can be an absolute number (ex: 5) or a percentage of desired
>                            // machines (ex: 10%).
>                            // Absolute number is calculated from percentage by rounding down.
>                            // This can not be 0 if MaxSurge is 0.
>                            // Defaults to 0.
>                            // Example: when this is set to 30%, the old MachineSet can be scaled
>                            // down to 70% of desired machines immediately when the rolling update
>                            // starts. Once new machines are ready, old MachineSet can be scaled
>                            // down further, followed by scaling up the new MachineSet, ensuring
>                            // that the total number of machines available at all times
>                            // during the update is at least 70% of desired machines.
>         "count": int64,    // Cannot be set together with: percent
>         "percent": int64   // Cannot be set together with: count
>       }
>     },
>     "template": {                     // [required]
>       "boot_disk": {               // [non_empty_default]
>         "block_size_bytes": int64,
>         "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(                   // [non_empty_default]
>           "UNSPECIFIED",               
>           "NETWORK_SSD",                // The list of available types will be clarified later, it is not final version.
>           "NETWORK_HDD",               
>           "NETWORK_SSD_IO_M3",         
>           "NETWORK_SSD_NON_REPLICATED" 
>         )
>       },
>       "cloud_init_user_data": string, // [sensitive]
>                                       // Cloud-init user-data. Must contain at least one SSH key.
>       "filesystems": [{         
>         "attach_mode": enum( // [required]
>           "UNSPECIFIED",    
>           "READ_ONLY",      
>           "READ_WRITE"      
>         ),
>         "device_name": string,   // [required]
>         "existing_filesystem": {
>           "id": string           // [required]
>         }
>       }],
>       "gpu_cluster": {
>         "id": string  
>       },
>       "gpu_settings": {           // GPU-related settings.
>         "drivers_preset": string  // [required]
>                                   // Identifier of the predefined set of drivers included in the ComputeImage deployed on ComputeInstances that are part of the NodeGroup.
>                                   // Supported presets for different platform / k8s version combinations:
>                                   // - gpu-l40s-a, gpu-l40s-d, gpu-h100-sxm, gpu-h200-sxm:
>                                   //   - k8s: 1.30 → "cuda12" (CUDA 12.4)
>                                   //   - k8s: 1.31 → "cuda12" (CUDA 12.4), "cuda12.4", "cuda12.8"
>                                   // - gpu-b200-sxm:
>                                   //   - k8s: 1.31 → "cuda12" (CUDA 12.8), "cuda12.8"
>                                   // - gpu-b200-sxm-a:
>                                   //   - k8s: 1.31 → "cuda12.8".
>       },
>       "metadata": {
>         "labels": {        // [map]
>                            // Labels will be propagated into nodes metadata.
>                            // System labels containing "kubernetes.io" and "k8s.io" will not be propagated.
>                            // On update labels they will not be updated in nodes right away, only on node group update.
>           string: string          
>         }
>       },
>       "network_interfaces": [{ // [non_empty_default]
>         "public_ip_address": { // [meaningful_empty_value]
>                                // Public IPv4 address associated with the interface.
>         },
>         "subnet_id": string    // [non_empty_default]
>                                // Subnet ID that will be attached to a node cloud instance network interface.
>                                // By default control plane subnet_id used.
>                                // Subnet should be located in the same network with control plane and have same parent ID as cluster.
>       }],
>       "os": string,                   // OS version that will be used to create the boot disk of Compute Instances in the NodeGroup.
>                                       // Supported platform / k8s version /  OS / driver presets combinations
>                                       // - gpu-l40s-a, gpu-l40s-d, gpu-h100-sxm, gpu-h200-sxm, cpu-e1, cpu-e2, cpu-d3:
>                                       //   - drivers_preset: ""
>                                       //     - k8s: 1.30 → "ubuntu22.04"
>                                       //     - k8s: 1.31 → "ubuntu22.04" (default), "ubuntu24.04"
>                                       // - gpu-l40s-a, gpu-l40s-d, gpu-h100-sxm, gpu-h200-sxm:
>                                       //   - drivers_preset: "cuda12" (CUDA 12.4)
>                                       //     - k8s: 1.30, 1.31 → "ubuntu22.04"
>                                       //   - drivers_preset: "cuda12.4"
>                                       //     - k8s: 1.31 → "ubuntu22.04"
>                                       //   - drivers_preset: "cuda12.8"
>                                       //     - k8s: 1.31 → "ubuntu24.04"
>                                       // - gpu-b200-sxm:
>                                       //   - drivers_preset: ""
>                                       //     - k8s: 1.30, 1.31 → "ubuntu24.04"
>                                       //   - drivers_preset: "cuda12" (CUDA 12.8)
>                                       //     - k8s: 1.30, 1.31 → "ubuntu24.04"
>                                       //   - drivers_preset: "cuda12.8"
>                                       //     - k8s: 1.31 → "ubuntu24.04"
>                                       // - gpu-b200-sxm-a:
>                                       //   - drivers_preset: ""
>                                       //     - k8s: 1.31 → "ubuntu24.04"
>                                       //   - drivers_preset: "cuda12.8"
>                                       //     - k8s: 1.31 → "ubuntu24.04".
>       "preemptible": { // [meaningful_empty_value]
>                        // Configures whether the nodes in the group are preemptible.
>                        // Set to empty value to enable preemptible nodes.
>       },
>       "resources": {        // [required]
>         "platform": string, // [required]
>         "preset": string   
>       },
>       "service_account_id": string,   // The Nebius service account whose credentials will be available on the nodes of the group. With these credentials, it is possible to
>                                       // make `nebius` CLI or public API requests from the nodes without the need for extra authentication. This service account is also used to
>                                       // make requests to container registry.
>                                       // 
>                                       // `resource.serviceaccount.issueAccessToken` permission is required to use this field.
>       "taints": [{      
>         "effect": enum(         // [required]
>           "EFFECT_UNSPECIFIED",
>           "NO_EXECUTE",        
>           "NO_SCHEDULE",       
>           "PREFER_NO_SCHEDULE" 
>         ),
>         "key": string,   // [required]
>         "value": string  // [required]
>       }]
>     },
>     "version": string          // Version is desired Kubernetes version of the cluster. For now only acceptable format is
>                                // `MAJOR.MINOR` like "1.31". Option for patch version update will be added later.
>                                // By default the cluster control plane MAJOR.MINOR version will be used.
>   }
> }
> ```

> [tab] CopyPaste Friendly
>
> ```json theme={null}
> nebius mk8s v1alpha1 node-group update '
> {              
>   "metadata": {           
>     "id": "",             
>     "labels": {           
>       "": ""                  
>     },
>     "name": "",           
>     "parent_id": "",      
>     "resource_version": 0 
>   },
>   "spec": {               
>     "auto_repair": {  
>       "conditions": [{                                                   
>         "disabled": false,                                               
>         "status": "condition_status_unspecified"|"true"|"false"|"unknown",
>         "type": ""                                                       
>       }]
>     },
>     "autoscaling": {      
>       "max_node_count": 0,
>       "min_node_count": 0 
>     },
>     "strategy": {                 
>       "drain_timeout": "2h30m10s",
>       "max_surge": { 
>         "count": 0   
>       },
>       "max_unavailable": {
>         "count": 0        
>       }
>     },
>     "template": {                
>       "boot_disk": {                                                                                      
>         "block_size_bytes": 0,                                                                            
>         "size_bytes": 0,                                                                                  
>         "type": "unspecified"|"network_ssd"|"network_hdd"|"network_ssd_io_m3"|"network_ssd_non_replicated"
>       },
>       "cloud_init_user_data": "",
>       "filesystems": [{                                      
>         "attach_mode": "unspecified"|"read_only"|"read_write",
>         "device_name": "",                                   
>         "existing_filesystem": {
>           "id": ""              
>         }
>       }],
>       "gpu_cluster": {
>         "id": ""      
>       },
>       "gpu_settings": {      
>         "drivers_preset": "" 
>       },
>       "metadata": {
>         "labels": {   
>           "": ""          
>         }
>       },
>       "network_interfaces": [{
>         "public_ip_address": {
>         },
>         "subnet_id": ""       
>       }],
>       "os": "",                  
>       "preemptible": {
>       },
>       "resources": {   
>         "platform": "",
>         "preset": ""   
>       },
>       "service_account_id": "",  
>       "taints": [{                                                                    
>         "effect": "effect_unspecified"|"no_execute"|"no_schedule"|"prefer_no_schedule",
>         "key": "",                                                                    
>         "value": ""                                                                   
>       }]
>     },
>     "version": ""         
>   }
> }
> '
> ```

*Auto generated on 11-Nov-2026*
