Связаться с экспертомПопробовать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»

Изменить целевую группу

Статья создана
Улучшена
Обновлена 31 августа 2026 г.
Открыть в Markdown

Вы можете изменять параметры, добавлять или удалять виртуальные машины из целевой группы.

Изменить параметры целевой группы

Чтобы изменить параметры целевой группы:

  1. В консоли управления выберите каталог, в котором создана целевая группа.
  2. Перейдите в сервис Application Load Balancer.
  3. На панели слева выберите Целевые группы.
  4. В строке с целевой группой нажмите → Редактировать.
  5. Внесите нужные изменения.
  6. Нажмите Сохранить.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

  1. Посмотрите описание команды CLI для изменения параметров целевой группы:

    yc alb target-group update --help

  2. Выполните команду:

    yc alb target-group update \
   --name <имя_целевой_группы> \
   --new-name <новое_имя_целевой_группы> \
   --description "<описание_целевой_группы>" \
   --labels <ключ_метки_1>=<значение_метки_1>[,<ключ_метки_n>=<значение_метки_n>]

    Результат:

    id: ds7d3ah05hg9********
name: new-name
description: this is a target group
folder_id: b1g681qpemb4********
labels:
  my-label: my-value
targets:
  - ip_address: 10.129.0.12
    subnet_id: e2lb1da2dd9v********
created_at: "2026-08-25T13:12:37.409977826Z"

    Подробнее о команде yc alb target-group update с полным перечнем параметров в справочнике CLI.

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробная информация о ресурсах провайдера в документации на сайте Terraform или в зеркале.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, аутентифицируйтесь соответствующим способом.

  1. Откройте конфигурационный файл Terraform и измените фрагмент с описанием целевой группы:

    resource "yandex_alb_target_group" "foo" {
  name           = "<имя_целевой_группы>"
  description    = "<описание_целевой_группы>"
  labels      = {
    <ключ_метки_1> = "<значение_метки_1>",
    <ключ_метки_2> = "<значение_метки_2>"
  }

...
}

    Где yandex_alb_target_group — параметры целевой группы:

    • name — имя целевой группы.
    • description — описание целевой группы.
    • labels — метки целевой группы.

    Подробнее о параметрах ресурса yandex_alb_target_group в документации провайдера.

  2. Примените изменения:

    1. В терминале перейдите в директорию с конфигурационным файлом.

    2. Проверьте корректность конфигурации с помощью команды:

      terraform validate

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.

    3. Выполните команду:

      terraform plan

      В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

    4. Примените изменения конфигурации:

      terraform apply

    5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

    Проверить изменения целевой группы можно в консоли управления или с помощью команды CLI:

    yc alb target-group get --name <имя_целевой_группы>

    Ограничения по времени

    Провайдер Terraform ограничивает время на выполнение операций с целевыми группами Application Load Balancer 10 минутами.

    Операции, которые длятся дольше указанного времени, прерываются.

    Как изменить эти ограничения?

    Добавьте к описанию целевой группы блок timeouts, например:

    resource "yandex_alb_target_group" "<имя_целевой_группы>" {
  ...
  timeouts {
    create = "60m"
    update = "60m"
    delete = "60m"
  }
}

Воспользуйтесь методом REST API update для ресурса TargetGroup или вызовом gRPC API TargetGroupService/Update.

Добавить ВМ в целевую группу

Чтобы добавить ВМ в целевую группу:

  1. В консоли управления выберите каталог, в котором создана целевая группа.

  2. Перейдите в сервис Application Load Balancer.

  3. На панели слева выберите Целевые группы.

  4. Нажмите на имя нужной целевой группы.

  5. Нажмите Добавить целевые ресурсы.

  6. Выберите ВМ из списка или добавьте целевой ресурс вручную:

    1. В поле IP-адрес укажите IP-адрес ресурса и выберите подсеть.

    2. (Опционально) Если IP-адрес ресурса находится вне Yandex Virtual Private Cloud, выберите опцию Не из VPC.

      Например, укажите частный IPv4-адрес из вашего ЦОД, подключенного к Yandex Cloud через Yandex Cloud Interconnect. IP-адрес должен входить в частные диапазоны из RFC 1918. Подробнее в разделе Подсети.

      Важно

      Функциональность доступна только в регионе Россия.

    3. Нажмите Добавить целевой ресурс.

  7. Нажмите кнопку Добавить.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

  1. Посмотрите описание команды CLI для добавления ресурсов в целевые группы:

    yc alb target-group add-targets --help

  2. Выполните команду, указав имя целевой группы, имя подсети и внутренний IP-адрес ВМ:

    yc alb target-group add-targets \
  --name <имя_целевой_группы> \
  --target subnet-name=<имя_подсети>,ip-address=<внутренний_IP-адрес_ВМ>

    Результат:

    done (1s)
