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
iotHubName
path True

string

IotHub da testare

resourceGroupName
path True

string

gruppo di risorse a cui appartiene l'hub Iot

subscriptionId
path True

string

L'identificatore della sottoscrizione.

api-version
query True

string

Versione dell'API.

Corpo della richiesta

Nome Tipo Descrizione
message

RoutingMessage

Messaggio di routing

routingSource

RoutingSource

Origine di routing

twin

RoutingTwin

Informazioni di riferimento sul gemello di routing

Risposte

Nome Tipo Descrizione
200 OK

TestAllRoutesResult

OK

Other Status Codes

ErrorDetails

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
ErrorDetails

Dettagli errore.

MatchedRoute

Route corrispondenti

Properties
RouteProperties

Le proprietà di una regola di routing usata dall'hub IoT per instradare i messaggi agli endpoint.

RoutingMessage

Messaggio di routing

RoutingSource

Origine a cui deve essere applicata la regola di routing, ad esempio DeviceMessages.

RoutingTwin

Parametro di input del riferimento gemello. Si tratta di un parametro facoltativo

TestAllRoutesInput

Input per il test di tutte le route

TestAllRoutesResult

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

RouteProperties

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

RoutingSource

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

Properties

tags

object

Tag gemelli

TestAllRoutesInput

Input per il test di tutte le route

Nome Tipo Descrizione
message

RoutingMessage

Messaggio di routing

routingSource

RoutingSource

Origine di routing

twin

RoutingTwin

Informazioni di riferimento sul gemello di routing

TestAllRoutesResult

Risultato del test di tutte le route

Nome Tipo Descrizione
routes

MatchedRoute[]

Matrice serializzata JSON di route corrispondenti