Поделиться через

az iot hub message-route

  • Предварительный просмотр
  • Ссылка

Примечание.

Эта ссылка является частью расширения Azure-iot для Azure CLI (версия 2.46.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az iot hub message-route . Подробнее о расширениях.

Эта группа команд находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Управление маршрутами Центра Интернета вещей.

Команды

Имя Описание Тип Состояние
az iot hub message-route create

Добавьте маршрут для Центр Интернета вещей.

 Расширение Предварительный просмотр
az iot hub message-route delete

Удалите все маршруты или упомянутый маршрут в Центр Интернета вещей.

 Расширение Предварительный просмотр
az iot hub message-route fallback

Управление резервным маршрутом Центра Интернета вещей.

 Расширение Предварительный просмотр
az iot hub message-route fallback set

Включите или отключите резервный маршрут в Центр Интернета вещей.

 Расширение Предварительный просмотр
az iot hub message-route fallback show

Отображение резервного маршрута Центр Интернета вещей.

 Расширение Предварительный просмотр
az iot hub message-route list

Получите все маршруты в Центр Интернета вещей.

 Расширение Предварительный просмотр
az iot hub message-route show

Получение сведений о маршруте в Центр Интернета вещей.

 Расширение Предварительный просмотр
az iot hub message-route test

Проверьте все маршруты или упомянутый маршрут в Центр Интернета вещей.

 Расширение Предварительный просмотр
az iot hub message-route update

Обновите маршрут для Центр Интернета вещей.

 Расширение Предварительный просмотр

az iot hub message-route create

Предварительный просмотр

Группа команд iot hub message-route находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Добавьте маршрут для Центр Интернета вещей.

az iot hub message-route create --en
                                --hub-name
                                --rn
                                --source-type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}
                                [--condition]
                                [--enabled {false, true}]
                                [--resource-group]

Примеры

Создайте маршрут для Центр Интернета вещей с заданной конечной точкой и типом источника DeviceMessages.

az iot hub message-route create -n {iothub_name} --route-name {route_name} --endpoint-name {endpoint_name} --source DeviceMessages

Создайте маршрут для Центр Интернета вещей со встроенной конечной точкой и типом источника DeviceMessages.

az iot hub message-route create -n {iothub_name} --route-name {route_name} --endpoint-name events --source DeviceMessages

Создайте отключенный маршрут для Центр Интернета вещей с заданной конечной точкой, тип источника DigitalTwinChangeEvents и настраиваемое условие.

az iot hub message-route create -n {iothub_name} --route-name {route_name} --endpoint-name {endpoint_name} --source DigitalTwinChangeEvents --condition {condition} --enabled false

Обязательные параметры

--en --endpoint --endpoint-name

Имя конечной точки маршрутизации. Для встроенной конечной точки используйте имя конечной точки "события".

--hub-name -n

Центр Интернета вещей имя.

--rn --route --route-name

Имя маршрута.

--source-type --type -t

Источник маршрута.

Допустимые значения: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents

Необязательные параметры

--condition -c

Условие, которое оценивается для применения правила маршрутизации.

Default value: true
--enabled -e

Логическое значение, указывающее, следует ли включить маршрут к Центр Интернета вещей.

Допустимые значения: false, true
Default value: True
--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az iot hub message-route delete

Предварительный просмотр

Группа команд iot hub message-route находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Удалите все маршруты или упомянутый маршрут в Центр Интернета вещей.

az iot hub message-route delete --hub-name
                                [--resource-group]
                                [--rn]
                                [--source-type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]
                                [--yes {false, true}]

Примеры

Удалите маршрут из Центр Интернета вещей.

az iot hub message-route delete -n {iothub_name} --route-name {route_name}

Удалите все маршруты исходного типа DeviceMessages из Центр Интернета вещей.

az iot hub message-route delete -n {iothub_name} --source DeviceMessages

Удалите все маршруты из Центр Интернета вещей.

az iot hub message-route delete -n {iothub_name}

Обязательные параметры

--hub-name -n

Центр Интернета вещей имя.

Необязательные параметры

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--rn --route --route-name

Имя маршрута.

--source-type --type -t

Источник маршрута.

