次の方法で共有


Iot Hub Resource - Test All Routes

この IoT ハブで構成されているすべてのルートをテストする

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{iotHubName}/routing/routes/$testall?api-version=2023-06-30

URI パラメーター

名前 / 必須 説明
iotHubName
path True

string

テストする IotHub

resourceGroupName
path True

string

IoT Hub が属するリソース グループ

subscriptionId
path True

string

サブスクリプション識別子。

api-version
query True

string

API のバージョン。

要求本文

名前 説明
message

RoutingMessage

ルーティング メッセージ

routingSource

RoutingSource

ルーティング ソース

twin

RoutingTwin

ルーティング ツインリファレンス

応答

名前 説明
200 OK

TestAllRoutesResult

わかりました

Other Status Codes

ErrorDetails

DefaultErrorResponse

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

IotHubResource_TestAllRoutes

要求のサンプル

POST https://management.azure.com/subscriptions/91d12660-3dec-467a-be2a-213b5544ddc0/resourceGroups/myResourceGroup/providers/Microsoft.Devices/IotHubs/testHub/routing/routes/$testall?api-version=2023-06-30

{
  "routingSource": "DeviceMessages",
  "message": {
    "body": "Body of message",
    "appProperties": {
      "key1": "value1"
    },
    "systemProperties": {
      "key1": "value1"
    }
  }
}

応答のサンプル

{
  "routes": [
    {
      "properties": {
        "name": "Routeid",
        "source": "DeviceMessages",
        "endpointNames": [
          "id1"
        ],
        "isEnabled": true
      }
    }
  ]
}

定義

名前 説明
ErrorDetails

エラーの詳細。

MatchedRoute

一致したルート

Properties
RouteProperties

IoT ハブがエンドポイントにメッセージをルーティングするために使用するルーティング規則のプロパティ。

RoutingMessage

ルーティング メッセージ

RoutingSource

ルーティング規則を適用するソース (DeviceMessages など)。

RoutingTwin

ツイン参照入力パラメーター。 これは省略可能なパラメーターです

TestAllRoutesInput

すべてのルートをテストするための入力

TestAllRoutesResult

すべてのルートをテストした結果

ErrorDetails

エラーの詳細。

名前 説明
code

string

エラー コード。

details

string

エラーの詳細。

httpStatusCode

string

HTTP 状態コード。

message

string

エラー メッセージ。

MatchedRoute

一致したルート

名前 説明
properties

RouteProperties

一致したルートのプロパティ

Properties

名前 説明
desired

object

両方の望ましい特性

reported

object

両方の望ましい特性

RouteProperties

IoT ハブがエンドポイントにメッセージをルーティングするために使用するルーティング規則のプロパティ。

名前 説明
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

RoutingSource

ルーティング規則を適用するソース (DeviceMessages など)。

RoutingMessage

ルーティング メッセージ

名前 説明
appProperties

object

アプリのプロパティ

body

string

ルーティング メッセージの本文

systemProperties

object

システム プロパティ

RoutingSource

ルーティング規則を適用するソース (DeviceMessages など)。

説明
DeviceConnectionStateEvents
DeviceJobLifecycleEvents
DeviceLifecycleEvents
DeviceMessages
Invalid
TwinChangeEvents

RoutingTwin

ツイン参照入力パラメーター。 これは省略可能なパラメーターです

名前 説明
properties

Properties

tags

object

ツイン タグ

TestAllRoutesInput

すべてのルートをテストするための入力

名前 説明
message

RoutingMessage

ルーティング メッセージ

routingSource

RoutingSource

ルーティング ソース

twin

RoutingTwin

ルーティング ツインリファレンス

TestAllRoutesResult

すべてのルートをテストした結果

名前 説明
routes

MatchedRoute[]

一致したルートの JSON シリアル化された配列