Skip to main content

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:
data ... {
    id = "your-ID"
}
Retrieve by Name
To retrieve by name, fill in only the name and parent_id fields:
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)
  • created_at (String) : Timestamp indicating when the resource was created. A string representing a timestamp in 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)
  • labels (Map of String) : Labels associated with the resource.
  • metadata (Attributes) :

    Inner value description

    Common resource metadata. (see below for nested schema)
  • 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)
  • updated_at (String) : Timestamp indicating when the resource was last updated. A string representing a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DDTHH:MM:SS.SSS±HH:MM

Nested Schema for control_plane

Read-Only:
  • audit_logs (Attributes) : Specify configuration of the pushing k8s audit logs into service logs and show it in the UI. By default cluster will be created without it. (see below for nested schema)
  • endpoints (Attributes) Specification of endpoints of cluster control plane. (see below for nested schema)
  • 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.
  • karpenter (Attributes) : Enables installation of the Karpenter inside a cluster. Karpenter will be installed as a helm chart inside cluster so it requires creation of at least one CPU public node group. Please note that there is no feature parity between Karpenter node pools and public node groups. By default cluster will be created without it. (see below for nested schema)
  • subnet_id (String) : Nebius VPC Subnet ID where control plane instances will be located. Also will be default NodeGroup subnet.
  • version (String) : 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.

Nested Schema for control_plane.audit_logs

Nested Schema for control_plane.endpoints

Read-Only:
  • public_endpoint (Attributes) Public endpoint specification. When set, a public endpoint is created. (see below for nested schema)

Nested Schema for control_plane.endpoints.public_endpoint

Nested Schema for control_plane.karpenter

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”].

Nested Schema for metadata

Nested Schema for status

Read-Only:
  • control_plane (Attributes) (see below for nested schema)
  • reconciling (Boolean) Show that changes are in flight
  • state (String) :

    Supported values

    Possible values:
    • STATE_UNSPECIFIED
    • PROVISIONING
    • RUNNING
    • DELETING

Nested Schema for status.control_plane

Read-Only:
  • auth (Attributes) (see below for nested schema)
  • endpoints (Attributes) :

    Inner value description

    Endpoints of Kubernetes control plane. Kubernetes API can be accessed at https://endpoint/. (see below for nested schema)
  • etcd_cluster_size (Number) Number of instances in etcd cluster.
  • version (String) : Actual Kubernetes and configuration version. Version has format <major>.<minor>.<patch>-nebius-cp.<infra_version> like “1.30.0-nebius-cp.3”, where <major>.<minor>.<patch> is Kubernetes version and <infra_version> is version of control plane infrastructure and configuration, updating of which may include bug fixes, security updates and new features of components running on control plane, like CCM or Cluster Autoscaler.

Nested Schema for status.control_plane.auth

Read-Only:
  • cluster_ca_certificate (String) PEM with the Cluster Certificate Authority, that must be used for TLS connection to Kubernetes API.

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.