Подключиться
Yandex IoT Core

Подписка устройства или реестра на получение сообщений

Вы можете подписать:

  • Реестр на события устройства, используя топики $devices/<ID устройства>/events или $registries/<ID реестра>/events.
  • Устройство на команды реестра, используя топики $devices/<ID устройства>/commands или $registries/<ID реестра>/commands.

О том, как обмениваться сообщениями, читайте в разделе Отправка сообщения.

Важно

Топик реестра и топик устройства не связаны между собой. Если устройство отправляет данные в топик устройства для телеметрических данных, получить их можно только подписавшись на этот топик. Аналогично для топика реестра.

Перед началом

Подготовьте ресурсы, необходимые для начала работы:

  1. (опционально) Создайте сертификаты для реестра и устройства.
  2. Создайте реестр.
  3. Добавьте сертификат реестру.
  4. Создайте устройство.
  5. Добавьте сертификат устройству.

Авторизация

Чтобы отправлять сообщения, необходимо пройти авторизацию. Для этого используйте X.509-сертификат или логин и пароль. В данном разделе приведены примеры для обоих способов авторизации.

Подписать реестр на устройство

Реестр можно подписать на одно, несколько или все устройства, добавленные в него.

Примечание

Если в процессе выполнения команды у вас возникла ошибка, добавьте к команде флаг --debug и попробуйте еще раз. Данный флаг выводит журнал отладки при выполнении команды, что помогает при диагностике проблемы.

Подпишите реестр на одно устройство

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

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

  • Подпишите реестр, используя сертификат:

    $ yc iot mqtt subscribe \
--cert registry-cert.pem \
--key registry-key.pem \
--topic '$devices/<ID устройства>/events' \
--qos 1

    Где:

    • --cert и --key — параметры для авторизации с помощью сертификата.
    • --topic — топик устройства для отправки данных.
    • --message — текст сообщения.
    • --qos — уровень качества обслуживания (QoS).

  • Подпишите реестр, используя логин и пароль:

    $ yc iot mqtt subscribe \
--username <ID реестра> \
--password <пароль для реестра> \
--topic '$devices/<ID устройства>/events' \
--qos 1

    Где:

    • --username и --password — параметры для авторизации с помощью логина и пароля.
    • --topic — топик устройства для отправки данных.
    • --message — текст сообщения.
    • --qos — уровень качества обслуживания (QoS).

Подпишите реестр на все устройства, добавленные в него

Реестр будет получать данные только от тех устройств, которые отправляют сообщения в топик $registries/<ID реестра>/events.

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

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

  • Подпишите реестр, используя сертификат:

    $ yc iot mqtt subscribe \
--cert registry-cert.pem \
--key registry-key.pem \
--topic '$registries/<ID реестра>/events' \
--qos 1

    Где:

  • Подпишите реестр, используя логин и пароль:

    $ yc iot mqtt subscribe \
--username <ID реестра> \
--password <пароль для реестра> \
--topic '$registries/<ID реестра>/events' \
--qos 1

    Где:

    • --username и --password — параметры для авторизации с помощью логина и пароля.
    • --topic — топик реестра для получения данных.
    • --message — текст сообщения.
    • --qos — уровень качества обслуживания (QoS).

Подписать устройство на реестр

Команды от реестра могут предназначаться конкретному устройству или всем устройствам в реестре. Для этого используются разные топики.

Примечание

Если в процессе выполнения команды у вас возникла ошибка, добавьте к команде флаг --debug и попробуйте еще раз. Данный флаг выводит журнал отладки при выполнении команды, что помогает при диагностике проблемы.

Подпишите устройство на команды для конкретного устройства

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

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

  • Подпишите устройство на команды для конкретного устройства:

    • Используя сертификат:

      yc iot mqtt subscribe \
--cert device-cert.pem \
--key device-key.pem \
--topic '$devices/<ID устройства>/commands' \
--qos 1

      Где:

      • --cert и --key — параметры для авторизации с помощью сертификата.
      • --topic — топик устройства для получения команд.
      • --message — текст сообщения.
      • --qos — уровень качества обслуживания (QoS).

    • Используя логин и пароль:

      yc iot mqtt subscribe \
--username <ID устройства> \
--password <пароль для устройства> \
--topic '$devices/<ID устройства>/commands' \
--qos 1

      Где:

      • --username и --password — параметры для авторизации с помощью логина и пароля.
      • --topic — топик устройства для получения команд.
      • --message — текст сообщения.
      • --qos — уровень качества обслуживания (QoS).

Подпишите устройство на команды для всех устройств

Команды будут получать только устройства, подписанные на топик $registries/<ID реестра>/commands.

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

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

  • Подпишите устройство, используя сертификат:

    $ yc iot mqtt subscribe \
--cert device-cert.pem \
--key device-key.pem \
--topic '$registries/<ID реестра>/commands' \
--qos 1

    Где:

  • Подпишите устройство, используя логин и пароль:

    $ yc iot mqtt subscribe \
--username <ID устройства> \
--password <пароль для устройства> \
--topic '$registries/<ID реестра>/commands' \
--qos 1

    Где:

    • --username и --password — параметры для авторизации с помощью логина и пароля.
    • --topic — топик реестра для отправки команд.
    • --message — текст сообщения.
    • --qos — уровень качества обслуживания (QoS).