create

{              
  "metadata": {                // [required]
    "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": {                    // [required]
    "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.
  }
}