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

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

CLI

Terraform

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

В консоли управления выберите каталог, в котором вы хотите создать устройство.
Выберите сервис Yandex IoT Core.
Выберите в списке нужный реестр.
В левой части окна выберите раздел Устройства.
Нажмите кнопку Добавить устройство.
Задайте Базовые параметры устройства:
- Введите Имя устройства. Например, my-device.
- (опционально) Добавьте Описание с дополнительной информацией об устройстве.
- Задайте Пароль, который вы будете использовать для доступа к устройству.
  Для создания пароля можно воспользоваться генератором паролей.
  Не забудьте сохранить пароль, он вам понадобится.
(опционально) Добавьте алиасы:
1. Нажмите кнопку Добавить алиас.
2. Заполните поля: введите алиас (например, events) и тип топика после $devices/<deviceID> (например, events).
  Вы сможете использовать алиас events вместо топика $devices/<deviceID>/events.
(опционально) Добавьте сертификаты:
- Чтобы добавить файл:
  1. Выберите способ Файл.
  2. Нажмите Выбрать файл.
  3. Укажите файл сертификата на вашем компьютере, нажмите Открыть.
  4. Нажмите Добавить.
- Чтобы добавить текст:
  1. Выберите способ Текст.
  2. Вставьте тело сертификата в поле Содержимое.
  3. Нажмите Добавить.
Нажмите кнопку Добавить.

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

Посмотрите список реестров, в которых можно создать устройство, или создайте новый реестр.
Создайте устройство:
```
$ yc iot device create --registry-name my-registry --name my-device

id: b9135goeh1uc1s2i07nm
registry_id: b91ki3851hab9m0l68je
created_at: "2019-05-28T16:08:30.938Z"
name: my-device
```
- Длина — от 3 до 63 символов.
- Может содержать строчные буквы латинского алфавита, цифры и дефисы.
- Первый символ — буква. Последний символ — не дефис.

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

$ yc iot device list --registry-name  my-registry
+----------------------+-----------+
|          ID          |   NAME    |
+----------------------+-----------+
| b9135goeh1uc1s2i07nm | my-device |
+----------------------+-----------+

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

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

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

Примечание

Чтобы добавить сертификаты устройству, подготовьте их заранее.

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

Посмотрите список реестров, в которых можно создать устройство, или создайте новый реестр.
Опишите в конфигурационном файле параметры ресурса, который необходимо создать:
- 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, см. в документации провайдера.
Проверьте корректность конфигурационных файлов.
1. В командной строке перейдите в папку, где вы создали конфигурационный файл.
2. Выполните проверку с помощью команды:
```
$ terraform plan
```
Если конфигурация описана верно, в терминале отобразится список создаваемых ресурсов и их параметров. Если в конфигурации есть ошибки, Terraform на них укажет.
Разверните облачные ресурсы.
1. Если в конфигурации нет ошибок, выполните команду:
```
$ terraform apply
```
2. Подтвердите создание ресурсов.
После этого в указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в консоли управления.