Condividi tramite

Hub Virtual Network Connections - Create Or Update

  • Riferimento
Servizio:
Virtual WAN
Versione API:
2024-05-01

Crea una connessione di rete virtuale hub, se non esiste, ne aggiorna quella esistente.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/hubVirtualNetworkConnections/{connectionName}?api-version=2024-05-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
connectionName
 path True

string

Nome dell'hubVirtualNetworkConnection.
resourceGroupName
 path True

string

Nome del gruppo di risorse dell'hubVirtualNetworkConnection.
subscriptionId
 path True

string

Credenziali della sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.
virtualHubName
 path True

string

Nome di VirtualHub.
api-version
 query True

string

Versione dell'API client.

Corpo della richiesta

Nome Tipo Descrizione
id

string

ID risorsa.
name

string

Nome della risorsa univoca all'interno di un gruppo di risorse. Questo nome può essere usato per accedere alla risorsa.
properties.allowHubToRemoteVnetTransit

boolean

Deprecato: transito da VirtualHub a RemoteVnet da abilitato o meno.
properties.allowRemoteVnetToUseHubVnetGateways

boolean

Deprecato: consentire a RemoteVnet di usare i gateway dell'hub virtuale.
properties.enableInternetSecurity

boolean

Abilitare la sicurezza Internet.
properties.remoteVirtualNetwork

SubResource

Riferimento alla rete virtuale remota.
properties.routingConfiguration

RoutingConfiguration

Configurazione di routing che indica le tabelle di route associate e propagate in questa connessione.

Risposte

Nome Tipo Descrizione
200 OK

HubVirtualNetworkConnection

Richiesta riuscita. Restituisce i dettagli della connessione di rete virtuale hub creata o aggiornata.
201 Created

HubVirtualNetworkConnection

Richiesta riuscita. Restituisce i dettagli della connessione di rete virtuale dell'hub recuperata.
Other Status Codes

CloudError

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

HubVirtualNetworkConnectionPut

Esempio di richiesta

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubVirtualNetworkConnections/connection1?api-version=2024-05-01

{
  "properties": {
    "remoteVirtualNetwork": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/SpokeVnet1"
    },
    "enableInternetSecurity": false,
    "routingConfiguration": {
      "associatedRouteTable": {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubRouteTables/hubRouteTable1"
      },
      "propagatedRouteTables": {
        "labels": [
          "label1",
          "label2"
        ],
        "ids": [
          {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubRouteTables/hubRouteTable1"
          }
        ]
      },
      "vnetRoutes": {
        "staticRoutesConfig": {
          "vnetLocalRouteOverrideCriteria": "Equal"
        },
        "staticRoutes": [
          {
            "name": "route1",
            "addressPrefixes": [
              "10.1.0.0/16",
              "10.2.0.0/16"
            ],
            "nextHopIpAddress": "10.0.0.68"
          },
          {
            "name": "route2",
            "addressPrefixes": [
              "10.3.0.0/16",
              "10.4.0.0/16"
            ],
            "nextHopIpAddress": "10.0.0.65"
          }
        ]
      },
      "inboundRouteMap": {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/routeMaps/routeMap1"
      },
      "outboundRouteMap": {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/routeMaps/routeMap2"
      }
    }
  }
}

Risposta di esempio

