Reachability Analysis Runs - List

Service:: Virtual Networks

Version d'API:: 2025-05-01

Obtient la liste des exécutions d’analyse d’accessibilité.

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

Avec des paramètres facultatifs:

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}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
networkManagerName	path	True	string pattern: ^[0-9a-zA-Z]([0-9a-zA-Z_.-]{0,62}[0-9a-zA-Z_])?$	Nom du gestionnaire de réseau.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
workspaceName	path	True	string pattern: ^[0-9a-zA-Z]([0-9a-zA-Z_.-]{0,62}[0-9a-zA-Z_])?$	Nom de la ressource
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.
skip	query		integer (int32)	Entrées num facultatives à ignorer.
skipToken	query		string	Jeton d’ignorer facultatif.
sortKey	query		string	Clé facultative par laquelle trier.
sortValue	query		string	Valeur de tri facultative pour la pagination.
top	query		integer (int32)	Entrées num facultatives à afficher.

Réponses

Nom	Type	Description
200 OK	ReachabilityAnalysisRunListResult	Opération Azure terminée avec succès.
Other Status Codes	CommonErrorResponse	Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

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

Exemple de réponse

Code d’état:: 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"
      }
    }
  ]
}

Définitions

Nom	Description
CommonErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
CommonErrorDetail	Détail de l’erreur.
CommonErrorResponse	Réponse d’erreur
createdByType	Type d’identité qui a créé la ressource.
IntentContent	Informations sur l’intention.
IPTraffic	Informations sur le trafic IP.
NetworkProtocol	Protocole réseau.
ProvisioningState	États de provisionnement d’une ressource.
ReachabilityAnalysisRun	Informations de configuration pour l’exécution de l’analyse.
ReachabilityAnalysisRunListResult	La réponse d’une opération de liste ReachabilityAnalysisRun.
ReachabilityAnalysisRunProperties	Représente les propriétés de l’exécution de l’analyse d’accessibilité.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

CommonErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info		Informations supplémentaires.
type	string	Type d’informations supplémentaire.

CommonErrorDetail

Objet

Détail de l’erreur.

Nom	Type	Description
additionalInfo	CommonErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	CommonErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

CommonErrorResponse

Objet

Réponse d’erreur

Nom	Type	Description
error	CommonErrorDetail	Objet d’erreur.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

IntentContent

Objet

Informations sur l’intention.

Nom	Type	Description
description	string
destinationResourceId	string (arm-id)	ID de ressource de destination de l’intention.
ipTraffic	IPTraffic	Informations sur le trafic IP.
sourceResourceId	string (arm-id)	Identifiant de la ressource source de l’intention.

IPTraffic

Objet

Informations sur le trafic IP.

Nom	Type	Description
destinationIps	string[]	Liste des adresses IP de destination du trafic..
destinationPorts	string[]	Ports de destination du trafic.
protocols	NetworkProtocol[]	Protocole réseau.
sourceIps	string[]	Liste des adresses IP sources du trafic..
sourcePorts	string[]	Ports sources du trafic.

NetworkProtocol

Énumération

Protocole réseau.

Valeur	Description
Any	N'importe lequel
TCP	TCP
UDP	UDP
ICMP	ICMP

ProvisioningState

Énumération

États de provisionnement d’une ressource.

Valeur	Description
Failed	Échec
Succeeded	Réussi
Canceled	Opération annulée
Creating	Création
Updating	Mise à jour
Deleting	Suppression