> ## 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_mk8s_v1alpha1_cluster data source

#### Retrieving the Data Source

This data source can be retrieved by one of ID or name.

##### Retrieve by ID

To retrieve by ID, fill in only the `id` field:

```hcl theme={null}
data ... {
    id = "your-ID"
}
```

##### Retrieve by Name

To retrieve by name, fill in only the `name` and `parent_id` fields:

```hcl theme={null}
data ... {
    name      = "your name"
    parent_id = "data-source-parent-id"
}
```

## Schema

### Optional

* `id` (String) Identifier for the resource, unique for its resource type.
* `name` (String) Human readable name for the resource.
* `parent_id` (String) Identifier of the parent resource to which the resource belongs.

### Read-Only

* `control_plane` (Attributes) (see [below for nested schema](#nestedatt--control_plane))
* `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`
* `kube_network` (Attributes) Defines kubernetes network configuration, like IP allocation. (see [below for nested schema](#nestedatt--kube_network))
* `labels` (Map of String) Labels associated with the resource.
* `metadata` (Attributes) :

  #### Inner value description

  Common resource metadata. (see [below for nested schema](#nestedatt--metadata))
* `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) (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--control_plane" />

### Nested Schema for `control_plane`

Read-Only:

* `endpoints` (Attributes) (see [below for nested schema](#nestedatt--control_plane--endpoints))
* `etcd_cluster_size` (Number) :

  Number of instances in etcd cluster.
  3 by default.
  Control plane with `etcd_cluster_size: 3` called "Highly Available" ("HA"), because it's Kubernetes API
  will be available despite a failure of one control plane instance.
* `subnet_id` (String) Subnet ID where control plane instances will be located.
* `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.

<a id="nestedatt--control_plane--endpoints" />

### Nested Schema for `control_plane.endpoints`

Read-Only:

* `public_endpoint` (Attributes) PublicEndpointSpec is a specification of public endpoint for control plane. (see [below for nested schema](#nestedatt--control_plane--endpoints--public_endpoint))

<a id="nestedatt--control_plane--endpoints--public_endpoint" />

### Nested Schema for `control_plane.endpoints.public_endpoint`

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

### Nested Schema for `kube_network`

Read-Only:

* `service_cidrs` (List of String) :

  CIDR blocks for Service ClusterIP allocation.
  For now, only one value is supported.
  Must be a valid CIDR block or prefix length.
  In case of prefix length, certain CIDR is auto allocated.
  Specified CIDR blocks will be reserved in Cluster.spec.control\_plane.subnet\_id to prevent address duplication.
  Allowed prefix length is from "/12" to "/28".
  Empty value treated as \["/16"].

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

### Nested Schema for `metadata`

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

### Nested Schema for `status`

Read-Only:

* `control_plane` (Attributes) (see [below for nested schema](#nestedatt--status--control_plane))
* `reconciling` (Boolean) Show that changes are in flight
* `state` (String) :

  #### Supported values

  Possible values:

  * `STATE_UNSPECIFIED`
  * `PROVISIONING`
  * `RUNNING`
  * `DELETING`

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

### Nested Schema for `status.control_plane`

Read-Only:

* `auth` (Attributes) (see [below for nested schema](#nestedatt--status--control_plane--auth))
* `endpoints` (Attributes) :

  #### Inner value description

  Endpoints of Kubernetes control plane. Kubernetes API can be accessed at `https://endpoint/`. (see [below for nested schema](#nestedatt--status--control_plane--endpoints))
* `etcd_cluster_size` (Number) Number of instances in etcd cluster.
* `version` (String) Version have format `major.minor.patch-nebius-cp.n` like "1.30.0-nebius-cp.3".

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

### Nested Schema for `status.control_plane.auth`

Read-Only:

* `cluster_ca_certificate` (String)

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

### Nested Schema for `status.control_plane.endpoints`

Read-Only:

* `private_endpoint` (String) DNS name or IP address accessible from the user VPC.
* `public_endpoint` (String) DNS name or IP address accessible from the Internet.