Network Interfaces - Get Effective Route Table

Servizio:: Virtual Networks

Versione API:: 2025-05-01

Ottiene l'applicazione di tutte le tabelle di route a un'interfaccia di rete.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkInterfaces/{networkInterfaceName}/effectiveRouteTable?api-version=2025-05-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
networkInterfaceName	path	True	string	Nome dell'interfaccia di rete.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	EffectiveRouteListResult	L'operazione di Azure è stata completata correttamente.
202 Accepted		Operazione sulle risorse accettata. Intestazioni Location: string Retry-After: integer
Other Status Codes	CloudError	Risposta di errore imprevista.

Nome

Tipo

Descrizione

200 OK

EffectiveRouteListResult

L'operazione di Azure è stata completata correttamente.

202 Accepted

Operazione sulle risorse accettata.

Intestazioni

Location: string
Retry-After: integer

Other Status Codes

CloudError

Risposta di errore imprevista.

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

Show network interface effective route tables

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkInterfaces/nic1/effectiveRouteTable?api-version=2025-05-01

const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Gets all route tables applied to a network interface.
 *
 * @summary Gets all route tables applied to a network interface.
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/Network/stable/2025-05-01/examples/NetworkInterfaceEffectiveRouteTableList.json
 */
async function showNetworkInterfaceEffectiveRouteTables() {
  const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName = process.env["NETWORK_RESOURCE_GROUP"] || "rg1";
  const networkInterfaceName = "nic1";
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const result = await client.networkInterfaces.beginGetEffectiveRouteTableAndWait(
    resourceGroupName,
    networkInterfaceName,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Risposta di esempio

Codice di stato:: 200

{
  "value": [
    {
      "addressPrefix": [
        "172.20.2.0/24"
      ],
      "nextHopIpAddress": [],
      "nextHopType": "VnetLocal",
      "source": "Default",
      "state": "Active"
    },
    {
      "addressPrefix": [
        "0.0.0.0/0"
      ],
      "nextHopIpAddress": [],
      "nextHopType": "Internet",
      "source": "Default",
      "state": "Active"
    },
    {
      "addressPrefix": [
        "10.0.0.0/8"
      ],
      "nextHopIpAddress": [],
      "nextHopType": "None",
      "source": "Default",
      "state": "Active"
    },
    {
      "addressPrefix": [
        "100.64.0.0/10"
      ],
      "nextHopIpAddress": [],
      "nextHopType": "None",
      "source": "Default",
      "state": "Active"
    },
    {
      "addressPrefix": [
        "172.16.0.0/12"
      ],
      "nextHopIpAddress": [],
      "nextHopType": "None",
      "source": "Default",
      "state": "Active"
    },
    {
      "addressPrefix": [
        "192.168.0.0/16"
      ],
      "nextHopIpAddress": [],
      "nextHopType": "None",
      "source": "Default",
      "state": "Active"
    }
  ]
}

Codice di stato:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkInterfaces/nic1/operationResults/00000000-0000-0000-0000-000000000000?api-version=2025-05-01

Definizioni

Nome	Descrizione
CloudError	Risposta di errore dal servizio.
CloudErrorBody	Risposta di errore dal servizio.
EffectiveRoute	Route effettiva.
EffectiveRouteListResult	Risposta per elencare una chiamata al servizio API route efficace.
EffectiveRouteSource	Chi ha creato il percorso.
EffectiveRouteState	Il valore del percorso efficace.
RouteNextHopType	Tipo di hop di Azure a cui inviare il pacchetto.

CloudError

Oggetto

Risposta di errore dal servizio.

Nome	Tipo	Descrizione
error	CloudErrorBody	Corpo dell'errore cloud.

CloudErrorBody

Oggetto

Risposta di errore dal servizio.

Nome	Tipo	Descrizione
code	string	Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
details	CloudErrorBody[]	Un elenco di dettagli aggiuntivi sull'errore.
message	string	Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.
target	string	Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in errore.

EffectiveRoute

Oggetto

Route effettiva.

Nome	Tipo	Descrizione
addressPrefix	string[]	I prefissi degli indirizzi delle route effettive nella notazione CIDR.
disableBgpRoutePropagation	boolean	Se true, le route locali non vengono propagate alle interfacce di rete nella subnet.
name	string	Il nome della route definita dall'utente. Questa opzione è facoltativa.
nextHopIpAddress	string[]	L'indirizzo IP dell'hop successivo della route effettiva.
nextHopType	RouteNextHopType	Tipo di hop di Azure a cui inviare il pacchetto.
source	EffectiveRouteSource	Chi ha creato il percorso.
state	EffectiveRouteState	Il valore del percorso efficace.

EffectiveRouteListResult

Oggetto

Risposta per elencare una chiamata al servizio API route efficace.

Nome	Tipo	Descrizione
nextLink	string (uri)	Collegamento alla pagina successiva di elementi
value	EffectiveRoute[]	Gli elementi EffectiveRoute in questa pagina

EffectiveRouteSource

Enumerazione

Chi ha creato il percorso.

Valore	Descrizione
Unknown	Sconosciuto
User	User
VirtualNetworkGateway	VirtualNetworkGateway
Default	Predefinito

EffectiveRouteState

Enumerazione

Il valore del percorso efficace.

Valore	Descrizione
Active	Active
Invalid	Non valido

RouteNextHopType

Enumerazione

Tipo di hop di Azure a cui inviare il pacchetto.

Valore	Descrizione
VirtualNetworkGateway	VirtualNetworkGateway
VnetLocal	VnetLocal
Internet	Internet
VirtualAppliance	VirtualAppliance
None	Nessuno

Condividi tramite

Network Interfaces - Get Effective Route Table

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Show network interface effective route tables

Esempio di richiesta

Risposta di esempio

Definizioni

CloudError

CloudErrorBody

EffectiveRoute

EffectiveRouteListResult

EffectiveRouteSource

EffectiveRouteState

RouteNextHopType