Получение информации об устройстве
Чтобы узнать уникальный идентификатор или имя устройства, получите список устройств в реестре.
Получить список устройств в реестре
Если вы не знаете уникальный идентификатор или имя реестра, в котором находится ваше устройство, посмотрите список существующих реестров.
- В консоли управления
выберите каталог, в котором находится реестр. - Выберите сервис IoT Core.
- Выберите реестр.
- Перейдите на вкладку Устройства.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.
-
Посмотрите описание команды CLI для получения списка устройств:
yc iot device list --help -
Получите список устройств в реестре, указав его имя или идентификатор:
yc iot device list --registry-name <имя_реестра>Результат:
+----------------------+-----------+ | ID | NAME | +----------------------+-----------+ | b9135goeh1uc******** | my-device | +----------------------+-----------+
Чтобы получить список устройств в реестре, воспользуйтесь методом REST API list для ресурса Device или вызовом gRPC API DeviceService/List.
Получить информацию об устройстве
Для обращения к устройству используйте уникальный идентификатор или имя реестра из предыдущего пункта.
- В консоли управления
выберите каталог, в котором находится устройство. - Выберите сервис IoT Core.
- Выберите реестр, в котором находится устройство.
- Перейдите на вкладку Устройства.
- Выберите устройство.
- На странице Обзор отобразится подробная информация об устройстве.
Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.
По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.
-
Посмотрите описание команды CLI для получения информации об устройстве:
yc iot device get --help -
Получите подробную информацию об устройстве, указав его имя или идентификатор:
yc iot device get <имя_устройства>Результат:
id: b9135goeh1uc******** registry_id: b91ki3851hab******** created_at: "2019-05-28T16:08:30.938Z" name: my-device
Terraform
Terraform распространяется под лицензией Business Source License
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Чтобы получить подробную информацию об устройстве с помощью Terraform:
-
Добавьте в конфигурационный файл Terraform блоки
dataиoutput:data "yandex_iot_core_device" "my_device" { device_id = "<идентификатор_устройства>" } output "device_params" { value = data.yandex_iot_core_device.my_device.registry_id }Где:
data "yandex_iot_core_device"— описание устройства в качестве источника данных:device_id— идентификатор устройства.
output "device_params"— выходная переменная, которая содержит информацию о реестре, которому принадлежит устройство:value— возвращаемое значение.
Вместо
registry_idвы можете выбрать любой другой параметр для получения информации. Более подробно о параметрах источника данныхyandex_iot_core_deviceсм. в документации провайдера. -
Создайте ресурсы:
-
В терминале перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validateЕсли конфигурация является корректной, появится сообщение:
Success! The configuration is valid. -
Выполните команду:
terraform planВ терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply -
Подтвердите изменения: введите в терминале слово
yesи нажмите Enter.
Terraform создаст все требуемые ресурсы и отобразит значения выходных переменных в терминале. Чтобы проверить результат, выполните команду:
terraform outputРезультат:
device_params = "are7ajlrf493********" -
Чтобы получить подробную информацию об устройстве, воспользуйтесь методом REST API get для ресурса Device или вызовом gRPC API DeviceService/Get.
Данные мониторинга устройства обновляются при обращении к устройству с помощью gRPCS и по MQTT. Уровень качества обслуживания — at most once.