Iot Hub Resource - Test Route
この Iot Hub の新しいルートをテストする
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{iotHubName}/routing/routes/$testnew?api-version=2026-11-01
URI パラメーター
| Name | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
iot
|
path | True |
string |
|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
リソース グループの名前。 名前は大文字と小文字を区別しません。 |
|
subscription
|
path | True |
string (uuid) |
ターゲット サブスクリプションの ID。 値は UUID である必要があります。 |
|
api-version
|
query | True |
string minLength: 1 |
この操作に使用する API バージョン。 |
要求本文
| Name | 必須 | 型 | 説明 |
|---|---|---|---|
| route | True |
ルートのプロパティ |
|
| message |
メッセージのルーティング |
||
| twin |
ルーティング ツイン リファレンス |
応答
| Name | 型 | 説明 |
|---|---|---|
| 200 OK |
Azureの運用は無事に完了しました。 |
|
| Other Status Codes |
予期しないエラー応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー。
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
| Name | 説明 |
|---|---|
| user_impersonation | あなたのユーザー アカウントになりすます |
例
IotHubResource_TestRoute
要求のサンプル
POST https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub/routing/routes/$testnew?api-version=2026-11-01
{
"message": {
"appProperties": {
"key1": "value1"
},
"body": "Body of message",
"systemProperties": {
"key1": "value1"
}
},
"route": {
"name": "Routeid",
"endpointNames": [
"id1"
],
"isEnabled": true,
"source": "DeviceMessages"
}
}
応答のサンプル
{
"result": "false",
"details": {
"compilationErrors": [
{
"location": {
"end": {
"column": 24,
"line": 12
},
"start": {
"column": 12,
"line": 12
}
},
"message": "string response",
"severity": "error"
}
]
}
}
定義
| Name | 説明 |
|---|---|
|
Error |
エラーの詳細。 |
|
Route |
ルート評価時のコンパイルエラー |
|
Route |
ルートエラーが発生した位置 |
|
Route |
ルートエラーの範囲 |
|
Route |
ルートエラーの重大度 |
|
Route |
IoT ハブがエンドポイントにメッセージをルーティングするために使用するルーティング規則のプロパティ。 |
|
Routing |
メッセージのルーティング |
|
Routing |
ルーティング規則を適用するソース (DeviceMessages など)。 |
|
Routing |
ツイン参照入力パラメーター。 これはオプションのパラメーターです |
|
Routing |
|
|
Test |
テストルートの結果 |
|
Test |
テストルートの入力 |
|
Test |
1つのルートをテストした結果 |
|
Test |
ルートテストの詳細な結果 |
ErrorDetails
エラーの詳細。
| Name | 型 | 説明 |
|---|---|---|
| code |
string |
エラー コード。 |
| details |
string |
エラーの詳細。 |
| httpStatusCode |
string |
HTTP 状態コード。 |
| message |
string |
エラー メッセージ。 |
RouteCompilationError
ルート評価時のコンパイルエラー
| Name | 型 | 説明 |
|---|---|---|
| location |
ルートエラーが発生した場所 |
|
| message |
string |
ルートエラーメッセージ |
| severity |
ルートエラーの重大度 |
RouteErrorPosition
ルートエラーが発生した位置
| Name | 型 | 説明 |
|---|---|---|
| column |
integer (int32) |
ルートエラーが発生した列 |
| line |
integer (int32) |
ルートエラーが発生したライン |
RouteErrorRange
ルートエラーの範囲
| Name | 型 | 説明 |
|---|---|---|
| end |
ルートエラーが発生した場所の終了 |
|
| start |
ルートエラーが発生した場所から開始 |
RouteErrorSeverity
ルートエラーの重大度
| 値 | 説明 |
|---|---|
| error |
エラー |
| warning |
警告 |
RouteProperties
IoT ハブがエンドポイントにメッセージをルーティングするために使用するルーティング規則のプロパティ。
| Name | 型 | 説明 |
|---|---|---|
| condition |
string |
ルーティング規則を適用するために評価される条件。 条件が指定されていない場合は、既定で true に評価されます。 文法については、以下を参照してください。 https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language |
| endpointNames |
string[] |
条件を満たすメッセージがルーティングされるエンドポイントの一覧。 現在、許可されているエンドポイントは 1 つだけです。 |
| isEnabled |
boolean |
ルートを有効にするかどうかを指定するために使用します。 |
| name |
string pattern: ^[A-Za-z0-9-._]{1,64}$ |
ルートの名前。 名前には、英数字、ピリオド、アンダースコア、ハイフンのみを含めることができます。最大長は 64 文字で、一意である必要があります。 |
| source |
ルーティング規則を適用するソース (DeviceMessages など)。 |
RoutingMessage
メッセージのルーティング
| Name | 型 | 説明 |
|---|---|---|
| appProperties |
object |
アプリのプロパティ |
| body |
string |
ルーティング メッセージの本文 |
| systemProperties |
object |
System properties (システムのプロパティ) |
RoutingSource
ルーティング規則を適用するソース (DeviceMessages など)。
| 値 | 説明 |
|---|---|
| Invalid |
無効です |
| DeviceMessages |
デバイスメッセージ |
| TwinChangeEvents |
ツインチェンジイベント |
| DeviceLifecycleEvents |
デバイスライフサイクルイベント |
| DeviceJobLifecycleEvents |
デバイスジョブライフサイクルイベント |
| DeviceConnectionStateEvents |
デバイス接続状態イベント |
RoutingTwin
ツイン参照入力パラメーター。 これはオプションのパラメーターです
| Name | 型 | 説明 |
|---|---|---|
| properties | ||
| tags |
ツインタグ |
RoutingTwinProperties
| Name | 型 | 説明 |
|---|---|---|
| desired |
ツインの望ましいプロパティ |
|
| reported |
ツインレポートプロパティ |
TestResultStatus
テストルートの結果
| 値 | 説明 |
|---|---|
| undefined |
未定義 |
| false |
false |
| true |
true |
TestRouteInput
テストルートの入力
| Name | 型 | 説明 |
|---|---|---|
| message |
メッセージのルーティング |
|
| route |
ルートのプロパティ |
|
| twin |
ルーティング ツイン リファレンス |
TestRouteResult
1つのルートをテストした結果
| Name | 型 | 説明 |
|---|---|---|
| details |
テストルートの詳細な結果 |
|
| result |
テストルートの結果 |
TestRouteResultDetails
ルートテストの詳細な結果
| Name | 型 | 説明 |
|---|---|---|
| compilationErrors |
ルートコンパイルエラーの JSON シリアル化されたリスト |