Iot Hub Resource - Test All Routes

Usługa:: IoT Hub

Wersja interfejsu API:: 2026-11-01

Testowanie wszystkich tras skonfigurowanych w tej usłudze IoT Hub

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

Parametry identyfikatora URI

Nazwisko	W	Wymagane	Typ	Opis
iotHubName	path	True	string
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwisko	Typ	Opis
message	RoutingMessage	Komunikat routingu
routingSource	RoutingSource	Źródło routingu
twin	RoutingTwin	Odwołanie do bliźniaczej reprezentacji routingu

Odpowiedzi

Nazwisko	Typ	Opis
200 OK	TestAllRoutesResult	Operacja Azure zakończyła się pomyślnie.
Other Status Codes	ErrorDetails	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwisko	Opis
user_impersonation	podszywaj się pod konto użytkownika

Przykłady

IotHubResource_TestAllRoutes

Przykładowe żądanie

HTTP

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

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

Przykładowa odpowiedź

Kod stanu:: 200

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

Definicje

Nazwisko	Opis
ErrorDetails	Szczegóły błędu.
MatchedRoute	Trasy, które pasowały do siebie
RouteProperties	Właściwości reguły routingu używanej przez centrum IoT Hub do kierowania komunikatów do punktów końcowych.
RoutingMessage	Komunikat routingu
RoutingSource	Źródłem, do którego ma być zastosowana reguła routingu, na przykład DeviceMessages.
RoutingTwin	Parametr wejściowy odwołania do podwójnej reprezentacji. Jest to parametr opcjonalny
RoutingTwinProperties
TestAllRoutesInput	Dane wejściowe do testowania wszystkich tras
TestAllRoutesResult	Wynik testowania wszystkich tras

ErrorDetails

Objekt

Szczegóły błędu.

Nazwisko	Typ	Opis
code	string	Kod błędu.
details	string	Szczegóły błędu.
httpStatusCode	string	Kod statusu HTTP.
message	string	Komunikat o błędzie.

MatchedRoute

Objekt

Trasy, które pasowały do siebie

Nazwisko	Typ	Opis
properties	RouteProperties	Właściwości pasujących tras

RouteProperties

Objekt

Właściwości reguły routingu używanej przez centrum IoT Hub do kierowania komunikatów do punktów końcowych.

Nazwisko	Typ	Opis
condition	string	Warunek, który jest obliczany w celu zastosowania reguły routingu. Jeśli nie podano warunku, wartość jest domyślnie obliczana na wartość true. Aby zapoznać się z gramatyką, zobacz: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language
endpointNames	string[]	Lista punktów końcowych, do których są kierowane komunikaty spełniające warunek. Obecnie dozwolony jest tylko jeden punkt końcowy.
isEnabled	boolean	Służy do określania, czy trasa jest włączona.
name	string pattern: ^[A-Za-z0-9-._]{1,64}$	Nazwa trasy. Nazwa może zawierać tylko znaki alfanumeryczne, kropki, podkreślenia, łączniki, ma maksymalną długość 64 znaków i musi być unikatowa.
source	RoutingSource	Źródłem, do którego ma być zastosowana reguła routingu, na przykład DeviceMessages.

RoutingMessage

Objekt

Komunikat routingu

Nazwisko	Typ	Opis
appProperties	object	Właściwości aplikacji
body	string	Treść komunikatu routingu
systemProperties	object	Właściwości systemu

RoutingSource

Wyliczenie

Źródłem, do którego ma być zastosowana reguła routingu, na przykład DeviceMessages.

Wartość	Opis
Invalid	Nieprawidłowy
DeviceMessages	Komunikaty urządzenia
TwinChangeEvents	Wydarzenia TwinChangeWydarzenia
DeviceLifecycleEvents	ZdarzeniaCykluŻyciaUrządzenia
DeviceJobLifecycleEvents	DeviceJobLifecycleEvents
DeviceConnectionStateEvents	DeviceConnectionStateEvents

RoutingTwin

Objekt

Parametr wejściowy odwołania do podwójnej reprezentacji. Jest to parametr opcjonalny

Nazwisko	Typ	Opis
properties	RoutingTwinProperties
tags		Bliźniacze tagi

RoutingTwinProperties

Objekt

Nazwisko	Typ	Opis
desired		Pożądane właściwości bliźniaka
reported		Bliźniacze zgłaszane właściwości

TestAllRoutesInput

Objekt

Dane wejściowe do testowania wszystkich tras

Nazwisko	Typ	Opis
message	RoutingMessage	Komunikat routingu
routingSource	RoutingSource	Źródło routingu
twin	RoutingTwin	Odwołanie do bliźniaczej reprezentacji routingu

TestAllRoutesResult

Objekt

Wynik testowania wszystkich tras

Nazwisko	Typ	Opis
routes	MatchedRoute[]	Serializowana tablica dopasowanych tras w formacie JSON