Codice di stato:
200 
{
  "name": "connection1",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubVirtualNetworkConnections/connection1",
  "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
  "properties": {
    "provisioningState": "Updating",
    "remoteVirtualNetwork": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/SpokeVnet1"
    },
    "enableInternetSecurity": false,
    "routingConfiguration": {
      "associatedRouteTable": {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubRouteTables/hubRouteTable1"
      },
      "propagatedRouteTables": {
        "labels": [
          "label1",
          "label2"
        ],
        "ids": [
          {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubRouteTables/hubRouteTable1"
          }
        ]
      },
      "vnetRoutes": {
        "staticRoutesConfig": {
          "propagateStaticRoutes": true,
          "vnetLocalRouteOverrideCriteria": "Equal"
        },
        "staticRoutes": [
          {
            "name": "route1",
            "addressPrefixes": [
              "10.1.0.0/16",
              "10.2.0.0/16"
            ],
            "nextHopIpAddress": "10.0.0.68"
          },
          {
            "name": "route2",
            "addressPrefixes": [
              "10.3.0.0/16",
              "10.4.0.0/16"
            ],
            "nextHopIpAddress": "10.0.0.65"
          }
        ],
        "bgpConnections": [
          {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/bgpConnections/bgpConn1"
          }
        ]
      },
      "inboundRouteMap": {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/routeMaps/routeMap1"
      },
      "outboundRouteMap": {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/routeMaps/routeMap2"
      }
    }
  }
}
Codice di stato:
201 
{
  "name": "connection1",
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubVirtualNetworkConnections/connection1",
  "etag": "w/\\00000000-0000-0000-0000-000000000000\\",
  "properties": {
    "provisioningState": "Updating",
    "remoteVirtualNetwork": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/SpokeVnet1"
    },
    "enableInternetSecurity": false,
    "routingConfiguration": {
      "associatedRouteTable": {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubRouteTables/hubRouteTable1"
      },
      "propagatedRouteTables": {
        "labels": [
          "label1",
          "label2"
        ],
        "ids": [
          {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubRouteTables/hubRouteTable1"
          }
        ]
      },
      "vnetRoutes": {
        "staticRoutesConfig": {
          "propagateStaticRoutes": true,
          "vnetLocalRouteOverrideCriteria": "Equal"
        },
        "staticRoutes": [
          {
            "name": "route1",
            "addressPrefixes": [
              "10.1.0.0/16",
              "10.2.0.0/16"
            ],
            "nextHopIpAddress": "10.0.0.68"
          },
          {
            "name": "route2",
            "addressPrefixes": [
              "10.3.0.0/16",
              "10.4.0.0/16"
            ],
            "nextHopIpAddress": "10.0.0.65"
          }
        ],
        "bgpConnections": [
          {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/bgpConnections/bgpConn1"
          }
        ]
      },
      "inboundRouteMap": {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/routeMaps/routeMap1"
      },
      "outboundRouteMap": {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/routeMaps/routeMap2"
      }
    }
  }
}

Definizioni

Nome Descrizione
CloudError

Risposta di errore dal servizio.
CloudErrorBody

Risposta di errore dal servizio.
HubVirtualNetworkConnection

Risorsa HubVirtualNetworkConnection.
PropagatedRouteTable

Elenco di RouteTables a cui annunciare le route.
ProvisioningState

Stato di provisioning corrente.
RoutingConfiguration

Configurazione di routing che indica le tabelle di route associate e propagate per questa connessione.
StaticRoute

Elenco di tutte le route statiche.
StaticRoutesConfig

Configurazione per le route statiche in questo hubVnetConnectionConfiguration per le route statiche in questo hubVnetConnection.
SubResource

Riferimento a un'altra sottorisorsa.
VnetLocalRouteOverrideCriteria

Parametro che determina se l'appliance virtuale di rete virtuale in spoke viene ignorata per il traffico con destinazione nella rete virtuale spoke.
VnetRoute

Elenco di route che controllano il routing da VirtualHub in una connessione di rete virtuale.

CloudError

Risposta di errore dal servizio.

Nome Tipo Descrizione
error

CloudErrorBody

Corpo dell'errore cloud.

CloudErrorBody

Risposta di errore dal servizio.

Nome Tipo Descrizione
code

string

Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
details

CloudErrorBody[]

Elenco di dettagli aggiuntivi sull'errore.
message

string

Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.
target

string

Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in errore.

HubVirtualNetworkConnection

Risorsa HubVirtualNetworkConnection.

