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
必須のパラメーター
ルーティング エンドポイントの名前。 組み込みエンドポイントの場合は、エンドポイント名 'events' を使用します。
IoT Hub 名。
ルートの名前。
ルートのソース。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents |
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
ルーティング規則を適用するために評価される条件。
| プロパティ | 値 |
|---|---|
| 規定値: | true |
IoT Hub へのルートを有効にするかどうかを示すブール値。
| プロパティ | 値 |
|---|---|
| 規定値: | True |
| 指定可能な値: | false, true |
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
ログの詳細度を高める。 完全なデバッグ ログには --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 つ以上が必要になる場合があります。
IoT Hub 名。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
ルートの名前。
ルートのソース。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents |
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
ユーザー プロンプトをスキップします。 アクションの受け入れを示します。 主に自動化シナリオに使用されます。 既定値: false。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | false, true |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --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 つ以上が必要になる場合があります。
IoT Hub 名。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
ルートのソース。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents |
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --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}
必須のパラメーター
ルートの名前。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
IoT Hub 名。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --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 つ以上が必要になる場合があります。
ルート メッセージのアプリ プロパティ。
ルート メッセージの本文。
IoT Hub 名。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
ルートの名前。
ルートのソース。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents |
ルート メッセージのシステム プロパティ。
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --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}
必須のパラメーター
ルートの名前。
オプションのパラメーター
次のパラメーターは省略可能ですが、コマンドを正常に実行するには、状況に応じて 1 つ以上が必要になる場合があります。
ルーティング規則を適用するために評価される条件。
ルーティング エンドポイントの名前。 組み込みエンドポイントの場合は、エンドポイント名 'events' を使用します。
IoT Hub へのルートを有効にするかどうかを示すブール値。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | false, true |
IoT Hub 名。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
1 つ以上のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
リソース グループの名前。
az configure --defaults group=<name>を使用して既定のグループを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
ルートのソース。
| プロパティ | 値 |
|---|---|
| 指定可能な値: | deviceconnectionstateevents, devicejoblifecycleevents, devicelifecycleevents, devicemessages, digitaltwinchangeevents, invalid, twinchangeevents |
サブスクリプションの名前または ID。
az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。
| プロパティ | 値 |
|---|---|
| パラメーター グループ: | Resource Id Arguments |
グローバル パラメーター
ログの詳細度を上げて、すべてのデバッグ ログを表示します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告を抑制します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |
出力フォーマット。
| プロパティ | 値 |
|---|---|
| 規定値: | json |
| 指定可能な値: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。
ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。
| プロパティ | 値 |
|---|---|
| 規定値: | False |