Изменить облачную сеть

Статья создана

Yandex Cloud

Улучшена

kvendingoldo

Обновлена 30 октября 2024 г.

Примеры
- Изменение облачной сети с использованием имени

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

CLI

Terraform

API

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Посмотрите описание команды CLI для обновления параметров облачной сети:
```
yc vpc network update --help
```

Получите список всех сетей в каталоге по умолчанию:

yc vpc network list

Результат:

+----------------------+----------------+
|          ID          |      NAME      |
+----------------------+----------------+
| enpavfmgapum******** | test-network-1 |
| enplom7a98s1******** | default        |
+----------------------+----------------+

Выберите идентификатор (ID) или имя (NAME) нужной сети.

Измените параметры облачной сети, указав ее имя:

yc vpc network update enpavfmgapum******** --new-name test-network-renamed

Результат:

id: enpavfmgapum********
folder_id: b1g6ci08ma55********
created_at: "2018-10-23T14:05:32Z"
name: test-network-renamed
description: My first network
labels:
  new_label: test_label

Идентификатор и имя можно передавать не только как позиционный аргумент, но и с помощью флагов --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

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

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

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

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

Откройте файл конфигурации Terraform и измените фрагмент с описанием облачной сети:
```
...
resource "yandex_vpc_network" "default" {
  name        = "network-1"
  description = "My first network"
  labels = {
    tf-label    = "tf-label-value"
    empty-label = ""
  }
}
...
```
Более подробную информацию о параметрах ресурса yandex_vpc_network в Terraform см. в документации провайдера.
Проверьте конфигурацию командой:
```
terraform validate
```
Если конфигурация является корректной, появится сообщение:
```
Success! The configuration is valid.
```
Выполните команду:
```
terraform plan
```
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
Примените изменения конфигурации:
```
terraform apply
```
Подтвердите изменения: введите в терминал слово yes и нажмите Enter.

Проверить изменение облачной сети можно в консоли управления или с помощью команды CLI:
```
yc vpc network get <имя_сети>
```

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

Идентификатор изменяемой облачной сети в параметре networkId.

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

О том, как узнать идентификатор каталога, читайте в разделе Получение идентификатора каталога.
Новые настройки сети по необходимости:
- имя в параметре name;
- описание в параметре description;
- метки сети в параметре labels.
Список настроек, которые необходимо изменить, в параметре updateMask.

Важно

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

Примеры

Изменение облачной сети с использованием имени

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

CLI

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

Результат:

id: enpavfmgapum********
folder_id: b1g6ci08ma55********
created_at: "2018-10-23T14:05:32Z"
name: test-network-renamed
description: My first network
labels:
  new_label: test_label

Изменить облачную сеть

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

Изменение облачной сети с использованием имениИзменение облачной сети с использованием имени

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

Примеры

Изменение облачной сети с использованием имени