Получение информации об устройстве
Чтобы узнать уникальный идентификатор или имя устройства, получите список устройств в реестре.
Получить список устройств в реестре
Если вы не знаете уникальный идентификатор или имя реестра, в котором находится ваше устройство, посмотрите список существующих реестров.
- В консоли управления
выберите каталог, в котором находится реестр. - Выберите сервис IoT Core.
- Выберите реестр.
- Перейдите на вкладку Устройства.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --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. Вы можете указать другой каталог с помощью параметра --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.