Yandex Cloud
  • Сервисы
  • Решения
  • Почему Yandex Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Language / Region
© 2022 ООО «Яндекс.Облако»
Yandex IoT Core
  • Начало работы
  • Пошаговые инструкции
    • Все инструкции
    • Отправка сообщения
    • Подписка устройства или реестра на получение сообщений
    • Просмотр журнала подключений
    • Создание триггера для топика
    • Управление реестрами
      • Получение информации о реестре
      • Создание реестра
      • Изменение реестра
      • Удаление реестра
    • Управление устройствами
      • Управление алиасами топиков
        • Создание алиаса
        • Получение списка алиасов
        • Изменение алиаса
        • Удаление алиаса
      • Получение информации об устройстве
      • Создание устройства
      • Изменение устройства
      • Удаление устройства
    • Управление сертификатами
      • Создание сертификата
      • Управление сертификатами реестра
      • Управление сертификатами устройства
    • Управление паролями
      • Управление паролями реестра
      • Управление паролями устройства
  • Концепции
    • Авторизация
    • Взаимосвязь ресурсов сервиса
    • Параметры подключения MQTT-брокера
    • Отправка сообщений MQTT-брокеру через gRPC
    • Топик
      • Обзор
      • Топики устройства
      • Топики реестра
      • Сабтопик
      • Использование топиков
    • Резервное копирование
    • Квоты и лимиты
  • Практические руководства
    • Все руководства
    • Работа с помощью Mosquitto
      • Отправить сообщение
      • Подписать устройство или реестр на получение сообщений
    • Работа с Yandex IoT Core с устройства с Android на языке Java
    • Работа с Yandex IoT Core на языке C#
    • Работа с Yandex IoT Core на языке Java
    • Запись данных с устройства в Managed Service for PostgreSQL
  • Управление доступом
  • Правила тарификации
  • Справочник API
    • Аутентификация в API
    • gRPC (англ.)
      • Overview
      • DeviceDataService
      • DeviceService
      • RegistryDataService
      • RegistryService
      • OperationService
    • REST (англ.)
      • Overview
      • DeviceData
        • Overview
        • publish
      • Device
        • Overview
        • addCertificate
        • addPassword
        • create
        • delete
        • deleteCertificate
        • deletePassword
        • get
        • getByName
        • list
        • listCertificates
        • listOperations
        • listPasswords
        • update
      • RegistryData
        • Overview
        • publish
      • Registry
        • Overview
        • addCertificate
        • addPassword
        • create
        • delete
        • deleteCertificate
        • deletePassword
        • get
        • getByName
        • list
        • listCertificates
        • listDeviceTopicAliases
        • listOperations
        • listPasswords
        • update
  • Вопросы и ответы
  1. Пошаговые инструкции
  2. Управление устройствами
  3. Управление алиасами топиков
  4. Создание алиаса

Создание алиаса

Статья создана
Yandex Cloud

    Алиас привязан к конкретному устройству, поэтому для создания алиаса вам надо узнать идентификатор или имя устройства.

    Примечание

    Для топика $monitoring/<ID устройства>/json можно использовать только системный алиас $me.

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

    Чтобы создать алиас:

    1. В консоли управления выберите каталог, в котором вы хотите создать алиас.
    2. Выберите сервис Yandex IoT Core.
    3. Выберите в списке нужный реестр.
    4. В левой части окна выберите раздел Устройства.
    5. Нажмите значок справа от имени нужного устройства, в выпадающем списке выберите Редактировать.
    6. Добавьте алиас:
      1. Нажмите кнопку Добавить алиас.
      2. Заполните поля: введите алиас (например, events) и тип топика после $devices/<deviceID> (например, events).
        Вы сможете использовать алиас events вместо топика $devices/<deviceID>/events.
      3. Повторите действия для каждого добавляемого алиаса.
    7. Нажмите кнопку Сохранить.

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

    По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

    Создайте алиас:

    yc iot device add-topic-aliases arenak5ciqss6pbas6js
      --topic-aliases commands='$devices/arenak5ciqss6pbas6js/commands'
    
    Результат:
    
    id: arenak5ciqss6pbas6js
    registry_id: arenou2oj4ct42eq8g3n
    created_at: "2019-09-16T12:32:48.911Z"
    name: second
    topic_aliases:
      commands: $devices/arenak5ciqss6pbas6js/commands
    

    Также вы можете добавить алиас при создании устройства. Для этого вместо уникального идентификатора в топике устройства указывается {id}, так как уникальный идентификатор еще неизвестен:

    yc iot device create 
      --registry-name <имя_реестра> 
      --name <имя_устройства> 
      --topic-aliases <имя_алиаса>='$devices/{id}/<events,_state,_commands_или_config>'
    

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

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

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

    Подробнее о Terraform читайте в документации.

    Чтобы добавить алиас устройству, созданному с помощью Terraform:

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

      • yandex_iot_core_device — параметры устройства:
        • registry_id — идентификатор реестра, в котором создано устройство.
        • name — имя устройства.
        • description — описание устройства.
        • aliases — алиасы топиков.

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

      resource "yandex_iot_core_device" "my_device" {
        registry_id = "<идентификатор_реестра>"
        name        = "<имя_устройства>"
        description = "test device for terraform provider documentation"
      
        aliases = {
          "some-alias1/subtopic" = "$devices/{id}/events/somesubtopic",
          "some-alias2/subtopic" = "$devices/{id}/events/aaa/bbb",
        }
      ...
      }
      

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

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

    3. Проверьте корректность конфигурационного файла с помощью команды:

      terraform validate
      

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.
      
    4. Выполните команду:

      terraform plan
      

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

    5. Примените изменения конфигурации:

      terraform apply
      
    6. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

      Проверить алиасы устройства можно в консоли управления или с помощью команды CLI:

      yc iot device get <имя_устройства>
      

    Была ли статья полезна?

    Language / Region
    © 2022 ООО «Яндекс.Облако»