Создание устройства

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

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

2. Создайте устройство:

   yc iot device create --registry-name my-registry --name my-device
   

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

   Результат:

   id: b9135goeh1uc1s2i07nm
   registry_id: b91ki3851hab9m0l68je
   created_at: "2019-05-28T16:08:30.938Z"
   name: my-device
   

3. Проверьте, что устройство создалось:

   yc iot device list --registry-name  my-registry
   

   Результат:

   +----------------------+-----------+
   |          ID          |   NAME    |
   +----------------------+-----------+
   | b9135goeh1uc1s2i07nm | my-device |
   +----------------------+-----------+
   

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

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

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

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

Чтобы создать устройство:

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

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

   • yandex_iot_core_device — параметры устройства:
   • registry_id — идентификатор реестра, в котором создается устройство.
   • name — имя устройства.
   • description — описание устройства.
   • aliases — алиасы топиков. Подробнее см. Создание алиаса
   • passwords — список паролей для авторизации с помощью логина и пароля.
   • certificates — список сертификатов для авторизации с помощью сертификатов.

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

   resource "yandex_iot_core_device" "my_device" {
     registry_id = "<идентификатор реестра>"
     name        = "test-device"
     description = "test device for terraform provider documentation"
     
     aliases = {
       "some-alias1/subtopic" = "$devices/{id}/events/somesubtopic",
       "some-alias2/subtopic" = "$devices/{id}/events/aaa/bbb",
     }
     
     passwords = [
       "<пароль>",
     ]
     
     certificates = [
       file("<путь к файлу c сертификатом>")
     ]
   }
   

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

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

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

      terraform plan
      

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

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

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

      terraform apply
      

   2. Подтвердите создание ресурсов.

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

Cоздать устройство можно с помощью метода API create.