id: a5d751meibht********
name: <имя_целевой_группы>
targets:
...
  - ip_address: <внутренний_IP-адрес_ВМ>
    subnet_id: fo2tgfikh3he********
created_at: "2021-02-11T11:16:27.770674538Z"

    Также вы можете добавить в целевую группу ресурсы, которые размещены вне Yandex Virtual Private Cloud, например в вашем ЦОД, подключенном к Yandex Cloud через Yandex Cloud Interconnect. IP-адреса ресурсов должны входить в частные диапазоны из RFC 1918. Подробнее в разделе Подсети.

    Важно

    Функциональность доступна только в регионе Россия.

    Выполните команду, указав в параметрах имя целевой группы и частный IPv4-адрес ресурса:

    yc alb target-group add-targets \
  --name <имя_целевой_группы> \
  --target private-ip-address=true,ip-address=<частный_IPv4-адрес_ресурса>

    Результат:

    done (1s)
id: a5d751meibht4ev26...
name: <имя_целевой_группы>
targets:
...
  - ip_address: <частный_IPv4-адрес_ресурса>
    private_ipv4_address: true
created_at: "2023-07-25T08:55:14.172526884Z"

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробная информация о ресурсах провайдера в документации на сайте Terraform или в зеркале.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, аутентифицируйтесь соответствующим способом.

  1. Откройте конфигурационный файл Terraform и добавьте блок target с параметрами целевого ресурса во фрагмент с описанием целевой группы:

    resource "yandex_alb_target_group" "foo" {
  name           = "<имя_целевой_группы>"

  target {
    subnet_id    = "<идентификатор_подсети>"
    ip_address   = "<внутренний_IP-адрес_ВМ_1>"
  }

  target {
    subnet_id    = "<идентификатор_подсети>"
    ip_address   = "<внутренний_IP-адрес_ВМ_2>"
  }

  target {
    subnet_id    = "<идентификатор_подсети>"
    ip_address   = "<внутренний_IP-адрес_ВМ_3>"
  }

  target {
    subnet_id    = "<идентификатор_подсети>"
    ip_address   = "<внутренний_IP-адрес_ВМ_4>"
  }
}

    Где yandex_alb_target_group — параметры целевой группы:

    • name — имя целевой группы.

    • target — параметры целевого ресурса:

      • subnet_id — идентификатор подсети, в которой размещена ВМ. Получить список доступных подсетей можно с помощью команды CLI: yc vpc subnet list.
      • ip_address — внутренний IP-адрес ВМ. Получить список внутренних IP-адресов можно с помощью команды CLI: yc vpc subnet list-used-addresses --id <идентификатор_подсети>.

    Также вы можете добавить в целевую группу ресурсы, которые размещены вне Yandex Virtual Private Cloud, например в вашем ЦОД, подключенном к Yandex Cloud через Yandex Cloud Interconnect:

    resource "yandex_alb_target_group" "foo" {
  name                   = "<имя_целевой_группы>"

  target {
    private_ipv4_address = true
    ip_address           = "<частный_IPv4-адрес_ресурса_1>"
  }

  target {
    private_ipv4_address = true
    ip_address           = "<частный_IPv4-адрес_ресурса_2>"
  }

  target {
    private_ipv4_address = true
    ip_address           = "<частный_IPv4-адрес_ресурса_3>"
  }
}

    Важно

    Функциональность доступна только в регионе Россия.

    Где yandex_alb_target_group — параметры целевой группы:

    • name — имя целевой группы.

    • target — параметры целевого ресурса:

      • private_ipv4_address — параметр, который означает, что IP-адрес находится вне Virtual Private Cloud.
      • ip_address — частный IPv4-адрес ресурса. IP-адреса должны входить в частные диапазоны из RFC 1918. Подробнее в разделе Подсети.

    Подробнее о параметрах ресурса yandex_alb_target_group в документации провайдера.

  2. Примените изменения:

    1. В терминале перейдите в директорию с конфигурационным файлом.

    2. Проверьте корректность конфигурации с помощью команды:

      terraform validate

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.

    3. Выполните команду:

      terraform plan

      В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

    4. Примените изменения конфигурации:

      terraform apply

    5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

    Проверить изменения целевой группы можно в консоли управления или с помощью команды CLI:

    yc alb target-group get --name <имя_целевой_группы>

    Ограничения по времени

    Провайдер Terraform ограничивает время на выполнение операций с целевыми группами Application Load Balancer 10 минутами.

    Операции, которые длятся дольше указанного времени, прерываются.

    Как изменить эти ограничения?

    Добавьте к описанию целевой группы блок timeouts, например:

    resource "yandex_alb_target_group" "<имя_целевой_группы>" {
  ...
  timeouts {
    create = "60m"
    update = "60m"
    delete = "60m"
  }
}

