Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Yandex Managed Service for Kubernetes
  • Comparing with other Yandex Cloud services
  • Getting started
    • All guides
    • Connecting to a node over SSH
    • Connecting to a node via OS Login
    • Updating Kubernetes
    • Configuring autoscaling
    • Activating a Kubernetes Terraform provider
    • Installing applications from Yandex Cloud Marketplace using Terraform
    • Working with private Docker image registries
      • Information about existing node groups
      • Creating a node group
      • Creating a group with nodes from a reserved instance pool
      • Connecting to a node over SSH
      • Connecting to a node via OS Login
      • Configuring autoscaling
      • Updating a node group
      • Managing Kubernetes node labels
      • Deleting a node group
  • Access management
  • Pricing policy
  • Terraform reference
  • Monitoring metrics
  • Audit Trails events
  • Release notes

In this article:

  • Getting a list of node groups in a Kubernetes cluster
  • Getting detailed information about a node group
  1. Step-by-step guides
  2. Managing a node group
  3. Information about existing node groups

Information about existing node groups

Written by
Yandex Cloud
Updated at April 28, 2026
  • Getting a list of node groups in a Kubernetes cluster
  • Getting detailed information about a node group

To find out the ID or NAME of a node group, get a list of node groups in the Kubernetes cluster or detailed information about the node group.

Getting a list of node groups in a Kubernetes clusterGetting a list of node groups in a Kubernetes cluster

Get a list of node groups in a Kubernetes cluster:

Management console
CLI
API
  1. In the management console, select a folder.
  2. Go to Managed Service for Kubernetes.
  3. Click the name of the Kubernetes cluster.
  4. Navigate to the Node manager tab.

Run this command:

yc managed-kubernetes node-group list

Result:

+----------------------+----------------------+----------------+----------------------+---------------------+---------+------+
|          ID          |      CLUSTER ID      |      NAME      |  INSTANCE GROUP ID   |     CREATED AT      | STATUS  | SIZE |
+----------------------+----------------------+----------------+----------------------+---------------------+---------+------+
| catvhf4iv6dt******** | catcafja9ktu******** | test-nodegroup | cl1ec3le3qv3******** | 2019-04-09 10:56:22 | RUNNING |    2 |
+----------------------+----------------------+----------------+----------------------+---------------------+---------+------+

To get a list of node groups in a folder, use the list REST API method for the NodeGroup resource or the NodeGroupService/List gRPC API call.

Getting detailed information about a node groupGetting detailed information about a node group

To access a node group, use the ID or NAME parameter from the previous step.

Management console
CLI
Terraform
API
  1. In the management console, select a folder.
  2. Go to Managed Service for Kubernetes.
  3. Click the name of the Kubernetes cluster.
  4. Navigate to the Node manager tab.
  5. Click the name of the node group.

To view information about a specific node, navigate to the Nodes tab and click the node name.

Get detailed information about the node group:

yc managed-kubernetes node-group get test-nodegroup

Result:

id: catvhf4iv6dt********
cluster_id: catcafja9ktu********
created_at: "2019-04-09T10:56:22Z"
...
    subnet_id: b0c0jfcpqgng********
instance_group_id: cl1ec3le3qv3********
node_version: 1.13.3

With Terraform, you can quickly create a cloud infrastructure in Yandex Cloud and manage it using configuration files. These files store the infrastructure description written in HashiCorp Configuration Language (HCL). If you change the configuration files, Terraform automatically detects which part of your configuration is already deployed, and what should be added or removed.

Terraform is distributed under the Business Source License. The Yandex Cloud provider for Terraform is distributed under the MPL-2.0 license.

For more information about the provider resources, see the relevant documentation on the Terraform website or its mirror.

To get information about a Managed Service for Kubernetes node group:

  1. If you do not have Terraform yet, install it and configure the Yandex Cloud provider.

  2. Create a Terraform configuration file with a description of the yandex_kubernetes_node_group data source in the data section and the requested parameters in the output sections (one per section). For example:

    data "yandex_kubernetes_node_group" "my_node_group" {
      node_group_id = "<node_group_ID>"
    }
    
    output "node_group_status" {
      value = data.yandex_kubernetes_node_group.my_node_group.status
    }
    

    Where:

    • node_group_status: Name of the variable whose value will appear in the result.
    • data.yandex_kubernetes_node_group.my_node_group.status: Requested parameter. In our case, it is the node group status.

    For the list of node group parameters you can request this way, see this Terraform provider guide.

    Tip

    To request all available information about a node group, add the following output section to the file:

    output "node_group" {
      value = data.yandex_kubernetes_node_group.my_node_group
    }
    
  3. Make sure the configuration files are correct:

    1. In the command line, navigate to the folder containing the current Terraform configuration files.

    2. Run this command:

      terraform validate
      

      Terraform will display any configuration errors detected in your files.

  4. Run this command:

    terraform apply
    

    Terraform will display output variables in the terminal.

  5. To check the result, run the following command by specifying the required variable, e.g.:

    terraform output node_group_status
    

    Result:

    "running"
    

To get detailed information about a node group, use the get REST API method for the NodeGroup resource or the NodeGroupService/Get gRPC API call.

Was the article helpful?

Previous
Deleting a Kubernetes cluster
Next
Creating a node group
© 2026 Direct Cursus Technology L.L.C.