Virtual Hubs - Create Or Update
Erstellt eine VirtualHub-Ressource, wenn sie nicht vorhanden ist, und aktualisiert den vorhandenen VirtualHub.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}?api-version=2023-09-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
resource
|
path | True |
string |
Der Ressourcengruppenname des VirtualHubs. |
subscription
|
path | True |
string |
Die Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf. |
virtual
|
path | True |
string |
Der Name des VirtualHub. |
api-version
|
query | True |
string |
Client-API-Version. |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
location | True |
string |
Ressourcenspeicherort |
id |
string |
Ressourcen-ID |
|
properties.addressPrefix |
string |
Adresspräfix für diesen VirtualHub. |
|
properties.allowBranchToBranchTraffic |
boolean |
Flag zum Steuern des Transits für den VirtualRouter-Hub. |
|
properties.azureFirewall |
Die azureFirewall, die diesem VirtualHub zugeordnet ist. |
||
properties.expressRouteGateway |
Das expressRouteGateway, das diesem VirtualHub zugeordnet ist. |
||
properties.hubRoutingPreference |
Die hubRoutingPreference dieses VirtualHub. |
||
properties.p2SVpnGateway |
Das P2SVpnGateway, das diesem VirtualHub zugeordnet ist. |
||
properties.preferredRoutingGateway |
Das bevorzugte Gateway zum Weiterleiten von lokalem Datenverkehr |
||
properties.routeTable |
Die diesem virtuellen Hub zugeordnete routeTable. |
||
properties.securityPartnerProvider |
Der securityPartnerProvider, der diesem VirtualHub zugeordnet ist. |
||
properties.securityProviderName |
string |
Der Name des Sicherheitsanbieters. |
|
properties.sku |
string |
Die SKU dieses VirtualHubs. |
|
properties.virtualHubRouteTableV2s |
Liste aller virtuellen Hub-Routingtabellen v2, die diesem VirtualHub zugeordnet sind. |
||
properties.virtualRouterAsn |
integer |
VirtualRouter ASN. |
|
properties.virtualRouterAutoScaleConfiguration |
Die Konfiguration der automatischen Skalierung des VirtualHub-Routers. |
||
properties.virtualRouterIps |
string[] |
VirtualRouter-IP-Adressen. |
|
properties.virtualWan |
Der VirtualWAN, zu dem virtualHub gehört. |
||
properties.vpnGateway |
Das vpnGateway, das diesem VirtualHub zugeordnet ist. |
||
tags |
object |
Ressourcentags. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Anforderung erfolgreich. Gibt die Details des erstellten oder aktualisierten VirtualHub zurück. |
|
201 Created |
Die Anforderung wurde erfolgreich empfangen. Gibt die Details des erstellten oder aktualisierten VirtualHub zurück. |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
VirtualHubPut
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub2?api-version=2023-09-01
{
"location": "West US",
"tags": {
"key1": "value1"
},
"properties": {
"virtualWan": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualWans/virtualWan1"
},
"addressPrefix": "10.168.0.0/24",
"sku": "Basic"
}
}
Sample Response
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub2",
"etag": "w/\\00000000-0000-0000-0000-000000000000\\",
"location": "West US",
"name": "virtualHub2",
"type": "Microsoft.Network/virtualHubs",
"properties": {
"provisioningState": "Succeeded",
"virtualWan": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualWans/virtualWan1"
},
"virtualHubRouteTableV2s": [],
"addressPrefix": "10.168.0.0/24",
"sku": "Basic",
"routingState": "Provisioned",
"virtualRouterAsn": 65515,
"virtualRouterIps": [
"10.10.1.12",
"10.10.1.13"
],
"allowBranchToBranchTraffic": false,
"preferredRoutingGateway": "ExpressRoute",
"hubRoutingPreference": "ExpressRoute",
"virtualRouterAutoScaleConfiguration": {
"minCapacity": 2
}
}
}
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub2",
"etag": "w/\\00000000-0000-0000-0000-000000000000\\",
"location": "West US",
"name": "virtualHub2",
"type": "Microsoft.Network/virtualHubs",
"properties": {
"provisioningState": "Succeeded",
"virtualWan": {
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualWans/virtualWan1"
},
"virtualHubRouteTableV2s": [],
"addressPrefix": "10.168.0.0/24",
"sku": "Basic",
"routingState": "Provisioned",
"virtualRouterAsn": 65515,
"virtualRouterIps": [
"10.10.1.12",
"10.10.1.13"
],
"allowBranchToBranchTraffic": false,
"preferredRoutingGateway": "ExpressRoute",
"hubRoutingPreference": "ExpressRoute",
"virtualRouterAutoScaleConfiguration": {
"minCapacity": 2
}
}
}
Definitionen
Name | Beschreibung |
---|---|
Cloud |
Eine Fehlerantwort vom Dienst. |
Cloud |
Eine Fehlerantwort vom Dienst. |
Hub |
Gatewaytypen der Hubroutingpräferenz |
Preferred |
Die bevorzugten Routinggatewaytypen |
Provisioning |
Der aktuelle Bereitstellungsstatus. |
Routing |
Der aktuelle Routingstatus von VirtualHub. |
Sub |
Verweis auf eine andere Unterressource. |
Virtual |
VirtualHub-Ressource. |
Virtual |
VirtualHub-Route. |
Virtual |
VirtualHub-Routingtabelle. |
Virtual |
VirtualHubRouteTableV2-Ressource. |
Virtual |
VirtualHubRouteTableV2-Route. |
Virtual |
Die Konfiguration der automatischen Skalierung des VirtualHub-Routers. |
CloudError
Eine Fehlerantwort vom Dienst.
Name | Typ | Beschreibung |
---|---|---|
error |
Cloudfehlertext. |
CloudErrorBody
Eine Fehlerantwort vom Dienst.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollten programmgesteuert verwendet werden. |
details |
Eine Liste mit zusätzlichen Details zum Fehler. |
|
message |
string |
Eine Meldung, die den Fehler beschreibt, die für die Anzeige in einer Benutzeroberfläche geeignet sein soll. |
target |
string |
Das Ziel des bestimmten Fehlers. Beispiel: Der Name der -Eigenschaft, die einen Fehler aufweist. |
HubRoutingPreference
Gatewaytypen der Hubroutingpräferenz
Name | Typ | Beschreibung |
---|---|---|
ASPath |
string |
|
ExpressRoute |
string |
|
VpnGateway |
string |
PreferredRoutingGateway
Die bevorzugten Routinggatewaytypen
Name | Typ | Beschreibung |
---|---|---|
ExpressRoute |
string |
|
None |
string |
|
VpnGateway |
string |
ProvisioningState
Der aktuelle Bereitstellungsstatus.
Name | Typ | Beschreibung |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
RoutingState
Der aktuelle Routingstatus von VirtualHub.
Name | Typ | Beschreibung |
---|---|---|
Failed |
string |
|
None |
string |
|
Provisioned |
string |
|
Provisioning |
string |
SubResource
Verweis auf eine andere Unterressource.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID |
VirtualHub
VirtualHub-Ressource.
Name | Typ | Beschreibung |
---|---|---|
etag |
string |
Eine eindeutige schreibgeschützte Zeichenfolge, die sich ändert, wenn die Ressource aktualisiert wird. |
id |
string |
Ressourcen-ID |
kind |
string |
Art des virtuellen Diensthubs. Dies sind Metadaten, die für die Azure-Portal Erfahrung für Route Server verwendet werden. |
location |
string |
Ressourcenspeicherort |
name |
string |
Name der Ressource. |
properties.addressPrefix |
string |
Adresspräfix für diesen VirtualHub. |
properties.allowBranchToBranchTraffic |
boolean |
Flag zum Steuern des Transits für den VirtualRouter-Hub. |
properties.azureFirewall |
Die azureFirewall, die diesem VirtualHub zugeordnet ist. |
|
properties.bgpConnections |
Liste der Verweise auf Bgp Connections. |
|
properties.expressRouteGateway |
Das expressRouteGateway, das diesem VirtualHub zugeordnet ist. |
|
properties.hubRoutingPreference |
Die hubRoutingPreference dieses VirtualHub. |
|
properties.ipConfigurations |
Liste der Verweise auf IpConfigurations. |
|
properties.p2SVpnGateway |
Das P2SVpnGateway, das diesem VirtualHub zugeordnet ist. |
|
properties.preferredRoutingGateway |
Das bevorzugte Gateway zum Weiterleiten von lokalem Datenverkehr |
|
properties.provisioningState |
Der Bereitstellungsstatus der virtuellen Hubressource. |
|
properties.routeMaps |
Liste der Verweise auf RouteMaps. |
|
properties.routeTable |
Die diesem virtuellen Hub zugeordnete routeTable. |
|
properties.routingState |
Der Routingzustand. |
|
properties.securityPartnerProvider |
Der securityPartnerProvider, der diesem VirtualHub zugeordnet ist. |
|
properties.securityProviderName |
string |
Der Name des Sicherheitsanbieters. |
properties.sku |
string |
Die SKU dieses VirtualHubs. |
properties.virtualHubRouteTableV2s |
Liste aller virtuellen Hub-Routingtabellen v2, die diesem VirtualHub zugeordnet sind. |
|
properties.virtualRouterAsn |
integer |
VirtualRouter ASN. |
properties.virtualRouterAutoScaleConfiguration |
Die Konfiguration der automatischen Skalierung des VirtualHub-Routers. |
|
properties.virtualRouterIps |
string[] |
VirtualRouter-IP-Adressen. |
properties.virtualWan |
Der VirtualWAN, zu dem virtualHub gehört. |
|
properties.vpnGateway |
Das vpnGateway, das diesem VirtualHub zugeordnet ist. |
|
tags |
object |
Ressourcentags. |
type |
string |
Der Ressourcentyp. |
VirtualHubRoute
VirtualHub-Route.
Name | Typ | Beschreibung |
---|---|---|
addressPrefixes |
string[] |
Liste aller AddressPrefixes. |
nextHopIpAddress |
string |
NextHop-IP-Adresse. |
VirtualHubRouteTable
VirtualHub-Routingtabelle.
Name | Typ | Beschreibung |
---|---|---|
routes |
Liste aller Routen. |
VirtualHubRouteTableV2
VirtualHubRouteTableV2-Ressource.
Name | Typ | Beschreibung |
---|---|---|
etag |
string |
Eine eindeutige schreibgeschützte Zeichenfolge, die sich ändert, wenn die Ressource aktualisiert wird. |
id |
string |
Ressourcen-ID |
name |
string |
Der Name der Ressource, die innerhalb einer Ressourcengruppe eindeutig ist. Dieser Name kann für den Zugriff auf die Ressource verwendet werden. |
properties.attachedConnections |
string[] |
Liste aller Verbindungen, die an diese Routingtabelle v2 angefügt sind. |
properties.provisioningState |
Der Bereitstellungsstatus der Routingtabelle v2-Ressource des virtuellen Hubs. |
|
properties.routes |
Liste aller Routen. |
VirtualHubRouteV2
VirtualHubRouteTableV2-Route.
Name | Typ | Beschreibung |
---|---|---|
destinationType |
string |
Der Typ der Ziele. |
destinations |
string[] |
Liste aller Ziele. |
nextHopType |
string |
Der Typ der nächsten Hops. |
nextHops |
string[] |
NextHops-IP-Adresse. |
VirtualRouterAutoScaleConfiguration
Die Konfiguration der automatischen Skalierung des VirtualHub-Routers.
Name | Typ | Beschreibung |
---|---|---|
minCapacity |
integer |
Die Mindestanzahl von Skalierungseinheiten für Den VirtualHub-Router. |