Reachability Analysis Runs - List

Usługa:: Virtual Networks

Wersja interfejsu API:: 2025-05-01

Pobiera listę przebiegów analizy osiągalności.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/verifierWorkspaces/{workspaceName}/reachabilityAnalysisRuns?api-version=2025-05-01

Z parametrami opcjonalnymi:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkManagers/{networkManagerName}/verifierWorkspaces/{workspaceName}/reachabilityAnalysisRuns?api-version=2025-05-01&skipToken={skipToken}&skip={skip}&top={top}&sortKey={sortKey}&sortValue={sortValue}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
networkManagerName	path	True	string pattern: ^[0-9a-zA-Z]([0-9a-zA-Z_.-]{0,62}[0-9a-zA-Z_])?$	Nazwa menedżera sieci.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
workspaceName	path	True	string pattern: ^[0-9a-zA-Z]([0-9a-zA-Z_.-]{0,62}[0-9a-zA-Z_])?$	Nazwa zasobu
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.
skip	query		integer (int32)	Opcjonalne wpisy liczby do pominięcia.
skipToken	query		string	Opcjonalny token pomijania.
sortKey	query		string	Klucz opcjonalny do sortowania.
sortValue	query		string	Opcjonalna wartość sortowania dla stronicowania.
top	query		integer (int32)	Opcjonalne wpisy liczby do pokazania.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ReachabilityAnalysisRunListResult	Operacja platformy Azure została zakończona pomyślnie.
Other Status Codes	CommonErrorResponse	Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

ReachabilityAnalysisRunList

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/verifierWorkspaces/testVerifierWorkspace1/reachabilityAnalysisRuns?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 list of Reachability Analysis Runs.
 *
 * @summary Gets list of Reachability Analysis Runs.
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/Network/stable/2025-05-01/examples/ReachabilityAnalysisRunList.json
 */
async function reachabilityAnalysisRunList() {
  const subscriptionId =
    process.env["NETWORK_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["NETWORK_RESOURCE_GROUP"] || "rg1";
  const networkManagerName = "testNetworkManager";
  const workspaceName = "testVerifierWorkspace1";
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (const item of client.reachabilityAnalysisRuns.list(
    resourceGroupName,
    networkManagerName,
    workspaceName,
  )) {
    resArray.push(item);
  }
  console.log(resArray);
}

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

Przykładowa odpowiedź

Kod stanu:: 200

{
  "nextLink": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/verifierWorkspaces/testVerifierWorkspace1/reachabilityAnalysisRuns?api-version=2025-05-01&$skipToken=10",
  "value": [
    {
      "name": "testReachabilityAnalysisRun1",
      "type": "Microsoft.Network/networkManagers/verifierWorkspaces/reachabilityAnalysisRuns",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/verifierWorkspaces/testVerifierWorkspace1/reachabilityAnalysisRuns/testReachabilityAnalysisRun1",
      "properties": {
        "description": "A sample  reachability analysis intent",
        "intentContent": {
          "destinationResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/virtualMachines/testVmDest",
          "ipTraffic": {
            "destinationIps": [
              "10.4.0.1"
            ],
            "destinationPorts": [
              "0"
            ],
            "protocols": [
              "Any"
            ],
            "sourceIps": [
              "10.4.0.0"
            ],
            "sourcePorts": [
              "0"
            ]
          },
          "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Compute/virtualMachines/testVmSrc"
        },
        "intentId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/networkManagers/testNetworkManager/verifierWorkspaces/testVerifierWorkspace1/reachabilityAnalysisIntents/testReachabilityAnalysisIntenant1",
        "provisioningState": "Succeeded"
      },
      "systemData": {
        "createdAt": "2021-01-11T18:52:27Z",
        "createdBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
        "createdByType": "User",
        "lastModifiedAt": "2021-01-11T18:52:27Z",
        "lastModifiedBy": "b69a9388-9488-4534-b470-7ec6d41beef5",
        "lastModifiedByType": "User"
      }
    }
  ]
}

Definicje

Nazwa	Opis
CommonErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
CommonErrorDetail	Szczegóły błędu.
CommonErrorResponse	Odpowiedź na błąd
createdByType	Typ tożsamości, która utworzyła zasób.
IntentContent	Informacje o intencji.
IPTraffic	Informacje o ruchu IP.
NetworkProtocol	Protokół sieciowy.
ProvisioningState	Stany aprowizacji zasobu.
ReachabilityAnalysisRun	Informacje o konfiguracji przebiegu analizy.
ReachabilityAnalysisRunListResult	Odpowiedź operacji listy ReachabilityAnalysisRun.
ReachabilityAnalysisRunProperties	Reprezentuje właściwości uruchomienia analizy osiągalności.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

CommonErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info		Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

CommonErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	CommonErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	CommonErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

CommonErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	CommonErrorDetail	Obiekt błędu.

createdByType

Wyliczenie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

IntentContent

Objekt

Informacje o intencji.

Nazwa	Typ	Opis
description	string
destinationResourceId	string (arm-id)	Identyfikator zasobu docelowego intencji.
ipTraffic	IPTraffic	Informacje o ruchu IP.
sourceResourceId	string (arm-id)	Identyfikator zasobu źródłowego intencji.

IPTraffic

Objekt

Informacje o ruchu IP.

Nazwa	Typ	Opis
destinationIps	string[]	Lista docelowych adresów IP ruchu.
destinationPorts	string[]	Porty docelowe ruchu.
protocols	NetworkProtocol[]	Protokół sieciowy.
sourceIps	string[]	Lista źródłowych adresów IP ruchu.
sourcePorts	string[]	Porty źródłowe ruchu.

NetworkProtocol

Wyliczenie

Protokół sieciowy.

Wartość	Opis
Any	Jakikolwiek
TCP	TCP
UDP	protokół UDP
ICMP	ICMP

ProvisioningState

Wyliczenie

Stany aprowizacji zasobu.

Wartość	Opis
Failed	Niepowodzenie
Succeeded	Powodzenie
Canceled	Anulowane
Creating	Tworzenie
Updating	Aktualizowanie
Deleting	Usuwanie