Freigeben über


Network Virtual Appliances - Get

Ruft die angegebene virtuelle Netzwerk-Appliance ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkVirtualAppliances/{networkVirtualApplianceName}?api-version=2024-05-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/networkVirtualAppliances/{networkVirtualApplianceName}?api-version=2024-05-01&$expand={$expand}

URI-Parameter

Name In Erforderlich Typ Beschreibung
networkVirtualApplianceName
path True

string

Der Name der virtuellen Netzwerk-Appliance.

resourceGroupName
path True

string

Der Name der Ressourcengruppe.

subscriptionId
path True

string

Die Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

api-version
query True

string

Client-API-Version.

$expand
query

string

Erweitert referenzierte Ressourcen.

Antworten

Name Typ Beschreibung
200 OK

NetworkVirtualAppliance

Anforderung erfolgreich. Der Vorgang gibt eine Ressource der virtuellen Netzwerkanwendung zurück.

Other Status Codes

CloudError

Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel ihres Benutzerkontos

Beispiele

Get NetworkVirtualAppliance

Beispielanforderung

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkVirtualAppliances/nva?api-version=2024-05-01

Beispiel für eine Antwort

{
  "name": "nva",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkVirtualAppliances/nva",
  "type": "Microsoft.Network/networkVirtualAppliances",
  "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
  "location": "West US",
  "tags": {
    "key1": "value1"
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "/subscriptions/subid/resourcegroups/rg1/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identity1": {}
    }
  },
  "properties": {
    "nvaSku": {
      "vendor": "Cisco SDWAN",
      "bundledScaleUnit": "1",
      "marketPlaceVersion": "12.1"
    },
    "addressPrefix": "192.168.1.0/16",
    "virtualHub": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/hub1"
    },
    "virtualApplianceSites": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networtkVirtualAppliances/nva/virtualApplianceSites/site1"
      }
    ],
    "inboundSecurityRules": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkVirtualAppliances/nva/InboundSecurityRules/rule1"
      }
    ],
    "virtualApplianceConnections": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/networkVirtualAppliances/nva/networkVirtualApplianceConnections/connection1"
      }
    ],
    "provisioningState": "Succeeded",
    "bootStrapConfigurationBlobs": [
      "https://csrncvhdstorage1.blob.core.windows.net/csrncvhdstoragecont/csrbootstrapconfig"
    ],
    "cloudInitConfigurationBlobs": [
      "https://csrncvhdstorage1.blob.core.windows.net/csrncvhdstoragecont/csrcloudinitconfig"
    ],
    "virtualApplianceAsn": 10000,
    "additionalNics": [
      {
        "name": "exrsdwan",
        "hasPublicIp": true
      }
    ],
    "internetIngressPublicIps": [
      {
        "id": "/subscriptions/{{subscriptionId}}/resourceGroups/{{rg}}/providers/Microsoft.Network/publicIPAddresses/slbip"
      }
    ],
    "networkProfile": {
      "networkInterfaceConfigurations": [
        {
          "type": "PublicNic",
          "properties": {
            "ipConfigurations": [
              {
                "name": "publicnicipconfig",
                "properties": {
                  "primary": true
                }
              },
              {
                "name": "publicnicipconfig-2",
                "properties": {
                  "primary": false
                }
              }
            ]
          }
        },
        {
          "type": "PrivateNic",
          "properties": {
            "ipConfigurations": [
              {
                "name": "privatenicipconfig",
                "properties": {
                  "primary": true
                }
              },
              {
                "name": "privatenicipconfig-2",
                "properties": {
                  "primary": false
                }
              }
            ]
          }
        }
      ]
    },
    "virtualApplianceNics": [
      {
        "nicType": "PublicNic",
        "name": "publicnicipconfig",
        "publicIpAddress": "40.30.2.2",
        "privateIpAddress": "192.168.12.1",
        "instanceName": "nva_0"
      },
      {
        "nicType": "PublicNic",
        "name": "publicnicipconfig-2",
        "publicIpAddress": "40.30.2.3",
        "privateIpAddress": "192.168.12.2",
        "instanceName": "nva_0"
      },
      {
        "nicType": "PrivateNic",
        "name": "privatenicipconfig",
        "publicIpAddress": "",
        "privateIpAddress": "192.168.12.3",
        "instanceName": "nva_0"
      },
      {
        "nicType": "PrivateNic",
        "name": "privatenicipconfig-2",
        "publicIpAddress": "",
        "privateIpAddress": "192.168.12.4",
        "instanceName": "nva_0"
      },
      {
        "nicType": "AdditionalNic",
        "name": "exrsdwan",
        "publicIpAddress": "4.231.25.19",
        "privateIpAddress": "10.1.113.4",
        "instanceName": "nva_0"
      }
    ]
  }
}

Definitionen

Name Beschreibung
CloudError

Eine Fehlerantwort des Diensts.

CloudErrorBody

Eine Fehlerantwort des Diensts.

DelegationProperties

