[Документация Yandex Cloud](../../index.md) > [Yandex Virtual Private Cloud](../index.md) > [Пошаговые инструкции](index.md) > Облачная сеть > Создать облачную сеть

# Создать облачную сеть

Помимо облачной сети в каталоге по умолчанию вы можете создавать дополнительные облачные сети в других каталогах.

{% list tabs group=instructions %}

- Консоль управления {#console}

  Чтобы создать [облачную сеть](../concepts/network.md):
  1. В [консоли управления](https://kz.console.yandex.cloud) выберите каталог, где требуется создать облачную сеть.
  1. [Перейдите](https://kz.console.yandex.cloud/link/vpc) в сервис **Virtual Private Cloud**.
  1. В правом верхнем углу нажмите **Создать сеть**.
  1. В поле **Имя** укажите имя сети. Требования к имени:

      * длина — от 3 до 63 символов;
      * может содержать строчные буквы латинского алфавита, цифры и дефисы;
      * первый символ — буква, последний — не дефис.
  
  1. (Опционально) В поле **Описание** добавьте описание сети.
  1. По умолчанию выбрана опция **Создать подсети**. Если вы хотите [создать](subnet-create.md) подсети позднее, выключите опцию.
  1. Нажмите **Создать сеть**.

- CLI {#cli}

  Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), [установите и инициализируйте его](../../cli/quickstart.md#install).

  По умолчанию используется каталог, указанный при [создании](../../cli/operations/profile/profile-create.md) профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду `yc config set folder-id <идентификатор_каталога>`. Также для любой команды вы можете указать другой каталог с помощью параметров `--folder-name` или `--folder-id`. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

  Чтобы создать [облачную сеть](../concepts/network.md):
  1. Посмотрите описание команды CLI для создания облачной сети:

      ```
      yc vpc network create --help
      ```

  1. Создайте облачную сеть в каталоге по умолчанию:

      ```
      yc vpc network create \
        --name test-network-1 \
        --description "My test network"
      ```

      Параметры `--name` и `--description` необязательные — можно создать сеть без имени и описания и обращаться к ней по идентификатору.

      Требования к названию сети:

      * длина — от 3 до 63 символов;
      * может содержать строчные буквы латинского алфавита, цифры и дефисы;
      * первый символ — буква, последний — не дефис.

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

      ```
      yc vpc network list
      ```

      Результат:
      ```
      +----------------------+----------------+
      |          ID          |      NAME      |
      +----------------------+----------------+
      | enpiuvhhd4t8******** | test-network-1 |
      | enplom7a98s1******** | default        |
      +----------------------+----------------+
      ```

      Получите тот же список с большим количеством деталей в формате YAML:

      ```
      yc vpc network list --format yaml
      ```

      Результат:
      ```
      - id: enpiuvhhd4t8********
        folder_id: b1g6ci08ma55********
        created_at: "2018-10-23T11:12:51Z"
        name: test-network-1
        description: My first network
      - id: enplom7a98s1********
        folder_id: b1g6ci08ma55********
        created_at: "2018-09-24T08:23:00Z"
        name: default
        description: Auto-created default network
      ```

- Terraform {#tf}

  [Terraform](https://www.terraform.io/) позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.
  
  Terraform распространяется под лицензией [Business Source License](https://github.com/hashicorp/terraform/blob/main/LICENSE), а [провайдер Yandex Cloud для Terraform](https://github.com/yandex-cloud/terraform-provider-yandex) — под лицензией [MPL-2.0](https://www.mozilla.org/en-US/MPL/2.0/).
  
  Подробная информация о ресурсах провайдера в документации на сайте [Terraform](https://www.terraform.io/docs/providers/yandex/index.html) или в [зеркале](../../terraform/index.md).

  Если у вас еще нет Terraform, [установите его и настройте провайдер Yandex Cloud](../../tutorials/infrastructure-management/terraform-quickstart.md#install-terraform).
  
  
  Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, [аутентифицируйтесь](../../terraform/authentication.md) соответствующим способом.

  1. Опишите в конфигурационном файле параметры [облачной сети](../concepts/network.md):

     * `name` — имя облачной сети. Требования к имени:

        * длина — от 3 до 63 символов;
        * может содержать строчные буквы латинского алфавита, цифры и дефисы;
        * первый символ — буква, последний — не дефис.

     * `description` — описание облачной сети.
     * `labels` — [метки](../../resource-manager/concepts/labels.md) для облачной сети. Укажите пару ключ-значение.

     Пример структуры конфигурационного файла:

     ```hcl
     resource "yandex_vpc_network" "default" {
       name        = "<имя_сети>"
	   description = "<описание_сети>"
       labels = {
         tf-label    = "tf-label-value"
         empty-label = ""
       }
     }
     ```

     Подробнее о параметрах ресурса `vpc_network` в Terraform в [документации провайдера](../../terraform/resources/vpc_network.md).

  1. Проверьте корректность конфигурационных файлов.

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

        ```
        terraform plan
        ```

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

  1. Разверните облачные ресурсы.

     1. Если в конфигурации нет ошибок, выполните команду:

        ```
        terraform apply
        ```

     1. Подтвердите создание ресурсов: введите в терминал слово `yes` и нажмите **Enter**.

        После этого в указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в [консоли управления](https://kz.console.yandex.cloud) или с помощью команд [CLI](../../cli/quickstart.md):

        ```
        yc vpc network list
        ```

- API {#api}

  Чтобы создать [облачную сеть](../concepts/network.md), воспользуйтесь методом REST API [create](../api-ref/Network/create.md) для ресурса [Network](../api-ref/Network/index.md) или вызовом gRPC API [NetworkService/Create](../api-ref/grpc/Network/create.md) и передайте в запросе:

    * Идентификатор каталога, в котором будет размещена сеть, в параметре `folderId`.
    * Имя новой сети в параметре `name`. Допустимая длина имени — от 3 до 63 символов, последний символ — не дефис.
    * Описание новой сети в параметре `description`. Максимальная длина описания — 256 символов.

  Параметры `name` и `description` необязательные — можно создать сеть без имени и описания и обращаться к ней по идентификатору.

  О том, как узнать идентификатор каталога, читайте в разделе [Получение идентификатора каталога](../../resource-manager/operations/folder/get-id.md).

{% endlist %}

## Примеры {#examples}

Создайте облачную сеть с именем и описанием в выбранном каталоге:

{% list tabs group=instructions %}

- CLI {#cli}

  ```
  yc vpc network create --name test-network-1 \
    --description "My test network" \
    --folder-id b1gnbfd11bq5********
  ```

- Terraform {#tf}

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

     ```hcl
     resource "yandex_vpc_network" "default" {
       name        = "network-1"
	   description = "My first network"
     }
     ```

     Подробнее о параметрах ресурсов в Terraform в [документации провайдера](../../terraform/resources/vpc_network.md).

  1. Проверьте корректность конфигурационных файлов.

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

        ```
        terraform plan
        ```

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

  1. Разверните облачные ресурсы.

     1. Если в конфигурации нет ошибок, выполните команду:

        ```
        terraform apply
        ```

     1. Подтвердите создание ресурсов: введите в терминал слово `yes` и нажмите **Enter**.

        После этого в указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в [консоли управления](https://kz.console.yandex.cloud) или с помощью команд [CLI](../../cli/quickstart.md):

        ```
        yc vpc network list
        ```

{% endlist %}