> ## 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_vpc_v1alpha1_allocation resource

## Schema

### Required

* `parent_id` (String) Identifier of the parent resource to which the resource belongs.

### Optional

* `ipv4_private` (Attributes) *Cannot be set alongside ipv4\_public.* (see [below for nested schema](#nestedatt--ipv4_private))
* `ipv4_public` (Attributes) *Cannot be set alongside ipv4\_private.* (see [below for nested schema](#nestedatt--ipv4_public))
* `labels` (Map of String) Labels associated with the resource.
* `metadata` (Attributes) :

  Metadata for the Allocation.
  `metadata.parent_id` represents IAM Container.

  #### Inner value description

  Common resource metadata. (see [below for nested schema](#nestedatt--metadata))
* `name` (String) Human readable name for the resource.

### Read-Only

* `created_at` (String) :

  Timestamp indicating when the resource was created.

  A string representing a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ` or `YYYY-MM-DDTHH:MM:SS.SSS±HH:MM`
* `id` (String) Identifier for the resource, unique for its resource type.
* `resource_version` (Number) :

  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.
* `status` (Attributes) Contains the current status of the allocation, indicating its state and any additional details. (see [below for nested schema](#nestedatt--status))
* `updated_at` (String) :

  Timestamp indicating when the resource was last updated.

  A string representing a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ` or `YYYY-MM-DDTHH:MM:SS.SSS±HH:MM`

<a id="nestedatt--ipv4_private" />

### Nested Schema for `ipv4_private`

Optional:

* `cidr` (String) :

  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) :

  Pool for the IPv4 private allocation.

  *Cannot be set alongside subnet\_id.*
* `subnet_id` (String) :

  Subnet ID.
  Required same subnet to use allocation in subnet-resources (e.g. Network Interface)

  *Cannot be set alongside pool\_id.*

<a id="nestedatt--ipv4_public" />

### Nested Schema for `ipv4_public`

Optional:

* `cidr` (String) :

  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) Pool for the IPv4 public allocation.

<a id="nestedatt--metadata" />

### Nested Schema for `metadata`

<a id="nestedatt--status" />

### Nested Schema for `status`

Read-Only:

* `assignment` (Attributes) :

  Information about the assignment associated with the allocation,
  such as network interface or load balancer assignment. (see [below for nested schema](#nestedatt--status--assignment))
* `details` (Attributes) :

  Detailed information about the allocation status,
  including the allocated CIDR, pool ID, scope type, and IP version. (see [below for nested schema](#nestedatt--status--details))
* `state` (String) :

  This field represents the current state of the allocation.

  #### Supported values

  Enumeration of possible states of the Allocation.
  Possible values:

  * `STATE_UNSPECIFIED` - Default state, unspecified.
  * `CREATING` - Allocation is being created.
  * `ALLOCATED` - Allocation is ready for use.
  * `ASSIGNED` - Allocation is used.
  * `DELETING` - Allocation is being deleted.
* `static` (Boolean) If false - Lifecycle of allocation depends on resource that using it.

<a id="nestedatt--status--assignment" />

### Nested Schema for `status.assignment`

Read-Only:

* `load_balancer` (Attributes) *Cannot be set alongside network\_interface.* (see [below for nested schema](#nestedatt--status--assignment--load_balancer))
* `network_interface` (Attributes) *Cannot be set alongside load\_balancer.* (see [below for nested schema](#nestedatt--status--assignment--network_interface))

<a id="nestedatt--status--assignment--load_balancer" />

### Nested Schema for `status.assignment.load_balancer`

Read-Only:

* `id` (String) ID of the Load Balancer.

<a id="nestedatt--status--assignment--network_interface" />

### Nested Schema for `status.assignment.network_interface`

Read-Only:

* `instance_id` (String) ID of the Compute instance network interface belongs to.
* `name` (String) Network interface name
* `type` (String) :

  Type of allocation attachment on the network interface.

  #### Supported values

  Possible values:

  * `TYPE_UNSPECIFIED`
  * `PRIMARY` - Allocation is attached as the interface private IPv4 address.
  * `ALIAS` - Allocation is attached as an IP alias.
  * `PUBLIC` - Allocation is attached as the interface public IPv4 address.

<a id="nestedatt--status--details" />

### Nested Schema for `status.details`

Read-Only:

* `allocated_cidr` (String)
* `pool_id` (String)
* `version` (String) :

  #### Supported values

  Possible values:

  * `IP_VERSION_UNSPECIFIED` - Default, unspecified IP version.
  * `IPV4` - IPv4 address.
  * `IPV6` - IPv6 address.