Iot Hub Resource - Test All Routes
Testare tutte le route configurate in questo hub Iot
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{iotHubName}/routing/routes/$testall?api-version=2023-06-30
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
iot
|
path | True |
string |
IotHub da testare |
resource
|
path | True |
string |
gruppo di risorse a cui appartiene l'hub Iot |
subscription
|
path | True |
string |
L'identificatore della sottoscrizione. |
api-version
|
query | True |
string |
Versione dell'API. |
Corpo della richiesta
Nome | Tipo | Descrizione |
---|---|---|
message |
Messaggio di routing |
|
routingSource |
Origine di routing |
|
twin |
Informazioni di riferimento sul gemello di routing |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
DefaultErrorResponse |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
Nome | Descrizione |
---|---|
user_impersonation | rappresentare l'account utente |
Esempio
IotHubResource_TestAllRoutes
Esempio di richiesta
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"
}
}
}
Risposta di esempio
{
"routes": [
{
"properties": {
"name": "Routeid",
"source": "DeviceMessages",
"endpointNames": [
"id1"
],
"isEnabled": true
}
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Error |
Dettagli errore. |
Matched |
Route corrispondenti |
Properties | |
Route |
Le proprietà di una regola di routing usata dall'hub IoT per instradare i messaggi agli endpoint. |
Routing |
Messaggio di routing |
Routing |
Origine a cui deve essere applicata la regola di routing, ad esempio DeviceMessages. |
Routing |
Parametro di input del riferimento gemello. Si tratta di un parametro facoltativo |
Test |
Input per il test di tutte le route |
Test |
Risultato del test di tutte le route |
ErrorDetails
Dettagli errore.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore. |
details |
string |
Dettagli dell'errore. |
httpStatusCode |
string |
Codice di stato HTTP. |
message |
string |
Messaggio di errore. |
MatchedRoute
Route corrispondenti
Nome | Tipo | Descrizione |
---|---|---|
properties |
Proprietà delle route corrispondenti |
Properties
Nome | Tipo | Descrizione |
---|---|---|
desired |
object |
Proprietà desiderate del dispositivo gemello |
reported |
object |
Proprietà desiderate del dispositivo gemello |
RouteProperties
Le proprietà di una regola di routing usata dall'hub IoT per instradare i messaggi agli endpoint.
Nome | Tipo | Descrizione |
---|---|---|
condition |
string |
Condizione valutata per applicare la regola di routing. Se non viene fornita alcuna condizione, restituisce true per impostazione predefinita. Per la grammatica, vedere: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language |
endpointNames |
string[] |
Elenco di endpoint a cui vengono indirizzati i messaggi che soddisfano la condizione. Attualmente è consentito un solo endpoint. |
isEnabled |
boolean |
Consente di specificare se una route è abilitata. |
name |
string |
Nome della route. Il nome può includere solo caratteri alfanumerici, punti, caratteri di sottolineatura, trattini, lunghezza massima di 64 caratteri e deve essere univoco. |
source |
Origine a cui deve essere applicata la regola di routing, ad esempio DeviceMessages. |
RoutingMessage
Messaggio di routing
Nome | Tipo | Descrizione |
---|---|---|
appProperties |
object |
Proprietà dell'app |
body |
string |
Corpo del messaggio di routing |
systemProperties |
object |
Proprietà di sistema |
RoutingSource
Origine a cui deve essere applicata la regola di routing, ad esempio DeviceMessages.
Nome | Tipo | Descrizione |
---|---|---|
DeviceConnectionStateEvents |
string |
|
DeviceJobLifecycleEvents |
string |
|
DeviceLifecycleEvents |
string |
|
DeviceMessages |
string |
|
Invalid |
string |
|
TwinChangeEvents |
string |
RoutingTwin
Parametro di input del riferimento gemello. Si tratta di un parametro facoltativo
Nome | Tipo | Descrizione |
---|---|---|
properties | ||
tags |
object |
Tag gemelli |
TestAllRoutesInput
Input per il test di tutte le route
Nome | Tipo | Descrizione |
---|---|---|
message |
Messaggio di routing |
|
routingSource |
Origine di routing |
|
twin |
Informazioni di riferimento sul gemello di routing |
TestAllRoutesResult
Risultato del test di tutte le route
Nome | Tipo | Descrizione |
---|---|---|
routes |
Matrice serializzata JSON di route corrispondenti |