> ## 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 v1alpha1 allocation create</code>
  </p>
</div>

<div>
  <h2>Synopsis</h2>

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

<div>
  <h2>Options</h2>

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

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--ipv4-public`, `--ipv4-public-cidr`, `--ipv4-public-pool-id`.</p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      CIDR block for IPv4 Allocation.<br />
      May be a single IP address (such as 10.2.3.4),<br />
      a prefix length (such as /24) or a CIDR-formatted string (such as 10.1.2.0/24).<br />
      Random address (/32) from pool would be allocated if field is omitted.
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--ipv4-public`, `--ipv4-public-cidr`, `--ipv4-public-pool-id`.</p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      Pool for the IPv4 private allocation.
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--ipv4-private-subnet-id`, `--ipv4-public`, `--ipv4-public-cidr`, `--ipv4-public-pool-id`.</p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      Subnet ID.<br />
      Required same subnet to use allocation in subnet-resources (e.g. Network Interface).
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--ipv4-private-pool-id`, `--ipv4-public`, `--ipv4-public-cidr`, `--ipv4-public-pool-id`.</p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--ipv4-private`, `--ipv4-private-cidr`, `--ipv4-private-pool-id`, `--ipv4-private-subnet-id`.</p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      CIDR block for IPv4 Allocation.<br />
      May be a single IP address (such as 10.2.3.4),<br />
      a prefix length (such as /32) or a CIDR-formatted string (such as 10.1.2.0/32).<br />
      Random address (/32) from pool would be allocated if field is omitted.
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--ipv4-private`, `--ipv4-private-cidr`, `--ipv4-private-pool-id`, `--ipv4-private-subnet-id`.</p>
  </div>

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

    <p style={{ paddingLeft: "4ch" }}>
      Pool for the IPv4 public allocation.
    </p>

    <p style={{ paddingLeft: "4ch" }}>Mutually exclusive with: `--ipv4-private`, `--ipv4-private-cidr`, `--ipv4-private-pool-id`, `--ipv4-private-subnet-id`.</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>
      `--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>
      `--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": {      // [meaningful_empty_value]
                                 // Cannot be set together with: ipv4_public
            "cidr": string,      // [immutable]
                                 // CIDR block for IPv4 Allocation.
                                 // May be a single IP address (such as 10.2.3.4),
                                 // a prefix length (such as /24) or a CIDR-formatted string (such as 10.1.2.0/24).
                                 // Random address (/32) from pool would be allocated if field is omitted.
            "pool_id": string,   // [immutable]
                                 // Cannot be set together with: subnet_id
                                 // Pool for the IPv4 private allocation.
            "subnet_id": string  // [immutable]
                                 // Cannot be set together with: pool_id
                                 // Subnet ID.
                                 // Required same subnet to use allocation in subnet-resources (e.g. Network Interface).
          },
          "ipv4_public": {     // [meaningful_empty_value]
                               // Cannot be set together with: ipv4_private
            "cidr": string,    // [immutable]
                               // CIDR block for IPv4 Allocation.
                               // May be a single IP address (such as 10.2.3.4),
                               // a prefix length (such as /32) or a CIDR-formatted string (such as 10.1.2.0/32).
                               // Random address (/32) from pool would be allocated if field is omitted.
            "pool_id": string  // [immutable]
                               // Pool for the IPv4 public allocation.
          }
        }
      }
      ```
    </Tab>

    <Tab title="CopyPaste Friendly">
      ```json theme={null}
      nebius vpc v1alpha1 allocation create '
      {              
        "metadata": {           
          "labels": {           
            "": ""                  
          },
          "name": "",           
          "parent_id": "",      
          "resource_version": 0 
        },
        "spec": {          
          "ipv4_private": { 
            "cidr": "",     
            "pool_id": ""   
          }
        }
      }
      '
      ```
    </Tab>
  </Tabs>
</Expandable>

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