Share via

Hub Virtual Network Connections - Create Or Update

  • Referência
Service:
Virtual WAN
API Version:
2023-09-01

Cria uma conexão de rede virtual do hub se ela não existir, atualiza a existente.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
connectionName
 path True

string

O nome do HubVirtualNetworkConnection.
resourceGroupName
 path True

string

O nome do grupo de recursos do HubVirtualNetworkConnection.
subscriptionId
 path True

string

As credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.
virtualHubName
 path True

string

O nome do VirtualHub.
api-version
 query True

string

Versão de API do cliente.

Corpo da solicitação

Nome Tipo Description
id

string

ID do recurso.
name

string

O nome do recurso que é exclusivo em um grupo de recursos. Esse nome pode ser usado para acessar o recurso.
properties.allowHubToRemoteVnetTransit

boolean

Preterido: trânsito do VirtualHub para RemoteVnet para habilitado ou não.
properties.allowRemoteVnetToUseHubVnetGateways

boolean

Preterido: permitir que o RemoteVnet use os gateways do Hub Virtual.
properties.enableInternetSecurity

boolean

Habilitar a segurança da Internet.
properties.remoteVirtualNetwork

SubResource

Referência à rede virtual remota.
properties.routingConfiguration

RoutingConfiguration

A Configuração de Roteamento que indica as tabelas de rotas associadas e propagadas nessa conexão.

Respostas

Nome Tipo Description
200 OK

HubVirtualNetworkConnection

Solicitação bem-sucedida. Retorna os detalhes da conexão de rede virtual do hub criada ou atualizada.
201 Created

HubVirtualNetworkConnection

Solicitação bem-sucedida. Retorna os detalhes da conexão de rede virtual do hub recuperada.
Other Status Codes

CloudError

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

HubVirtualNetworkConnectionPut

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualHubs/virtualHub1/hubVirtualNetworkConnections/connection1?api-version=2023-09-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"
      }
    }
  }
}

Sample Response

Status code:
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"
      }
    }
  }
}
Status code:
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"
      }
    }
  }
}

Definições

Nome Description
CloudError

Uma resposta de erro do serviço.
CloudErrorBody

Uma resposta de erro do serviço.
HubVirtualNetworkConnection

Recurso HubVirtualNetworkConnection.
PropagatedRouteTable

A lista de RouteTables para a qual anunciar as rotas.
ProvisioningState

O estado de provisionamento atual.
RoutingConfiguration

Configuração de roteamento que indica as tabelas de rotas associadas e propagadas para essa conexão.
StaticRoute

Lista de todas as Rotas Estáticas.
StaticRoutesConfig

Configuração para rotas estáticas neste HubVnetConnectionConfiguration para rotas estáticas neste HubVnetConnection.
SubResource

Referência a outro sub-recurso.
VnetLocalRouteOverrideCriteria

Parâmetro que determina se a NVA na vnet spoke é ignorada para tráfego com destino na vnet spoke.
VnetRoute

Lista de rotas que controlam o roteamento do VirtualHub para uma conexão de rede virtual.

CloudError

Uma resposta de erro do serviço.

Nome Tipo Description
error

CloudErrorBody

Corpo do erro de nuvem.

CloudErrorBody

Uma resposta de erro do serviço.

Nome Tipo Description
code

string

Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.
details

CloudErrorBody[]

Uma lista de detalhes adicionais sobre o erro.
message

string

Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.
target

string

O destino do erro específico. Por exemplo, o nome da propriedade em erro.

HubVirtualNetworkConnection

Recurso HubVirtualNetworkConnection.

Nome Tipo Description
etag

string

Uma cadeia de caracteres somente leitura exclusiva que é alterada sempre que o recurso é atualizado.
id

string

ID do recurso.
name

string

O nome do recurso que é exclusivo em um grupo de recursos. Esse nome pode ser usado para acessar o recurso.
properties.allowHubToRemoteVnetTransit

boolean

Preterido: trânsito do VirtualHub para RemoteVnet para habilitado ou não.
properties.allowRemoteVnetToUseHubVnetGateways

boolean

Preterido: permitir que o RemoteVnet use os gateways do Hub Virtual.
properties.enableInternetSecurity

boolean

Habilitar a segurança da Internet.
properties.provisioningState

ProvisioningState

O estado de provisionamento do recurso de conexão de rede virtual do hub.
properties.remoteVirtualNetwork

SubResource

Referência à rede virtual remota.
properties.routingConfiguration

RoutingConfiguration

A Configuração de Roteamento que indica as tabelas de rotas associadas e propagadas nessa conexão.

PropagatedRouteTable

A lista de RouteTables para a qual anunciar as rotas.

Nome Tipo Description
ids

SubResource[]

A lista de IDs de recursos de todas as RouteTables.
labels

string[]

A lista de rótulos.

ProvisioningState

O estado de provisionamento atual.

Nome Tipo Description
Deleting

string

Failed

string

Succeeded

string

Updating

string

RoutingConfiguration

Configuração de roteamento que indica as tabelas de rotas associadas e propagadas para essa conexão.

Nome Tipo Description
associatedRouteTable

SubResource

A ID do recurso RouteTable associada a esse RoutingConfiguration.
inboundRouteMap

SubResource

A ID do recurso do RouteMap associado a esse RoutingConfiguration para rotas aprendidas de entrada.
outboundRouteMap

SubResource

A ID do recurso doRouteMap associado a esse RoutingConfiguration para rotas anunciadas de saída.
propagatedRouteTables

PropagatedRouteTable

A lista de RouteTables para a qual anunciar as rotas.
vnetRoutes

VnetRoute

Lista de rotas que controlam o roteamento do VirtualHub para uma conexão de rede virtual.

StaticRoute

Lista de todas as Rotas Estáticas.

Nome Tipo Description
addressPrefixes

string[]

Lista de todos os prefixos de endereço.
name

string

O nome do StaticRoute que é exclusivo em um VnetRoute.
nextHopIpAddress

string

O endereço ip do próximo salto.

StaticRoutesConfig

Configuração para rotas estáticas neste HubVnetConnectionConfiguration para rotas estáticas neste HubVnetConnection.

Nome Tipo Description
propagateStaticRoutes

boolean

Booliano que indica se as rotas estáticas nessa conexão são propagadas automaticamente para tabelas de rotas para as quais essa conexão se propaga.
vnetLocalRouteOverrideCriteria

VnetLocalRouteOverrideCriteria

Parâmetro que determina se a NVA na vnet spoke é ignorada para tráfego com destino no spoke.

SubResource

Referência a outro sub-recurso.

Nome Tipo Description
id

string

ID do recurso.

VnetLocalRouteOverrideCriteria

Parâmetro que determina se a NVA na vnet spoke é ignorada para tráfego com destino na vnet spoke.

Nome Tipo Description
Contains

string

Equal

string

VnetRoute

Lista de rotas que controlam o roteamento do VirtualHub para uma conexão de rede virtual.

Nome Tipo Description
bgpConnections

SubResource[]

A lista de referências aos objetos HubBgpConnection.
staticRoutes

StaticRoute[]

Lista de todas as Rotas Estáticas.
staticRoutesConfig

StaticRoutesConfig

Configuração para rotas estáticas neste HubVnetConnection.