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

CLI

Terraform

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

Посмотрите список реестров, в которых можно создать устройство, или создайте новый реестр.
Создайте устройство:
```
$ 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 позволяет быстро создать облачную инфраструктуру в Яндекс.Облаке. Состав инфраструктуры определяется с помощью конфигурационных файлов, в которых указываются требуемые облачные ресурсы и их параметры.

Если у вас ещё нет Terraform, установите его и настройте провайдер Яндекс.Облака.

Примечание

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

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

Посмотрите список реестров, в которых можно создать устройство, или создайте новый реестр.
Опишите в конфигурационном файле параметры ресурса, который необходимо создать:
- 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. Подтвердите создание ресурсов.
После этого в указанном каталоге будут созданы все требуемые ресурсы. Проверить появление ресурсов и их настройки можно в консоли управления.