Допустимые значения: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--yes -y

Пропустить запросы пользователей. Указывает на принятие действия. Используется в основном для сценариев автоматизации. По умолчанию: false.

Допустимые значения: false, true
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az iot hub message-route list

Предварительный просмотр

Группа команд iot hub message-route находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Получите все маршруты в Центр Интернета вещей.

az iot hub message-route list --hub-name
                              [--resource-group]
                              [--source-type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]

Примеры

Получите все маршруты из Центр Интернета вещей.

az iot hub message-route list -n {iothub_name}

Получите все маршруты исходного типа DeviceMessages из Центр Интернета вещей.

az iot hub message-route list -n {iothub_name} --source DeviceMessages

Обязательные параметры

--hub-name -n

Центр Интернета вещей имя.

Необязательные параметры

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--source-type --type -t

Источник маршрута.

Допустимые значения: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az iot hub message-route show

Предварительный просмотр

Группа команд iot hub message-route находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Получение сведений о маршруте в Центр Интернета вещей.

az iot hub message-route show --hub-name
                              --rn
                              [--resource-group]

Примеры

Получение сведений о маршруте из Центр Интернета вещей.

az iot hub message-route show -n {iothub_name} --route-name {route_name}

Обязательные параметры

--hub-name -n

Центр Интернета вещей имя.

--rn --route --route-name

Имя маршрута.

Необязательные параметры

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az iot hub message-route test

Предварительный просмотр

Группа команд iot hub message-route находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Проверьте все маршруты или упомянутый маршрут в Центр Интернета вещей.

Вы можете предоставить пример сообщения для тестирования маршрутов.

az iot hub message-route test --hub-name
                              [--ap]
                              [--body]
                              [--resource-group]
                              [--rn]
                              [--source-type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]
                              [--sp]

Примеры

Проверьте маршрут из Центр Интернета вещей.

az iot hub message-route test -n {iothub_name} --route-name {route_name}

Проверьте все маршруты исходного типа DeviceMessages из Центр Интернета вещей.

az iot hub message-route test -n {iothub_name} --source DeviceMessages

Проверьте весь маршрут из Центр Интернета вещей с помощью настраиваемого сообщения, включая текст, свойства приложения и системные свойства.

az iot hub message-route test -n {iothub_name} -b {body} --ap {app_properties} --sp {system_properties}

Обязательные параметры

--hub-name -n

Центр Интернета вещей имя.

Необязательные параметры

--ap --app-properties

Свойства приложения сообщения маршрута.

--body -b

Текст сообщения маршрута.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--rn --route --route-name

Имя маршрута.

--source-type --type -t

Источник маршрута.

Допустимые значения: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--sp --system-properties

Системные свойства сообщения маршрута.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az iot hub message-route update

Предварительный просмотр

Группа команд iot hub message-route находится в предварительной версии и в процессе разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Обновите маршрут для Центр Интернета вещей.

Вы можете изменить исходное состояние, конечную точку, условие или состояние включено в маршруте.

az iot hub message-route update --hub-name
                                --rn
                                [--condition]
                                [--en]
                                [--enabled {false, true}]
                                [--resource-group]
                                [--source-type {deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents}]

Примеры

Обновите маршрут до заданной конечной точки и типа источника DeviceMessages.

az iot hub message-route update -n {iothub_name} --route-name {route_name} --endpoint-name {endpoint_name} --source DeviceMessages

Отключите маршрут.

az iot hub message-route update -n {iothub_name} --route-name {route_name} --enabled false

Изменение условия маршрута.

az iot hub message-route update -n {iothub_name} --route-name {route_name} --condition {condition}

Обязательные параметры

--hub-name -n

Центр Интернета вещей имя.

--rn --route --route-name

Имя маршрута.

Необязательные параметры

--condition -c

Условие, которое оценивается для применения правила маршрутизации.

--en --endpoint --endpoint-name

Имя конечной точки маршрутизации. Для встроенной конечной точки используйте имя конечной точки "события".

--enabled -e

Логическое значение, указывающее, следует ли включить маршрут к Центр Интернета вещей.

Допустимые значения: false, true
--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--source-type --type -t

Источник маршрута.

Допустимые значения: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.