Eigenschaften der Delegierung.

InternetIngressPublicIpsProperties

Internet Ingress Public IP-Eigenschaften

ManagedServiceIdentity

Identität für die Ressource.

NetworkProfile

Netzwerkprofil mit Konfigurationen für öffentliche und private NIC.

NetworkVirtualAppliance

NetworkVirtualAppliance-Ressource.

NicTypeInRequest

NIC-Typ. Dies sollte entweder PublicNic oder PrivateNic sein.

NicTypeInResponse

NIC-Typ – PublicNic, PrivateNic oder AdditionalNic.

PartnerManagedResourceProperties

Eigenschaften der vom Partner verwalteten Ressource.

ProvisioningState

Der aktuelle Bereitstellungsstatus.

ResourceIdentityType

Der Identitätstyp, der für die Ressource verwendet wird. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten vom virtuellen Computer.

SubResource

Verweisen auf eine andere Unterressource.

UserAssignedIdentities

Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

VirtualApplianceAdditionalNicProperties

Zusätzliche Nic-Eigenschaften der virtuellen Netzwerkanwendung

VirtualApplianceIPConfiguration

Stellt eine einzelne IP-Konfiguration dar.

VirtualApplianceIPConfigurationProperties

Stellt eine einzelne IP-Konfigurationseigenschaften dar.

VirtualApplianceNetworkInterfaceConfiguration

Stellt eine einzelne NIC-Konfiguration dar.

VirtualApplianceNetworkInterfaceConfigurationProperties

Stellt eine einzelne NIC-Konfigurationseigenschaften dar.

VirtualApplianceNicProperties

Netzwerk virtual Appliance NIC-Eigenschaften.

VirtualApplianceSkuProperties

Sku-Eigenschaften der virtuellen Netzwerkanwendung.

CloudError

Eine Fehlerantwort des Diensts.

Name Typ Beschreibung
error

CloudErrorBody

Cloudfehlertext.

CloudErrorBody

Eine Fehlerantwort des Diensts.

Name Typ Beschreibung
code

string

Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.

details

CloudErrorBody[]

Eine Liste mit zusätzlichen Details zum Fehler.

message

string

Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.

target

string

Das Ziel des bestimmten Fehlers. Beispielsweise der Name der Eigenschaft im Fehler.

DelegationProperties

Eigenschaften der Delegierung.

Name Typ Beschreibung
provisioningState

ProvisioningState

Der aktuelle Bereitstellungsstatus.

serviceName

string

Der Dienstname, an den die NVA delegiert wird.

InternetIngressPublicIpsProperties

Internet Ingress Public IP-Eigenschaften

Name Typ Beschreibung
id

string

Ressourcen-URI der öffentlichen IP

ManagedServiceIdentity

Identität für die Ressource.

Name Typ Beschreibung
principalId

string

Die Prinzipal-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt.

tenantId

string

Die Mandanten-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt.

type

ResourceIdentityType

Der Identitätstyp, der für die Ressource verwendet wird. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten vom virtuellen Computer.

userAssignedIdentities

UserAssignedIdentities

Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

NetworkProfile

Netzwerkprofil mit Konfigurationen für öffentliche und private NIC.

Name Typ Beschreibung
networkInterfaceConfigurations

VirtualApplianceNetworkInterfaceConfiguration[]

Stellt eine einzelne NIC-Konfiguration dar.

NetworkVirtualAppliance

NetworkVirtualAppliance-Ressource.

Name Typ Beschreibung
etag

string

Eine eindeutige schreibgeschützte Zeichenfolge, die sich ändert, wenn die Ressource aktualisiert wird.

id

string

Ressourcen-ID.

identity

ManagedServiceIdentity

Der Dienstprinzipal, der Lesezugriff auf cloudinit und config blob hat.

location

string

Ressourcenspeicherort.

name

string

Ressourcenname.

properties.additionalNics

VirtualApplianceAdditionalNicProperties[]

Details, die für die zusätzliche Netzwerkschnittstelle erforderlich sind.

properties.addressPrefix

string

Adresspräfix.

properties.bootStrapConfigurationBlobs

string[]

BootStrapConfigurationBlobs-Speicher-URLs.

properties.cloudInitConfiguration

string

CloudInitConfiguration-Zeichenfolge in Nur-Text.

properties.cloudInitConfigurationBlobs

string[]

CloudInitConfigurationBlob-Speicher-URLs.

properties.delegation

DelegationProperties

Die Delegierung für die virtuelle Appliance

properties.deploymentType

string

Der Bereitstellungstyp. PartnerManaged für saaS NVA

properties.inboundSecurityRules

SubResource[]

Liste der Verweise auf InboundSecurityRules.

properties.internetIngressPublicIps

InternetIngressPublicIpsProperties[]

Liste der Ressourcen-URI öffentlicher IPs für das Interneteingangsszenario.

properties.networkProfile

NetworkProfile

Netzwerkprofil mit Konfigurationen für öffentliche und private NIC.

