Express Route Cross Connections - List Routes Table Summary

Serviço:

ExpressRoute

Versão da API:

2025-05-01

Obtém o resumo da tabela de rotas associado à conexão cruzada de rota expressa em um grupo de recursos.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCrossConnections/{crossConnectionName}/peerings/{peeringName}/routeTablesSummary/{devicePath}?api-version=2025-05-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
crossConnectionName	path	True	string	O nome do ExpressRouteCrossConnection (chave de serviço do circuito).
devicePath	path	True	string	O caminho do dispositivo.
peeringName	path	True	string	O nome do emparelhamento.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A 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.

Respostas

Name	Tipo	Description
200 OK	ExpressRouteCrossConnectionsRoutesTableSummaryListResult	Operação do Azure concluída com sucesso.
202 Accepted		Operação de recurso aceita. Cabeçalhos Location: string Retry-After: integer
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

GetExpressRouteCrossConnectionsRouteTableSummary

Pedido de amostra

HTTP

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/CrossConnection-SiliconValley/providers/Microsoft.Network/expressRouteCrossConnections/<circuitServiceKey>/peerings/AzurePrivatePeering/routeTablesSummary/primary?api-version=2025-05-01

JavaScript

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

/**
 * This sample demonstrates how to Gets the route table summary associated with the express route cross connection in a resource group.
 *
 * @summary Gets the route table summary associated with the express route cross connection in a resource group.
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/Network/stable/2025-05-01/examples/ExpressRouteCrossConnectionsRouteTableSummary.json
 */
async function getExpressRouteCrossConnectionsRouteTableSummary() {
  const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName =
    process.env["NETWORK_RESOURCE_GROUP"] || "CrossConnection-SiliconValley";
  const crossConnectionName = "<circuitServiceKey>";
  const peeringName = "AzurePrivatePeering";
  const devicePath = "primary";
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const result = await client.expressRouteCrossConnections.beginListRoutesTableSummaryAndWait(
    resourceGroupName,
    crossConnectionName,
    peeringName,
    devicePath,
  );
  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

Resposta da amostra

Código de estado:

200

{
  "value": [
    {
      "asn": 65514,
      "neighbor": "10.6.1.112",
      "stateOrPrefixesReceived": "Active",
      "upDown": "1d14h"
    },
    {
      "asn": 65514,
      "neighbor": "10.6.1.113",
      "stateOrPrefixesReceived": "1",
      "upDown": "1d14h"
    }
  ]
}

Código de estado:

202

Azure-AsyncOperation: 

Definições

Name	Description
CloudError	Uma resposta de erro do serviço.
CloudErrorBody	Uma resposta de erro do serviço.
ExpressRouteCrossConnectionRoutesTableSummary	A tabela de rotas associada ao ExpressRouteCircuit.
ExpressRouteCrossConnectionsRoutesTableSummaryListResult	Resposta para ListRoutesTable associada às conexões cruzadas de rota expressa.

CloudError

Object

Uma resposta de erro do serviço.

Name	Tipo	Description
error	CloudErrorBody	Corpo do erro na nuvem.

CloudErrorBody

Object

Uma resposta de erro do serviço.

Name	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.
details	CloudErrorBody[]	Uma lista de detalhes adicionais sobre o erro.
message	string	Uma mensagem descrevendo o erro, destinada a ser adequada para exibição em uma interface do usuário.
target	string	O alvo do erro específico. Por exemplo, o nome da propriedade em erro.

ExpressRouteCrossConnectionRoutesTableSummary

Object

A tabela de rotas associada ao ExpressRouteCircuit.

Name	Tipo	Description
asn	integer (int32)	Número do sistema autónomo.
neighbor	string	Endereço IP do roteador vizinho.
stateOrPrefixesReceived	string	Estado atual da sessão BGP e o número de prefixos que foram recebidos de um vizinho ou grupo de pares.
upDown	string	O período de tempo em que a sessão BGP esteve no estado Estabelecido ou o status atual, se não estiver no estado Estabelecido.

ExpressRouteCrossConnectionsRoutesTableSummaryListResult

Object

Resposta para ListRoutesTable associada às conexões cruzadas de rota expressa.

Name	Tipo	Description
nextLink	string (uri)	O link para a próxima página de itens
value	ExpressRouteCrossConnectionRoutesTableSummary[]	Os itens de resumo da ExpressRouteCrossConnectionRoutesTableTab.