> ## 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 vpc subnet create</code>
  </p>
</div>

<div>
  <h2>Synopsis</h2>

  <p style={{ paddingLeft: "4ch" }}>
    ```
    nebius vpc subnet create
      --ipv4-private-pools-pools
      --ipv4-private-pools-use-network-pools
      --ipv4-public-pools-pools
      --ipv4-public-pools-use-network-pools
      --labels
      --name
      --network-id [required]
      --parent-id [required]
      --resource-version
      --route-table-id
      --async
      -i, --interactive
    ```
  </p>
</div>

<div>
  <h2>Options</h2>

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

    <p style={{ paddingLeft: "4ch" }}>
      List of private IPv4 CIDR blocks for this subnet.<br />
      Must not overlap with other resources in the network<br />
      Must be empty if `use_network_pools` is true.
    </p>

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

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

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

        <p style={{ paddingLeft: "6ch" }}>
          A CIDR block (e.g., "10.1.2.0/24") or a prefix length (e.g., "/24").<br />
          If prefix length is specified, the CIDR block will be auto-allocated<br />
          from the network's available space.
        </p>
      </p>

      <p style={{ paddingLeft: "2ch" }}>
        <p style={{ paddingLeft: "4ch" }}>
          <strong>max\_mask\_length</strong> -> (int64)<em>\[non\_empty\_default]</em>
        </p>

        <p style={{ paddingLeft: "6ch" }}>
          Maximum mask length for an allocation from this block. Defaults to /32 for IPv4.
        </p>
      </p>

      <p style={{ paddingLeft: "2ch" }}>
        <p style={{ paddingLeft: "4ch" }}>
          <strong>state</strong> -> (string)<em>\[non\_empty\_default]</em>
        </p>

        <p style={{ paddingLeft: "6ch" }}>
          Controls provisioning of IP addresses from the CIDR block. Defaults to AVAILABLE.
        </p>

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

        <ul style={{ paddingLeft: "8ch" }}>
          <li>
            <code>"state\_unspecified"</code>
          </li>

          <li>
            <code>"available"</code>
          </li>

          <li>
            <code>"disabled"</code>
          </li>
        </ul>
      </p>
    </p>

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

    <p style={{ paddingLeft: "4ch" }}>
      ```json theme={null}
      [{           
        "cidrs": [{                                          
          "cidr": "",                                        
          "max_mask_length": 0,                              
          "state": "state_unspecified"|"available"|"disabled"
        }]
      }]
      ```
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--ipv4-private-pools-use-network-pools` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      If true, inherit private IPv4 pools from the network. Defaults to true.<br />
      Must be false if `pools` is specified.
    </p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      List of public IPv4 CIDR blocks for this subnet.<br />
      Must not overlap with other resources in the network.<br />
      Must be empty if `use_network_pools` is true.
    </p>

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

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

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

        <p style={{ paddingLeft: "6ch" }}>
          A CIDR block (e.g., "10.1.2.0/24") or a prefix length (e.g., "/24").<br />
          If prefix length is specified, the CIDR block will be auto-allocated<br />
          from the network's available space.
        </p>
      </p>

      <p style={{ paddingLeft: "2ch" }}>
        <p style={{ paddingLeft: "4ch" }}>
          <strong>max\_mask\_length</strong> -> (int64)<em>\[non\_empty\_default]</em>
        </p>

        <p style={{ paddingLeft: "6ch" }}>
          Maximum mask length for an allocation from this block. Defaults to /32 for IPv4.
        </p>
      </p>

      <p style={{ paddingLeft: "2ch" }}>
        <p style={{ paddingLeft: "4ch" }}>
          <strong>state</strong> -> (string)<em>\[non\_empty\_default]</em>
        </p>

        <p style={{ paddingLeft: "6ch" }}>
          Controls provisioning of IP addresses from the CIDR block. Defaults to AVAILABLE.
        </p>

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

        <ul style={{ paddingLeft: "8ch" }}>
          <li>
            <code>"state\_unspecified"</code>
          </li>

          <li>
            <code>"available"</code>
          </li>

          <li>
            <code>"disabled"</code>
          </li>
        </ul>
      </p>
    </p>

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

    <p style={{ paddingLeft: "4ch" }}>
      ```json theme={null}
      [{           
        "cidrs": [{                                          
          "cidr": "",                                        
          "max_mask_length": 0,                              
          "state": "state_unspecified"|"available"|"disabled"
        }]
      }]
      ```
    </p>
  </div>

  <div style={{ paddingLeft: "4ch" }}>
    <p>
      `--ipv4-public-pools-use-network-pools` (bool)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      If true, inherit public IPv4 pools from the network.<br />
      Must be false if `pools` is specified.
    </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-id` (string)<em> \[required]</em>
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      ID of the network this subnet belongs to.
    </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>
      `--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>
      `--route-table-id` (string)
    </p>

    <p style={{ paddingLeft: "4ch" }}>
      ID of the route table to associate with the subnet.<br />
      If unspecified, the network's default route table is used.
    </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": {                // [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]
          "ipv4_private_pools": {      // [non_empty_default]
                                       // Private IPv4 address pools for this subnet.
                                       // If unspecified, pools from the associated network are used.
            "pools": [{   // List of private IPv4 CIDR blocks for this subnet.
                          // Must not overlap with other resources in the network
                          // Must be empty if `use_network_pools` is true.
              "cidrs": [{                
                "cidr": string,           // [required]
                                          // A CIDR block (e.g., "10.1.2.0/24") or a prefix length (e.g., "/24").
                                          // If prefix length is specified, the CIDR block will be auto-allocated
                                          // from the network's available space.
                "max_mask_length": int64, // [non_empty_default]
                                          // Maximum mask length for an allocation from this block. Defaults to /32 for IPv4.
                "state": enum(         // [non_empty_default]
                                       // Controls provisioning of IP addresses from the CIDR block. Defaults to AVAILABLE.
                  "STATE_UNSPECIFIED", // Not used, mandated by the protocol.
                  "AVAILABLE",         // Default state. Provision of the IP addresses from this CIDR block is allowed.
                  "DISABLED"           // Provision of the IP addresses from this CIDR block is denied.
                )
              }]
            }],
            "use_network_pools": bool  // If true, inherit private IPv4 pools from the network. Defaults to true.
                                       // Must be false if `pools` is specified.
          },
          "ipv4_public_pools": {       // [non_empty_default]
                                       // Public IPv4 address pools for this subnet.
                                       // If unspecified, pools from the associated network are used.
            "pools": [{   // List of public IPv4 CIDR blocks for this subnet.
                          // Must not overlap with other resources in the network.
                          // Must be empty if `use_network_pools` is true.
              "cidrs": [{                
                "cidr": string,           // [required]
                                          // A CIDR block (e.g., "10.1.2.0/24") or a prefix length (e.g., "/24").
                                          // If prefix length is specified, the CIDR block will be auto-allocated
                                          // from the network's available space.
                "max_mask_length": int64, // [non_empty_default]
                                          // Maximum mask length for an allocation from this block. Defaults to /32 for IPv4.
                "state": enum(         // [non_empty_default]
                                       // Controls provisioning of IP addresses from the CIDR block. Defaults to AVAILABLE.
                  "STATE_UNSPECIFIED", // Not used, mandated by the protocol.
                  "AVAILABLE",         // Default state. Provision of the IP addresses from this CIDR block is allowed.
                  "DISABLED"           // Provision of the IP addresses from this CIDR block is denied.
                )
              }]
            }],
            "use_network_pools": bool  // If true, inherit public IPv4 pools from the network.
                                       // Must be false if `pools` is specified.
          },
          "network_id": string,     // [required]
                                    // ID of the network this subnet belongs to.
          "route_table_id": string  // ID of the route table to associate with the subnet.
                                    // If unspecified, the network's default route table is used.
        }
      }
      ```
    </Tab>

    <Tab title="CopyPaste Friendly">
      ```json theme={null}
      nebius vpc subnet create '
      {              
        "metadata": {           
          "labels": {           
            "": ""                  
          },
          "name": "",           
          "parent_id": "",      
          "resource_version": 0 
        },
        "spec": {                
          "ipv4_private_pools": {      
            "pools": [{  
              "cidrs": [{                                          
                "cidr": "",                                        
                "max_mask_length": 0,                              
                "state": "state_unspecified"|"available"|"disabled"
              }]
            }],
            "use_network_pools": false 
          },
          "ipv4_public_pools": {       
            "pools": [{  
              "cidrs": [{                                          
                "cidr": "",                                        
                "max_mask_length": 0,                              
                "state": "state_unspecified"|"available"|"disabled"
              }]
            }],
            "use_network_pools": false 
          },
          "network_id": "",      
          "route_table_id": ""   
        }
      }
      '
      ```
    </Tab>
  </Tabs>
</Expandable>

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