Nome Tipo Descrizione
etag

string

Stringa di sola lettura univoca che cambia ogni volta che la risorsa viene aggiornata.
id

string

ID risorsa.
name

string

Nome della risorsa univoca all'interno di un gruppo di risorse. Questo nome può essere usato per accedere alla risorsa.
properties.allowHubToRemoteVnetTransit

boolean

Deprecato: transito da VirtualHub a RemoteVnet da abilitato o meno.
properties.allowRemoteVnetToUseHubVnetGateways

boolean

Deprecato: consentire a RemoteVnet di usare i gateway dell'hub virtuale.
properties.enableInternetSecurity

boolean

Abilitare la sicurezza Internet.
properties.provisioningState

ProvisioningState

Stato di provisioning della risorsa di connessione di rete virtuale hub.
properties.remoteVirtualNetwork

SubResource

Riferimento alla rete virtuale remota.
properties.routingConfiguration

RoutingConfiguration

Configurazione di routing che indica le tabelle di route associate e propagate in questa connessione.

PropagatedRouteTable

Elenco di RouteTables a cui annunciare le route.

Nome Tipo Descrizione
ids

SubResource[]

Elenco di ID risorsa di tutte le tabelle RouteTable.
labels

string[]

Elenco di etichette.

ProvisioningState

Stato di provisioning corrente.

Nome Tipo Descrizione
Deleting

string

Failed

string

Succeeded

string

Updating

string

RoutingConfiguration

Configurazione di routing che indica le tabelle di route associate e propagate per questa connessione.

Nome Tipo Descrizione
associatedRouteTable

SubResource

Id risorsa RouteTable associato a questo RoutingConfiguration.
inboundRouteMap

SubResource

ID risorsa dell'oggetto RouteMap associato a questo RoutingConfiguration per le route apprese in ingresso.
outboundRouteMap

SubResource

ID risorsa dell'oggettoRouteMap associato a questo RoutingConfiguration per le route annunciate in uscita.
propagatedRouteTables

PropagatedRouteTable

Elenco di RouteTables a cui annunciare le route.
vnetRoutes

VnetRoute

Elenco di route che controllano il routing da VirtualHub in una connessione di rete virtuale.

StaticRoute

Elenco di tutte le route statiche.

Nome Tipo Descrizione
addressPrefixes

string[]

Elenco di tutti i prefissi di indirizzo.
name

string

Nome dell'oggetto StaticRoute univoco all'interno di una rete virtuale.
nextHopIpAddress

string

Indirizzo IP dell'hop successivo.

StaticRoutesConfig

Configurazione per le route statiche in questo hubVnetConnectionConfiguration per le route statiche in questo hubVnetConnection.

Nome Tipo Descrizione
propagateStaticRoutes

boolean

Valore booleano che indica se le route statiche in questa connessione vengono propagate automaticamente alle tabelle di route a cui viene propagata la connessione.
vnetLocalRouteOverrideCriteria

VnetLocalRouteOverrideCriteria

Parametro che determina se l'appliance virtuale di rete nella rete virtuale spoke viene ignorata per il traffico con destinazione in spoke.

SubResource

Riferimento a un'altra sottorisorsa.

Nome Tipo Descrizione
id

string

ID risorsa.

VnetLocalRouteOverrideCriteria

Parametro che determina se l'appliance virtuale di rete virtuale in spoke viene ignorata per il traffico con destinazione nella rete virtuale spoke.

Nome Tipo Descrizione
Contains

string

Equal

string

VnetRoute

Elenco di route che controllano il routing da VirtualHub in una connessione di rete virtuale.

Nome Tipo Descrizione
bgpConnections

SubResource[]

Elenco di riferimenti agli oggetti HubBgpConnection.
staticRoutes

StaticRoute[]

Elenco di tutte le route statiche.
staticRoutesConfig

StaticRoutesConfig

Configurazione per le route statiche in questo hubVnetConnection.