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

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

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

   yc resource-manager folder create --help
   

2. Создайте новый каталог:

   • с именем и без описания:

     yc resource-manager folder create \
       --name new-folder
     

     Требования к имени:

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

   • с именем и описанием:

     yc resource-manager folder create \
       --name new-folder \
       --description "my first folder with description"
     

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

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

   • cloud_id — идентификатор облака, в котором будет создан каталог. Необязательный параметр. По умолчанию будет использовано значение, указанное в настройках провайдера.

   • name — имя создаваемого каталога. Обязательный параметр. Требования к имени:

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

   • description — описание каталога. Необязательный параметр.

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

   resource "yandex_resourcemanager_folder" "folder1" {
     cloud_id    = "<идентификатор_облака>"
     name        = "<имя_создаваемого_каталога>"
     description = "<описание_каталога>"
   }
   

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

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

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

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

      terraform validate
      

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

      Success! The configuration is valid.
      

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

      terraform plan
      

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

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

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

      terraform apply
      

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

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

   yc resource-manager cloud list
   

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