Deleting a Network Load Balancer target group

Written by

Updated at May 13, 2025

Alert

Before deleting a target group, detach it from the network load balancer. You cannot restore a target group after it is deleted.

Management console

CLI

Terraform

API

To delete a target group:

In the management console, select the folder where you need to delete a target group.
In the list of services, select Network Load Balancer.
In the left-hand panel, select Target groups.
Click next to the target group you need to delete.
In the menu that opens, select Delete.
In the window that opens, click Delete.

If you do not have the Yandex Cloud (CLI) command line interface yet, install and initialize it.

The folder specified when creating the CLI profile is used by default. To change the default folder, use the yc config set folder-id <folder_ID> command. You can specify a different folder using the --folder-name or --folder-id parameter.

See the description of the CLI command for deleting a target group:
```
yc load-balancer target-group delete --help
```
Delete a target group from the default folder:
```
yc load-balancer target-group delete <target_group_name_or_ID>
```
You can get the target group ID and name with the list of target groups in the folder.

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 documentation on the Terraform website or mirror website.

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

To delete a target group created with Terraform:

Open the Terraform configuration file and delete the section describing the target group.

resource "yandex_lb_target_group" "foo" {
  name      = "<target_group_name>"
  target {
    subnet_id = "<subnet_ID>"
    address   = "<target_internal_IP_address>"
  }
  target {
    subnet_id = "<subnet_ID>"
    address   = "<resource_2_internal_IP_address>"
  }
}

Make sure the settings are correct.
1. In the command line, navigate to the directory that contains the current Terraform configuration files defining the infrastructure.
2. Run this command:
```
terraform validate
```
  Terraform will show any errors found in your configuration files.
Delete the network load balancer.
1. Run this command to view the planned changes:
```
terraform plan
```
  If you described the configuration correctly, the terminal will display a list of the resources to update and their parameters. This is a verification step that does not apply changes to your resources.
2. If everything looks correct, apply the changes:
  1. Run this command:
```
terraform apply
```
  2. Confirm updating the resources.
  3. Wait for the operation to complete.

To delete a target group, use the delete REST API method for the TargetGroup resource or the TargetGroupService/Delete gRPC API call.

You can get the target group ID with the list of target groups in the folder.

Deleting a Network Load Balancer target group

Was the article helpful?