Iot Hub Resource - Test All Routes
Testar todas as rotas configuradas neste Hub Iot
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Devices/IotHubs/{iotHubName}/routing/routes/$testall?api-version=2026-11-01
Parâmetros do URI
| Nome | Em | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
iot
|
path | True |
string |
|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não faz distinção entre maiúsculas e minúsculas. |
|
subscription
|
path | True |
string (uuid) |
O ID da assinatura de destino. O valor deve ser um UUID. |
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a utilizar para esta operação. |
Corpo do Pedido
| Nome | Tipo | Descrição |
|---|---|---|
| message |
Mensagem de roteamento |
|
| routingSource |
Origem do roteamento |
|
| twin |
Referência de gêmeos de roteamento |
Respostas
| Nome | Tipo | Descrição |
|---|---|---|
| 200 OK |
Operação do Azure concluída com sucesso. |
|
| Other Status Codes |
Uma resposta de erro inesperada. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory.
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
| Nome | Descrição |
|---|---|
| user_impersonation | assumir a identidade da sua conta de utilizador |
Exemplos
IotHubResource_TestAllRoutes
Pedido de amostra
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"
}
Resposta da amostra
{
"routes": [
{
"properties": {
"name": "Routeid",
"endpointNames": [
"id1"
],
"isEnabled": true,
"source": "DeviceMessages"
}
}
]
}
Definições
| Nome | Descrição |
|---|---|
|
Error |
Detalhes do erro. |
|
Matched |
Rotas que corresponderam |
|
Route |
As propriedades de uma regra de roteamento que seu hub IoT usa para rotear mensagens para pontos de extremidade. |
|
Routing |
Mensagem de roteamento |
|
Routing |
A origem à qual a regra de roteamento deve ser aplicada, como DeviceMessages. |
|
Routing |
Parâmetro de entrada de referência dupla. Este é um parâmetro opcional |
|
Routing |
|
|
Test |
Entrada para testar todas as rotas |
|
Test |
Resultado do teste de todas as rotas |
ErrorDetails
Detalhes do erro.
| Nome | Tipo | Descrição |
|---|---|---|
| code |
string |
O código de erro. |
| details |
string |
Os detalhes do erro. |
| httpStatusCode |
string |
O código de status HTTP. |
| message |
string |
A mensagem de erro. |
MatchedRoute
Rotas que corresponderam
| Nome | Tipo | Descrição |
|---|---|---|
| properties |
Propriedades de rotas que correspondem |
RouteProperties
As propriedades de uma regra de roteamento que seu hub IoT usa para rotear mensagens para pontos de extremidade.
| Nome | Tipo | Descrição |
|---|---|---|
| condition |
string |
A condição que é avaliada para aplicar a regra de roteamento. Se nenhuma condição for fornecida, ela será avaliada como true por padrão. Para gramática, consulte: https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language |
| endpointNames |
string[] |
A lista de pontos de extremidade para os quais as mensagens que satisfazem a condição são encaminhadas. Atualmente, apenas um ponto de extremidade é permitido. |
| isEnabled |
boolean |
Usado para especificar se uma rota está habilitada. |
| name |
string pattern: ^[A-Za-z0-9-._]{1,64}$ |
O nome da rota. O nome só pode incluir caracteres alfanuméricos, pontos, sublinhados hífenes, tem um comprimento máximo de 64 caracteres e deve ser exclusivo. |
| source |
A origem à qual a regra de roteamento deve ser aplicada, como DeviceMessages. |
RoutingMessage
Mensagem de roteamento
| Nome | Tipo | Descrição |
|---|---|---|
| appProperties |
object |
Propriedades do aplicativo |
| body |
string |
Corpo da mensagem de roteamento |
| systemProperties |
object |
Propriedades do sistema |
RoutingSource
A origem à qual a regra de roteamento deve ser aplicada, como DeviceMessages.
| Valor | Descrição |
|---|---|
| Invalid |
Inválido |
| DeviceMessages |
DeviceMessages |
| TwinChangeEvents |
TwinChangeEvents |
| DeviceLifecycleEvents |
DeviceLifecycleEvents |
| DeviceJobLifecycleEvents |
DeviceJobLifecycleEvents |
| DeviceConnectionStateEvents |
DeviceConnectionStateEvents |
RoutingTwin
Parâmetro de entrada de referência dupla. Este é um parâmetro opcional
| Nome | Tipo | Descrição |
|---|---|---|
| properties | ||
| tags |
Tags gêmeas |
RoutingTwinProperties
| Nome | Tipo | Descrição |
|---|---|---|
| desired |
Propriedades desejadas gêmeas |
|
| reported |
Propriedades reportadas por gémeos |
TestAllRoutesInput
Entrada para testar todas as rotas
| Nome | Tipo | Descrição |
|---|---|---|
| message |
Mensagem de roteamento |
|
| routingSource |
Origem do roteamento |
|
| twin |
Referência de gêmeos de roteamento |
TestAllRoutesResult
Resultado do teste de todas as rotas
| Nome | Tipo | Descrição |
|---|---|---|
| routes |
Matriz serializada por JSON de rotas correspondentes |