Воспользуйтесь методом REST API addTargets для ресурса TargetGroup или вызовом gRPC API TargetGroupService/AddTargets.

Удалить ВМ из целевой группы

Чтобы удалить ВМ из целевой группы:

  1. В консоли управления выберите каталог, в котором создана целевая группа.
  2. Перейдите в сервис Application Load Balancer.
  3. На панели слева выберите Целевые группы.
  4. Нажмите на имя нужной целевой группы.
  5. Справа от нужной ВМ нажмите и выберите Удалить.
  6. В открывшемся окне нажмите кнопку Удалить.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

  1. Посмотрите описание команды CLI для удаления ресурсов из целевой группы:

    yc alb target-group remove-targets --help

  2. Выполните следующую команду, указав имя целевой группы, имя подсети и внутренний IP-адрес ВМ:

    yc alb target-group remove-targets \
  --name <имя_целевой_группы> \
  --target subnet-name=<имя_подсети>,ip-address=<внутренний_IP-адрес_ВМ>

    Результат:

    id: ds7urm6dn6cm********
name: <имя_целевой_группы>
folder_id: aoerb349v3h4********
created_at: "2023-06-10T13:14:55.239094324Z"

    Чтобы удалить из целевой группы ресурс, который размещен вне Virtual Private Cloud, например в вашем ЦОД, подключенном к Yandex Cloud через Cloud Interconnect, выполните команду, указав имя целевой группы и частный IPv4-адрес ресурса:

    yc alb target-group remove-targets \
  --name <имя_целевой_группы> \
  --target private-ip-address=true,ip-address=<частный_IPv4-адрес_ресурса>

    Результат:

    id: ds7urm6dn6cm********
name: <имя_целевой_группы>
folder_id: aoerb349v3h4********
created_at: "2023-06-10T13:14:55.239094324Z"

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробная информация о ресурсах провайдера в документации на сайте Terraform или в зеркале.

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, аутентифицируйтесь соответствующим способом.

  1. Откройте конфигурационный файл Terraform и удалите блок target с IP-адресом ВМ, которую нужно удалить, во фрагменте с описанием целевой группы:

    Пример описания целевой группы в конфигурации Terraform:

    resource "yandex_alb_target_group" "foo" {
  name           = "<имя_целевой_группы>"

  target {
    subnet_id    = "<идентификатор_подсети>"
    ip_address   = "<внутренний_IP-адрес_ВМ_1>"
  }

  target {
    subnet_id    = "<идентификатор_подсети>"
    ip_address   = "<внутренний_IP-адрес_ВМ_2>"
  }

  target {
    subnet_id    = "<идентификатор_подсети>"
    ip_address   = "<внутренний_IP-адрес_ВМ_3>"
  }
}

    Подробнее о параметрах ресурса yandex_alb_target_group в документации провайдера.

  2. Примените изменения:

    1. В терминале перейдите в директорию с конфигурационным файлом.

    2. Проверьте корректность конфигурации с помощью команды:

      terraform validate

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.

    3. Выполните команду:

      terraform plan

      В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.

    4. Примените изменения конфигурации:

      terraform apply

    5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

    Проверить изменения целевой группы можно в консоли управления или с помощью команды CLI:

    yc alb target-group get --name <имя_целевой_группы>

Воспользуйтесь методом REST API removeTargets для ресурса TargetGroup или вызовом gRPC API TargetGroupService/RemoveTargets.

Предыдущая
Получить информацию о целевой группе
Следующая
Удалить целевую группу