Partilhar via

Hub Virtual Network Connections - Create Or Update

  • Referência
Serviço:
Virtual WAN
Versão da API:
2024-05-01

Cria uma conexão de rede virtual de 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=2024-05-01

Parâmetros do URI

Name Em Necessá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. O ID da assinatura faz parte do URI de cada chamada de serviço.
virtualHubName
 path True

string

O nome do VirtualHub.
api-version
 query True

string

Versão da API do cliente.

Corpo do Pedido

Name Tipo Description
id

string

ID do recurso.
name

string

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

boolean

Preterido: VirtualHub para RemoteVnet transitam para habilitado ou não.
properties.allowRemoteVnetToUseHubVnetGateways

boolean

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

boolean

Habilite a segurança na Internet.
properties.remoteVirtualNetwork

SubResource

Referência à rede virtual remota.
properties.routingConfiguration

RoutingConfiguration

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

Respostas

Name Tipo Description
200 OK

HubVirtualNetworkConnection

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

HubVirtualNetworkConnection

Pedido bem-sucedido. Retorna os detalhes da conexão de rede virtual do hub recuperada.
Other Status Codes

CloudError

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

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

HubVirtualNetworkConnectionPut

Pedido de amostra

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"
      }
    }
  }
}

Resposta da amostra

Código de estado:
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"
      }
    }
  }
}
Código de estado:
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

Name 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 anunciar as rotas.
ProvisioningState

O estado de provisionamento atual.
RoutingConfiguration

Configuração de Roteamento indicando 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 subrecurso.
VnetLocalRouteOverrideCriteria

Parâmetro que determina se o NVA no spoke vnet é ignorado para o tráfego com destino no spoke vnet.
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.

Name Tipo Description
error

CloudErrorBody

Corpo do erro na nuvem.

CloudErrorBody

Uma resposta de erro do serviço.

Name Tipo Description
code

string

Um identificador para o erro. Os códigos são invariantes e destinam-se a ser consumidos programaticamente.
details

CloudErrorBody[]

Uma lista de detalhes adicionais sobre o erro.
message

string

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

string

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

HubVirtualNetworkConnection

Recurso HubVirtualNetworkConnection.

Name Tipo Description
etag

string

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

string

ID do recurso.
name

string

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

boolean

Preterido: VirtualHub para RemoteVnet transitam para habilitado ou não.
properties.allowRemoteVnetToUseHubVnetGateways

boolean

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

boolean

Habilite a segurança na 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 indica as tabelas de rotas associadas e propagadas nessa conexão.

PropagatedRouteTable

A lista de RouteTables para anunciar as rotas.

Name 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.

Name Tipo Description
Deleting

string

Failed

string

Succeeded

string

Updating

string

RoutingConfiguration

Configuração de Roteamento indicando as tabelas de rotas associadas e propagadas para essa conexão.

Name Tipo Description
associatedRouteTable

SubResource

A id do recurso RouteTable associada a esta RoutingConfiguration.
inboundRouteMap

SubResource

A id de recurso do RouteMap associada a esta RoutingConfiguration para rotas aprendidas de entrada.
outboundRouteMap

SubResource

A id de recurso do RouteMap associada a esta RoutingConfiguration para rotas anunciadas de saída.
propagatedRouteTables

PropagatedRouteTable

A lista de RouteTables para 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.

Name Tipo Description
addressPrefixes

string[]

Lista de todos os prefixos de endereço.
name

string

O nome do StaticRoute que é exclusivo dentro de 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.

Name Tipo Description
propagateStaticRoutes

boolean

Booleano indicando se as rotas estáticas nesta 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 o NVA na vnet spoke é ignorado para o tráfego com destino em spoke.

SubResource

Referência a outro subrecurso.

Name Tipo Description
id

string

ID do recurso.

VnetLocalRouteOverrideCriteria

Parâmetro que determina se o NVA no spoke vnet é ignorado para o tráfego com destino no spoke vnet.

Name Tipo Description
Contains

string

Equal

string

VnetRoute

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

Name Tipo Description
bgpConnections

SubResource[]

A lista de referências a objetos HubBgpConnection.
staticRoutes

StaticRoute[]

Lista de todas as rotas estáticas.
staticRoutesConfig

StaticRoutesConfig

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