Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • Машинное обучение
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Истории успеха
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Yandex Virtual Private Cloud
  • Начало работы
    • Все инструкции
      • Создать подсеть
      • Удалить подсеть
      • Изменить подсеть
      • Получить информацию о подсети
      • Перенести подсеть между каталогами
      • Перенести подсеть в другую зону доступности
      • Посмотреть список используемых адресов
    • Включить программно-ускоренную сеть
    • График сетевых соединений
    • Посмотреть операции с ресурсами сервиса
  • DDoS Protection
  • Управление доступом
  • Правила тарификации
  • Справочник Terraform
  • Аудитные логи Audit Trails
  • История изменений
  • Вопросы и ответы
  • Обучающие курсы

В этой статье:

  • Примеры
  • Изменение подсети с использованием флага имени
  1. Пошаговые инструкции
  2. Подсеть
  3. Изменить подсеть

Изменить подсеть

Статья создана
Yandex Cloud
Улучшена
Обновлена 20 мая 2025 г.
  • Примеры
    • Изменение подсети с использованием флага имени

После создания подсети вы можете изменить ее имя, описание и настройки DCHP.

Консоль управления
CLI
Terraform
API
  1. В консоли управления перейдите в каталог, где требуется изменить подсеть.
  2. В списке сервисов выберите Virtual Private Cloud.
  3. На панели слева выберите Подсети.
  4. Нажмите в строке нужной подсети и выберите Редактировать.
  5. Внесите нужные изменения.
  6. Нажмите Сохранить изменения.

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

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

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

    yc vpc subnet update --help
    
  2. Получите список всех подсетей в каталоге по умолчанию:

    yc vpc subnet list
    

    Результат:

    +----------------------+-----------------------+----------------------+
    |          ID          |         NAME          |         ...          |
    +----------------------+-----------------------+----------------------+
    ...
    | e2l2prrbkbim******** |     test-subnet-1     |         ...          |
    ...
    +----------------------+-----------------------+----------------------+
    
  3. Выберите идентификатор (ID) или имя (NAME) нужной подсети.

  4. Измените параметры подсети, например:

    yc vpc subnet update e2l2prrbkbim******** \
      --new-name test-subnet-renamed \
      --labels new_label=test_label
    

    Результат:

    id: e2l2prrbkbim********
    folder_id: b1g6ci08ma55********
    created_at: "2018-10-24T13:54:10Z"
    name: test-subnet-renamed
    description: My test subnet
    labels:
      new_label: test_label
    network_id: enplom7a98s1********
    zone_id: ru-central1-a
    v4_cidr_blocks:
    - 192.168.0.0/24
    

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

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

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

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

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

    ...
    resource "yandex_vpc_subnet" "lab-subnet-a" {
      name           = "subnet-1"
      description    = "My first subnet"
      v4_cidr_blocks = ["10.2.0.0/16"]
      zone           = "ru-central1-a"
      network_id     = "${yandex_vpc_network.lab-net.id}"
    }
    ...
    

    Более подробную информацию о параметрах ресурса yandex_vpc_subnet в Terraform см. в документации провайдера.

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

    terraform validate
    

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

    Success! The configuration is valid.
    
  3. Выполните команду:

    terraform plan
    

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

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

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

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

    yc vpc subnet get <имя_подсети>
    

Чтобы изменить подсеть, воспользуйтесь методом REST API update для ресурса Subnet или вызовом gRPC API SubnetService/Update и передайте в запросе:

  • Идентификатор изменяемой подсети в параметре subnetId.

    Чтобы узнать идентификатор подсети, воспользуйтесь методом REST API list для ресурса Subnet или вызовом gRPC API SubnetService/List и передайте в запросе идентификатор каталога в параметре folderId.

    О том, как узнать идентификатор каталога, читайте в разделе Получение идентификатора каталога.

  • Новые настройки подсети по необходимости:

    • имя в параметре name;
    • описание в параметре description;
    • метки подсети в параметре labels;
    • идентификатор таблицы маршрутизации в параметре routeTableId;
    • настройки DHCP в параметре dhcpOptions.
  • Список настроек, которые необходимо изменить, в параметре updateMask.

Важно

Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).

ПримерыПримеры

Изменение подсети с использованием флага имениИзменение подсети с использованием флага имени

CLI

Можно изменять подсеть, используя ее имя вместо идентификатора:

yc vpc subnet update test-subnet-1 \
  --new-name test-subnet-renamed \
  --labels new_label=test_label

Результат:

id: e2l2prrbkbim********
folder_id: b1g6ci08ma55********
created_at: "2018-10-24T13:54:10Z"
name: test-subnet-renamed
description: My test subnet
labels:
  new_label: test_label
network_id: enplom7a98s1********
zone_id: ru-central1-a
v4_cidr_blocks:
- 192.168.0.0/24

Идентификатор и имя подсети можно передавать не только как позиционный аргумент, но и с помощью параметров --id и --name:

yc vpc network update \
  --id enpavfmgapum******** \
  --new-name test-network-renamed \
  --labels new_label=test_label
yc vpc network update \
  --name test-network-1 \
  --new-name test-network-renamed \
  --labels new_label=test_label

Была ли статья полезна?

Предыдущая
Удалить подсеть
Следующая
Получить информацию о подсети
Проект Яндекса
© 2025 ООО «Яндекс.Облако»