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

# create

<div>
  <h2>Name</h2>

  <p style={{ paddingLeft: "4ch" }}>
    <code>nebius compute v1alpha1 instance create</code>
  </p>
</div>

<div>
  <h2>Deprecated</h2>

  <p style={{ paddingLeft: "4ch" }}>
    Command instance is deprecated.
  </p>
</div>

<div>
  <h2>Synopsis</h2>

  <p style={{ paddingLeft: "4ch" }}>
    ```
    nebius compute v1alpha1 instance create
      --boot-disk-attach-mode
      --boot-disk-device-name
      --boot-disk-existing-disk-id
      --cloud-init-user-data
      --filesystems
      --gpu-cluster-id
      --labels
      --name
      --network-interfaces [required]
      --parent-id [required]
      --recovery-policy
      --resource-version
      --resources-platform [required]
      --resources-preset [required]
      --secondary-disks
      --service-account-id
      --stopped
      --async
      -i, --interactive
    ```
  </p>
</div>

<div>
  <h2>Options</h2>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--boot-disk-attach-mode` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>A value must be one of:</p>

    <ul style={{ paddingLeft: "8ch" }}>
      <li>
        <code>unspecified</code>
      </li>

      <li>
        <code>read\_only</code>
      </li>

      <li>
        <code>read\_write</code>
      </li>
    </ul>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--boot-disk-device-name` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Specifies the user-defined identifier, allowing to use '/dev/disk/by-id/virtio-{device_name}' as a device path in mount command.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--boot-disk-existing-disk-id` (string)
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--cloud-init-user-data` (string)
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--filesystems` (json)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      (structure)
    </p>

    <p style={{ paddingLeft: "2ch" }}>
      <p style={{ paddingLeft: "4ch" }}>
        <strong>attach\_mode</strong> -> (string)<em>\[required]</em>
      </p>

      <p style={{ paddingLeft: "6ch" }}>A value must be one of:</p>

      <ul style={{ paddingLeft: "8ch" }}>
        <li>
          <code>"unspecified"</code>
        </li>

        <li>
          <code>"read\_only"</code>
        </li>

        <li>
          <code>"read\_write"</code>
        </li>
      </ul>
    </p>

    <p style={{ paddingLeft: "2ch" }}>
      <p style={{ paddingLeft: "4ch" }}>
        <strong>device\_name</strong> -> (string)<em>\[required]</em>
      </p>

      <p style={{ paddingLeft: "6ch" }}>
        Specifies the user-defined identifier, allowing to use it as a device in mount command.
      </p>
    </p>

    <p style={{ paddingLeft: "2ch" }}>
      <p style={{ paddingLeft: "4ch" }}>
        <strong>existing\_filesystem</strong> -> (structure)
      </p>

      <p style={{ paddingLeft: "2ch" }}>
        <p style={{ paddingLeft: "4ch" }}>
          <strong>id</strong> -> (string)<em>\[required]</em>
        </p>
      </p>
    </p>

    <p style={{ paddingLeft: "4ch" }}>JSON Schema:</p>

    <p style={{ paddingLeft: "4ch" }}>
      ```json theme={null}
      [{                                                     
        "attach_mode": "unspecified"|"read_only"|"read_write",
        "device_name": "",                                   
        "existing_filesystem": {
          "id": ""              
        }
      }]
      ```
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--gpu-cluster-id` (string)
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--labels` (string->string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Labels associated with the resource.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--name` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Human readable name for the resource.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--network-interfaces` (json)<em> \[required]</em>
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      (structure)
    </p>

    <p style={{ paddingLeft: "2ch" }}>
      <p style={{ paddingLeft: "4ch" }}>
        <strong>aliases</strong> -> (structure)
      </p>

      <p style={{ paddingLeft: "6ch" }}>
        Assign ranges of IP addresses as aliases.
      </p>

      <p style={{ paddingLeft: "2ch" }}>
        <p style={{ paddingLeft: "4ch" }}>
          <strong>allocation\_id</strong> -> (string)<em>\[required]</em>
        </p>

        <p style={{ paddingLeft: "6ch" }}>
          ID of allocation.
        </p>
      </p>
    </p>

    <p style={{ paddingLeft: "2ch" }}>
      <p style={{ paddingLeft: "4ch" }}>
        <strong>ip\_address</strong> -> (structure)<em>\[meaningful\_empty\_value]</em>
      </p>

      <p style={{ paddingLeft: "6ch" }}>
        Private IPv4 address associated with the interface.
      </p>

      <p style={{ paddingLeft: "2ch" }}>
        <p style={{ paddingLeft: "4ch" }}>
          <strong>allocation\_id</strong> -> (string)
        </p>

        <p style={{ paddingLeft: "6ch" }}>
          Allocation identifier if it was created before.
        </p>
      </p>
    </p>

    <p style={{ paddingLeft: "2ch" }}>
      <p style={{ paddingLeft: "4ch" }}>
        <strong>name</strong> -> (string)<em>\[required]</em>
      </p>

      <p style={{ paddingLeft: "6ch" }}>
        Interface name<br />
        Value of this field configures the name of the network interface inside VM's OS.<br />
        Longer values will persist in the specification but will be truncated to 15 symbols before being passed to VM configuration.
      </p>
    </p>

    <p style={{ paddingLeft: "2ch" }}>
      <p style={{ paddingLeft: "4ch" }}>
        <strong>public\_ip\_address</strong> -> (structure)<em>\[meaningful\_empty\_value]</em>
      </p>

      <p style={{ paddingLeft: "6ch" }}>
        Public IPv4 address associated with the interface.
      </p>

      <p style={{ paddingLeft: "2ch" }}>
        <p style={{ paddingLeft: "4ch" }}>
          <strong>allocation\_id</strong> -> (string)
        </p>

        <p style={{ paddingLeft: "6ch" }}>
          Allocation identifier if it was created before.
        </p>
      </p>

      <p style={{ paddingLeft: "2ch" }}>
        <p style={{ paddingLeft: "4ch" }}>
          <strong>static</strong> -> (bool)
        </p>

        <p style={{ paddingLeft: "6ch" }}>
          If false - Lifecycle of allocation depends on NetworkInterface.Allocate/NetworkInterface.Deallocate<br />
          If true  - Lifecycle of allocation depends on NetworkInterface.Create/NetworkInterface.Delete<br />
          False by default.
        </p>
      </p>
    </p>

    <p style={{ paddingLeft: "2ch" }}>
      <p style={{ paddingLeft: "4ch" }}>
        <strong>subnet\_id</strong> -> (string)<em>\[required]</em>
        <em>\[immutable]</em>
      </p>

      <p style={{ paddingLeft: "6ch" }}>
        Subnet ID.
      </p>
    </p>

    <p style={{ paddingLeft: "4ch" }}>JSON Schema:</p>

    <p style={{ paddingLeft: "4ch" }}>
      ```json theme={null}
      [{                      
        "aliases": [{         
          "allocation_id": "" 
        }],
        "ip_address": {       
          "allocation_id": "" 
        },
        "name": "",           
        "public_ip_address": {
          "allocation_id": "",
          "static": false     
        },
        "subnet_id": ""       
      }]
      ```
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--parent-id` (string)<em> \[required]</em>
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Identifier of the parent resource to which the resource belongs.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--recovery-policy` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Recovery policy defines how the instance will be treated in case of a failure.<br />
      Common source of failure is a host failure, but it can be any other failure.<br />
      Instance undergoing a guest shutdown (poweroff, etc.) will be subject to recovery policy,<br />
      meaning that it could be restarted and billed accordingly.<br />
      Stop instance via API or UI to stop it to avoid recovering.<br />

      * If set to RECOVER, instance will be restarted, if possible. It could be restarted on the same host or on another host.<br />
      * If set to FAIL, instance will be stopped and not restarted.
    </p>

    <p style={{ paddingLeft: "4ch" }}>A value must be one of:</p>

    <ul style={{ paddingLeft: "8ch" }}>
      <li>
        <code>recover</code>
      </li>

      <li>
        <code>fail</code>
      </li>
    </ul>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--resource-version` (int64)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Version of the resource for safe concurrent modifications and consistent reads.<br />
      Positive and monotonically increases on each resource spec change (but *not* on each change of the<br />
      resource's container(s) or status).<br />
      Service allows zero value or current.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--resources-platform` (string)<em> \[required]</em>
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--resources-preset` (string)<em> \[required]</em>
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--secondary-disks` (json)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      (structure)
    </p>

    <p style={{ paddingLeft: "2ch" }}>
      <p style={{ paddingLeft: "4ch" }}>
        <strong>attach\_mode</strong> -> (string)<em>\[required]</em>
      </p>

      <p style={{ paddingLeft: "6ch" }}>A value must be one of:</p>

      <ul style={{ paddingLeft: "8ch" }}>
        <li>
          <code>"unspecified"</code>
        </li>

        <li>
          <code>"read\_only"</code>
        </li>

        <li>
          <code>"read\_write"</code>
        </li>
      </ul>
    </p>

    <p style={{ paddingLeft: "2ch" }}>
      <p style={{ paddingLeft: "4ch" }}>
        <strong>device\_name</strong> -> (string)
      </p>

      <p style={{ paddingLeft: "6ch" }}>
        Specifies the user-defined identifier, allowing to use '/dev/disk/by-id/virtio-{device_name}' as a device path in mount command.
      </p>
    </p>

    <p style={{ paddingLeft: "2ch" }}>
      <p style={{ paddingLeft: "4ch" }}>
        <strong>existing\_disk</strong> -> (structure)
      </p>

      <p style={{ paddingLeft: "2ch" }}>
        <p style={{ paddingLeft: "4ch" }}>
          <strong>id</strong> -> (string)<em>\[required]</em>
        </p>
      </p>
    </p>

    <p style={{ paddingLeft: "4ch" }}>JSON Schema:</p>

    <p style={{ paddingLeft: "4ch" }}>
      ```json theme={null}
      [{                                                     
        "attach_mode": "unspecified"|"read_only"|"read_write",
        "device_name": "",                                   
        "existing_disk": {
          "id": ""        
        }
      }]
      ```
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--service-account-id` (string)
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--stopped` (bool)
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--async` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      If set, returns operation id. Otherwise, waits for the operation to complete and returns its resource.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `-i, --interactive` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      If set, suggests to insert field values in interactive mode.
    </p>
  </div>
</div>

<div>
  <h2>Global Options</h2>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `-h, --help` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Show this message.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `-p, --profile` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set a profile for interacting with the cloud.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--format` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Output format. Supported values: yaml|json|jsonpath|table|text.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `-f, --file` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Input file. For 'update' commands automatically set --full=true.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `-c, --config` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Provide path to config file.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--debug` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Enable debug logs.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--color` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Enable colored output.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--no-browser` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Do not open browser automatically on auth.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--insecure` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Disable transport security.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--auth-timeout` (duration: 2h30m10s)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set the timeout for the request including authentication process, default is 15m0s.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--per-retry-timeout` (duration: 2h30m10s)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set the timeout for each retry attempt, default is 20s.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--retries` (uint)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set the number of retry attempts, 1 is disable retries, default is 3.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--timeout` (duration: 2h30m10s)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Set the timeout for the main request, default is 1m0s.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--no-check-update` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Suppress check for updates.
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--no-progress` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      Suppress progress indicators and spinners.
    </p>
  </div>
</div>

<Expandable title="Input argument JSON Schema">
  <Tabs>
    <Tab title="Full">
      ```json theme={null}
      {              
        "metadata": {               
          "labels": {                // [map]
                                     // Labels associated with the resource.
            string: string                  
          },
          "name": string,            // Human readable name for the resource.
          "parent_id": string,       // [required]
                                     // Identifier of the parent resource to which the resource belongs.
          "resource_version": int64  // Version of the resource for safe concurrent modifications and consistent reads.
                                     // Positive and monotonically increases on each resource spec change (but *not* on each change of the
                                     // resource's container(s) or status).
                                     // Service allows zero value or current.
        },
        "spec": {                        
          "boot_disk": {           // [immutable]
            "attach_mode": enum( // [required]
              "UNSPECIFIED",    
              "READ_ONLY",      
              "READ_WRITE"      
            ),
            "device_name": string, // Specifies the user-defined identifier, allowing to use '/dev/disk/by-id/virtio-{device_name}' as a device path in mount command.
            "existing_disk": {
              "id": string     // [required]
            }
          },
          "cloud_init_user_data": string, // [sensitive]
          "filesystems": [{          // [immutable]
            "attach_mode": enum( // [required]
              "UNSPECIFIED",    
              "READ_ONLY",      
              "READ_WRITE"      
            ),
            "device_name": string,   // [required]
                                     // Specifies the user-defined identifier, allowing to use it as a device in mount command.
            "existing_filesystem": {
              "id": string           // [required]
            }
          }],
          "gpu_cluster": { // [immutable]
            "id": string  
          },
          "network_interfaces": [{ // [required] [immutable]
            "aliases": [{              // Assign ranges of IP addresses as aliases.
              "allocation_id": string  // [required]
                                       // ID of allocation.
            }],
            "ip_address": {            // [meaningful_empty_value]
                                       // Private IPv4 address associated with the interface.
              "allocation_id": string  // Allocation identifier if it was created before.
            },
            "name": string,        // [required]
                                   // 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 - Lifecycle of allocation depends on NetworkInterface.Allocate/NetworkInterface.Deallocate
                                       // If true  - Lifecycle of allocation depends on NetworkInterface.Create/NetworkInterface.Delete
                                       // False by default.
            },
            "subnet_id": string    // [required] [immutable]
                                   // Subnet ID.
          }],
          "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.
            "RECOVER",            
            "FAIL"                
          ),
          "resources": {        // [required] [immutable]
            "platform": string, // [required]
            "preset": string   
          },
          "secondary_disks": [{   
            "attach_mode": enum( // [required]
              "UNSPECIFIED",    
              "READ_ONLY",      
              "READ_WRITE"      
            ),
            "device_name": string, // Specifies the user-defined identifier, allowing to use '/dev/disk/by-id/virtio-{device_name}' as a device path in mount command.
            "existing_disk": {
              "id": string     // [required]
            }
          }],
          "service_account_id": string,   // [immutable]
          "stopped": bool                
        }
      }
      ```
    </Tab>

    <Tab title="CopyPaste Friendly">
      ```json theme={null}
      nebius compute v1alpha1 instance create '
      {              
        "metadata": {           
          "labels": {           
            "": ""                  
          },
          "name": "",           
          "parent_id": "",      
          "resource_version": 0 
        },
        "spec": {                            
          "boot_disk": {                                         
            "attach_mode": "unspecified"|"read_only"|"read_write",
            "device_name": "",                                   
            "existing_disk": {
              "id": ""        
            }
          },
          "cloud_init_user_data": "",        
          "filesystems": [{                                      
            "attach_mode": "unspecified"|"read_only"|"read_write",
            "device_name": "",                                   
            "existing_filesystem": {
              "id": ""              
            }
          }],
          "gpu_cluster": {
            "id": ""      
          },
          "network_interfaces": [{
            "aliases": [{         
              "allocation_id": "" 
            }],
            "ip_address": {       
              "allocation_id": "" 
            },
            "name": "",           
            "public_ip_address": {
              "allocation_id": "",
              "static": false     
            },
            "subnet_id": ""       
          }],
          "recovery_policy": "recover"|"fail",
          "resources": {   
            "platform": "",
            "preset": ""   
          },
          "secondary_disks": [{                                  
            "attach_mode": "unspecified"|"read_only"|"read_write",
            "device_name": "",                                   
            "existing_disk": {
              "id": ""        
            }
          }],
          "service_account_id": "",          
          "stopped": false                   
        }
      }
      '
      ```
    </Tab>
  </Tabs>
</Expandable>

<strong>Auto generated on 12-May-2026</strong>