Reachability Analysis Runs - List

Service:

Virtual Networks

API-versie:

2025-05-01

Haalt een lijst op met uitvoeringen voor bereikbaarheidsanalyses.

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

Met optionele parameters:

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}

URI-parameters

Name	In	Vereist	Type	Description
networkManagerName	path	True	string pattern: ^[0-9a-zA-Z]([0-9a-zA-Z_.-]{0,62}[0-9a-zA-Z_])?$	De naam van de netwerkbeheerder.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
workspaceName	path	True	string pattern: ^[0-9a-zA-Z]([0-9a-zA-Z_.-]{0,62}[0-9a-zA-Z_])?$	De naam van de resource
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.
skip	query		integer (int32)	Optionele getalitems om over te slaan.
skipToken	query		string	Optioneel skip-token.
sortKey	query		string	Optionele sleutel waarop u wilt sorteren.
sortValue	query		string	Optionele sorteerwaarde voor paginering.
top	query		integer (int32)	Optionele getalitems die moeten worden weergegeven.

Antwoorden

Name	Type	Description
200 OK	ReachabilityAnalysisRunListResult	Azure-operatie succesvol voltooid.
Other Status Codes	CommonErrorResponse	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

ReachabilityAnalysisRunList

Voorbeeldaanvraag

HTTP

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

JavaScript

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

Voorbeeldrespons

Statuscode:

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"
      }
    }
  ]
}

Definities

Name	Description
CommonErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
CommonErrorDetail	De foutdetails.
CommonErrorResponse	Foutreactie
createdByType	Het type identiteit waarmee de resource is gemaakt.
IntentContent	Intentie-informatie.
IPTraffic	IP-verkeersinformatie.
NetworkProtocol	Netwerk protocol.
ProvisioningState	Inrichtingsstatussen van een resource.
ReachabilityAnalysisRun	Configuratie-informatie voor analyseuitvoering.
ReachabilityAnalysisRunListResult	De reactie van een ReachabilityAnalysisRun-lijstoperatie.
ReachabilityAnalysisRunProperties	Vertegenwoordigt de eigenschappen van de uitvoering van de bereikbaarheidsanalyse.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

CommonErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info		De aanvullende informatie.
type	string	Het extra informatietype.

CommonErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	CommonErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	CommonErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

CommonErrorResponse

Object

Foutreactie

Name	Type	Description
error	CommonErrorDetail	Het foutobject.

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

IntentContent

Object

Intentie-informatie.

Name	Type	Description
description	string
destinationResourceId	string (arm-id)	Doelresource-id van de intentie.
ipTraffic	IPTraffic	IP-verkeersinformatie.
sourceResourceId	string (arm-id)	Bronbron-id van de intentie.

IPTraffic

Object

IP-verkeersinformatie.

Name	Type	Description
destinationIps	string[]	Lijst met doel-IP-adressen van het verkeer..
destinationPorts	string[]	De doelpoorten van het verkeer.
protocols	NetworkProtocol[]	Netwerk protocol.
sourceIps	string[]	Lijst met bron-IP-adressen van het verkeer..
sourcePorts	string[]	De bronpoorten van het verkeer.

NetworkProtocol

Opsomming

Netwerk protocol.

Waarde	Description
Any	Welke dan ook
TCP	TCP
UDP	UDP (User Datagram Protocol)
ICMP	ICMP

ProvisioningState

Opsomming

Inrichtingsstatussen van een resource.

Waarde	Description
Failed	Mislukt
Succeeded	Geslaagd
Canceled	Geannuleerd
Creating	Creëren
Updating	Bijwerken
Deleting	Verwijderen

ReachabilityAnalysisRun

Object

Configuratie-informatie voor analyseuitvoering.

Name	Type	Description
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
name	string	De naam van de resource
properties	ReachabilityAnalysisRunProperties	Vertegenwoordigt de eigenschappen van de uitvoering van de bereikbaarheidsanalyse.
systemData	systemData	De systeemmetagegevens die betrekking hebben op deze resource.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ReachabilityAnalysisRunListResult

Object

De reactie van een ReachabilityAnalysisRun-lijstoperatie.

Name	Type	Description
nextLink	string (uri)	De koppeling naar de volgende pagina met items
value	ReachabilityAnalysisRun[]	De ReachabilityAnalysisRun-items op deze pagina

ReachabilityAnalysisRunProperties

Object

Vertegenwoordigt de eigenschappen van de uitvoering van de bereikbaarheidsanalyse.

Name	Type	Description
analysisResult	string
description	string
errorMessage	string
intentContent	IntentContent	Intentie-informatie.
intentId	string	Id van de intentiebron om analyse op uit te voeren.
provisioningState	ProvisioningState	Inrichtingsstatussen van een resource.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	Het tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.