次の方法で共有


az iot hub message-route

Note

このリファレンスは、Azure CLI (バージョン 2.67.0 以降) の azure-iot 拡張機能の一部です。 拡張機能は、az iot hub message-route コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細については、 を参照してください。

このコマンド グループはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

IoT ハブのルートを管理します。

コマンド

名前 説明 状態
az iot hub message-route create

IoT Hub のルートを追加します。

Extension Preview
az iot hub message-route delete

IoT Hub 内のすべてのルートまたは前述のルートを削除します。

Extension Preview
az iot hub message-route fallback

IoT ハブのフォールバック ルートを管理します。

Extension Preview
az iot hub message-route fallback set

IoT Hub でフォールバック ルートを有効または無効にします。

Extension Preview
az iot hub message-route fallback show

IoT Hub のフォールバック ルートを表示します。

Extension Preview
az iot hub message-route list

IoT Hub 内のすべてのルートを取得します。

Extension Preview
az iot hub message-route show

IoT Hub 内のルートに関する情報を取得します。

Extension Preview
az iot hub message-route test

IoT Hub 内のすべてのルートまたは前述のルートをテストします。

Extension Preview
az iot hub message-route update

IoT Hub のルートを更新します。

Extension Preview

az iot hub message-route create

プレビュー

コマンド グループ 'iot hub message-route' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

IoT Hub のルートを追加します。

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

指定されたエンドポイントとソースの種類が "DeviceMessages" の IoT Hub のルートを作成します。

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

組み込みのエンドポイントとソースの種類が "DeviceMessages" の IoT Hub のルートを作成します。

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

指定されたエンドポイント、ソースの種類 "DigitalTwinChangeEvents"、およびカスタム条件を使用して、IoT Hub の無効なルートを作成します。

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

ルーティング エンドポイントの名前。 組み込みエンドポイントの場合は、エンドポイント名 'events' を使用します。

--hub-name -n

IoT Hub 名。

--rn --route --route-name

ルートの名前。

--source-type --type -t

ルートのソース。

プロパティ
指定可能な値: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--condition -c

ルーティング規則を適用するために評価される条件。

プロパティ
規定値: true
--enabled -e

IoT Hub へのルートを有効にするかどうかを示すブール値。

プロパティ
規定値: True
指定可能な値: false, true
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False

az iot hub message-route delete

プレビュー

コマンド グループ 'iot hub message-route' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

IoT Hub 内のすべてのルートまたは前述のルートを削除します。

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

IoT Hub からルートを削除します。

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

ソースの種類 "DeviceMessages" のすべてのルートを IoT Hub から削除します。

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

IoT Hub からすべてのルートを削除します。

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--hub-name -n

IoT Hub 名。

プロパティ
パラメーター グループ: Resource Id Arguments
--ids

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

プロパティ
パラメーター グループ: Resource Id Arguments
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

プロパティ
パラメーター グループ: Resource Id Arguments
--rn --route --route-name

ルートの名前。

--source-type --type -t

ルートのソース。

プロパティ
指定可能な値: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

プロパティ
パラメーター グループ: Resource Id Arguments
--yes -y

ユーザー プロンプトをスキップします。 アクションの受け入れを示します。 主に自動化シナリオに使用されます。 既定値: false。

プロパティ
指定可能な値: false, true
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False

az iot hub message-route list

プレビュー

コマンド グループ 'iot hub message-route' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

IoT Hub 内のすべてのルートを取得します。

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

IoT Hub からすべてのルートを取得します。

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

IoT Hub からソースの種類 "DeviceMessages" のすべてのルートを取得します。

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--hub-name -n

IoT Hub 名。

プロパティ
パラメーター グループ: Resource Id Arguments
--ids

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

プロパティ
パラメーター グループ: Resource Id Arguments
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

プロパティ
パラメーター グループ: Resource Id Arguments
--source-type --type -t

ルートのソース。

プロパティ
指定可能な値: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

プロパティ
パラメーター グループ: Resource Id Arguments
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False

az iot hub message-route show

プレビュー

コマンド グループ 'iot hub message-route' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

IoT Hub 内のルートに関する情報を取得します。

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

IoT Hub からルート情報を取得します。

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

必須のパラメーター

--rn --route --route-name

ルートの名前。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--hub-name -n

IoT Hub 名。

プロパティ
パラメーター グループ: Resource Id Arguments
--ids

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

プロパティ
パラメーター グループ: Resource Id Arguments
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

プロパティ
パラメーター グループ: Resource Id Arguments
--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

プロパティ
パラメーター グループ: Resource Id Arguments
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False

az iot hub message-route test

プレビュー

コマンド グループ 'iot hub message-route' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

IoT Hub 内のすべてのルートまたは前述のルートをテストします。

ルートをテストするためのサンプル メッセージを提供できます。

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

IoT Hub からのルートをテストします。

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

IoT Hub からソースの種類 "DeviceMessages" のすべてのルートをテストします。

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

本文、アプリのプロパティ、システム プロパティなど、カスタム メッセージを使用して IoT Hub からのすべてのルートをテストします。

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

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--ap --app-properties

ルート メッセージのアプリ プロパティ。

--body -b

ルート メッセージの本文。

--hub-name -n

IoT Hub 名。

プロパティ
パラメーター グループ: Resource Id Arguments
--ids

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

プロパティ
パラメーター グループ: Resource Id Arguments
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

プロパティ
パラメーター グループ: Resource Id Arguments
--rn --route --route-name

ルートの名前。

--source-type --type -t

ルートのソース。

プロパティ
指定可能な値: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--sp --system-properties

ルート メッセージのシステム プロパティ。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

プロパティ
パラメーター グループ: Resource Id Arguments
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False

az iot hub message-route update

プレビュー

コマンド グループ 'iot hub message-route' はプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

IoT Hub のルートを更新します。

ルートのソース、エンドポイント、条件、または有効な状態を変更できます。

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

特定のエンドポイントとソースの種類 "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}

必須のパラメーター

--rn --route --route-name

ルートの名前。

オプションのパラメーター

次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。

--condition -c

ルーティング規則を適用するために評価される条件。

--en --endpoint --endpoint-name

ルーティング エンドポイントの名前。 組み込みエンドポイントの場合は、エンドポイント名 'events' を使用します。

--enabled -e

IoT Hub へのルートを有効にするかどうかを示すブール値。

プロパティ
指定可能な値: false, true
--hub-name -n

IoT Hub 名。

プロパティ
パラメーター グループ: Resource Id Arguments
--ids

1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

プロパティ
パラメーター グループ: Resource Id Arguments
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

プロパティ
パラメーター グループ: Resource Id Arguments
--source-type --type -t

ルートのソース。

プロパティ
指定可能な値: deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents
--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

プロパティ
パラメーター グループ: Resource Id Arguments
グローバル パラメーター
--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ
規定値: False
--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: json
指定可能な値: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ
規定値: False