Создание каталога

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

Yandex Cloud

Улучшена

Обновлена 21 апреля 2025 г.

Каталог — это пространство, в котором создаются и группируются ресурсы Yandex Cloud.

Консоль управления

CLI

Terraform

API

В консоли управления в списке слева выберите нужное облако.
Справа сверху нажмите кнопку Создать каталог.
Введите имя каталога. Требования к имени:
- длина — от 2 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.
(Опционально) Введите описание каталога.
Выберите опцию Создать сеть по умолчанию. Будет создана сеть с подсетями в каждой зоне доступности. Также в этой сети будет создана группа безопасности по умолчанию, внутри которой весь сетевой трафик разрешен.
Нажмите кнопку Создать.

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

Посмотрите описание команды создания каталога:
```
yc resource-manager folder create --help
```
Создайте новый каталог:
- с именем и без описания:
```
yc resource-manager folder create \
  --name new-folder
```
  Требования к имени:
  - длина — от 2 до 63 символов;
  - может содержать строчные буквы латинского алфавита, цифры и дефисы;
  - первый символ — буква, последний — не дефис.
- с именем и описанием:
```
yc resource-manager folder create \
  --name new-folder \
  --description "my first folder with description"
```

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

Опишите в конфигурационном файле параметры ресурсов, которые необходимо создать:
- cloud_id — идентификатор облака, в котором будет создан каталог. Необязательный параметр. По умолчанию будет использовано значение, указанное в настройках провайдера.
- name — имя создаваемого каталога. Обязательный параметр. Требования к имени:
  - длина — от 2 до 63 символов;
  - может содержать строчные буквы латинского алфавита, цифры и дефисы;
  - первый символ — буква, последний — не дефис.
- description — описание каталога. Необязательный параметр.
Пример структуры конфигурационного файла:
```
resource "yandex_resourcemanager_folder" "folder1" {
  cloud_id    = "<идентификатор_облака>"
  name        = "<имя_создаваемого_каталога>"
  description = "<описание_каталога>"
}
```
Более подробную информацию о параметрах ресурса yandex_resourcemanager_folder в Terraform, см. в документации провайдера.
Проверьте корректность конфигурационных файлов.
1. В командной строке перейдите в папку, где вы создали конфигурационный файл.
2. Проверьте конфигурацию командой:
```
terraform validate
```
  Если конфигурация является корректной, появится сообщение:
```
Success! The configuration is valid.
```
3. Выполните команду:
```
terraform plan
```
  Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет.
Разверните облачные ресурсы.
1. Если в конфигурации нет ошибок, выполните команду:
```
terraform apply
```
2. Подтвердите создание ресурсов: введите в терминал слово yes и нажмите Enter.
  
  После этого в указанном облаке будет создан каталог. Проверить появление каталога и его настройки можно в консоли управления или с помощью команды CLI:
```
yc resource-manager folder list
```

Чтобы создать каталог, воспользуйтесь методом REST API create для ресурса Folder или вызовом gRPC API FolderService/Create.

Создание каталога

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