properties.nvaSku

VirtualApplianceSkuProperties

SKU der virtuellen Netzwerkanwendung.

properties.partnerManagedResource

PartnerManagedResourceProperties

Die Delegierung für die virtuelle Appliance

properties.provisioningState

ProvisioningState

Der Bereitstellungsstatus der Ressource.

properties.sshPublicKey

string

Öffentlicher Schlüssel für die SSH-Anmeldung.

properties.virtualApplianceAsn

integer

VirtualAppliance ASN. Microsoft private, öffentliche und IANA reservierte ASN werden nicht unterstützt.

properties.virtualApplianceConnections

SubResource[]

Liste der Verweise auf VirtualApplianceConnections.

properties.virtualApplianceNics

VirtualApplianceNicProperties[]

Liste der Virtuellen Appliance-Netzwerkschnittstellen.

properties.virtualApplianceSites

SubResource[]

Liste der Verweise auf VirtualApplianceSite.

properties.virtualHub

SubResource

Der virtuelle Hub, auf dem die virtuelle Netzwerk-Appliance bereitgestellt wird.

tags

object

Ressourcentags.

type

string

Ressourcentyp.

NicTypeInRequest

NIC-Typ. Dies sollte entweder PublicNic oder PrivateNic sein.

Wert Beschreibung
PrivateNic
PublicNic

NicTypeInResponse

NIC-Typ – PublicNic, PrivateNic oder AdditionalNic.

Wert Beschreibung
AdditionalNic
PrivateNic
PublicNic

PartnerManagedResourceProperties

Eigenschaften der vom Partner verwalteten Ressource.

Name Typ Beschreibung
id

string

Die vom Partner verwaltete Ressourcen-ID.

internalLoadBalancerId

string

Die vom Partner verwaltete ILB-Ressourcen-ID

standardLoadBalancerId

string

Die vom Partner verwaltete SLB-Ressourcen-ID

ProvisioningState

Der aktuelle Bereitstellungsstatus.

Wert Beschreibung
Deleting
Failed
Succeeded
Updating

ResourceIdentityType

Der Identitätstyp, der für die Ressource verwendet wird. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten vom virtuellen Computer.

Wert Beschreibung
None
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned

SubResource

Verweisen auf eine andere Unterressource.

Name Typ Beschreibung
id

string

Ressourcen-ID.

UserAssignedIdentities

Die Liste der Benutzeridentitäten, die der Ressource zugeordnet sind. Die Benutzeridentitätswörterbuchschlüsselverweise sind ARM-Ressourcen-IDs im Formular: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

Name Typ Beschreibung

VirtualApplianceAdditionalNicProperties

Zusätzliche Nic-Eigenschaften der virtuellen Netzwerkanwendung

Name Typ Beschreibung
hasPublicIp

boolean

Flag (true oder false) für Intent for Public IP on additional nic

name

string

Name des zusätzlichen nic

VirtualApplianceIPConfiguration

Stellt eine einzelne IP-Konfiguration dar.

Name Typ Beschreibung
name

string

Name der IP-Konfiguration.

properties

VirtualApplianceIPConfigurationProperties

Stellt eine einzelne IP-Konfigurationseigenschaften dar.

VirtualApplianceIPConfigurationProperties

Stellt eine einzelne IP-Konfigurationseigenschaften dar.

Name Typ Beschreibung
primary

boolean

Gibt an, ob dies die primäre IP-Konfiguration der NIC ist.

VirtualApplianceNetworkInterfaceConfiguration

Stellt eine einzelne NIC-Konfiguration dar.

Name Typ Beschreibung
properties

VirtualApplianceNetworkInterfaceConfigurationProperties

Stellt eine einzelne NIC-Konfigurationseigenschaften dar.

type

NicTypeInRequest

NIC-Typ. Dies sollte entweder PublicNic oder PrivateNic sein.

VirtualApplianceNetworkInterfaceConfigurationProperties

Stellt eine einzelne NIC-Konfigurationseigenschaften dar.

Name Typ Beschreibung
ipConfigurations

VirtualApplianceIPConfiguration[]

Stellt eine einzelne IP-Konfiguration dar.

VirtualApplianceNicProperties

Netzwerk virtual Appliance NIC-Eigenschaften.

Name Typ Beschreibung
instanceName

string

Instanz, an die nic angefügt ist.

name

string

NIC-Name.

nicType

NicTypeInResponse

NIC-Typ – PublicNic, PrivateNic oder AdditionalNic.

privateIpAddress

string

Private IP-Adresse.

publicIpAddress

string

Öffentliche IP-Adresse.

VirtualApplianceSkuProperties

Sku-Eigenschaften der virtuellen Netzwerkanwendung.

Name Typ Beschreibung
bundledScaleUnit

string

Skalierungseinheit für virtuelle Appliance.

marketPlaceVersion

string

Virtual Appliance-Version.

vendor

string

Virtueller Appliance-Anbieter.