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 |
---|---|---|---|---|
network
|
path | True |
string |
Der Name der virtuellen Netzwerk-Appliance. |
resource
|
path | True |
string |
Der Name der Ressourcengruppe. |
subscription
|
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 |
Anforderung erfolgreich. Der Vorgang gibt eine Ressource der virtuellen Netzwerkanwendung zurück. |
|
Other Status Codes |
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
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 |
---|---|
Cloud |
Eine Fehlerantwort des Diensts. |
Cloud |
Eine Fehlerantwort des Diensts. |
Delegation |
Eigenschaften der Delegierung. |
Internet |
Internet Ingress Public IP-Eigenschaften |
Managed |
Identität für die Ressource. |
Network |
Netzwerkprofil mit Konfigurationen für öffentliche und private NIC. |
Network |
NetworkVirtualAppliance-Ressource. |
Nic |
NIC-Typ. Dies sollte entweder PublicNic oder PrivateNic sein. |
Nic |
NIC-Typ – PublicNic, PrivateNic oder AdditionalNic. |
Partner |
Eigenschaften der vom Partner verwalteten Ressource. |
Provisioning |
Der aktuelle Bereitstellungsstatus. |
Resource |
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. |
Sub |
Verweisen auf eine andere Unterressource. |
User |
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}". |
Virtual |
Zusätzliche Nic-Eigenschaften der virtuellen Netzwerkanwendung |
Virtual |
Stellt eine einzelne IP-Konfiguration dar. |
Virtual |
Stellt eine einzelne IP-Konfigurationseigenschaften dar. |
Virtual |
Stellt eine einzelne NIC-Konfiguration dar. |
Virtual |
Stellt eine einzelne NIC-Konfigurationseigenschaften dar. |
Virtual |
Netzwerk virtual Appliance NIC-Eigenschaften. |
Virtual |
Sku-Eigenschaften der virtuellen Netzwerkanwendung. |
CloudError
Eine Fehlerantwort des Diensts.
Name | Typ | Beschreibung |
---|---|---|
error |
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 |
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 |
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 |
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 |
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 |
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 |
Der Dienstprinzipal, der Lesezugriff auf cloudinit und config blob hat. |
|
location |
string |
Ressourcenspeicherort. |
name |
string |
Ressourcenname. |
properties.additionalNics |
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 |
Die Delegierung für die virtuelle Appliance |
|
properties.deploymentType |
string |
Der Bereitstellungstyp. PartnerManaged für saaS NVA |
properties.inboundSecurityRules |
Liste der Verweise auf InboundSecurityRules. |
|
properties.internetIngressPublicIps |
Liste der Ressourcen-URI öffentlicher IPs für das Interneteingangsszenario. |
|
properties.networkProfile |
Netzwerkprofil mit Konfigurationen für öffentliche und private NIC. |
|
properties.nvaSku |
SKU der virtuellen Netzwerkanwendung. |
|
properties.partnerManagedResource |
Die Delegierung für die virtuelle Appliance |
|
properties.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 |
Liste der Verweise auf VirtualApplianceConnections. |
|
properties.virtualApplianceNics |
Liste der Virtuellen Appliance-Netzwerkschnittstellen. |
|
properties.virtualApplianceSites |
Liste der Verweise auf VirtualApplianceSite. |
|
properties.virtualHub |
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 |
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 |
Stellt eine einzelne NIC-Konfigurationseigenschaften dar. |
|
type |
NIC-Typ. Dies sollte entweder PublicNic oder PrivateNic sein. |
VirtualApplianceNetworkInterfaceConfigurationProperties
Stellt eine einzelne NIC-Konfigurationseigenschaften dar.
Name | Typ | Beschreibung |
---|---|---|
ipConfigurations |
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 |
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. |