Hub Virtual Network Connections - Create Or Update
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 de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
connection
|
path | True |
string |
O nome do HubVirtualNetworkConnection. |
resource
|
path | True |
string |
O nome do grupo de recursos do HubVirtualNetworkConnection. |
subscription
|
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. |
virtual
|
path | True |
string |
O nome do VirtualHub. |
api-version
|
query | True |
string |
Versão da API do cliente. |
Corpo da solicitação
Nome | Tipo | Description |
---|---|---|
id |
string |
ID do recurso. |
name |
string |
O nome do recurso exclusivo em um grupo de recursos. Esse nome pode ser usado para acessar o recurso. |
properties.allowHubToRemoteVnetTransit |
boolean |
Preterido: o trânsito do VirtualHub para RemoteVnet está 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 |
Referência à rede virtual remota. |
|
properties.routingConfiguration |
A Configuração de Roteamento que indica as tabelas de rotas associadas e propagadas nessa conexão. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
Solicitação bem-sucedida. Retorna os detalhes da conexão de rede virtual do hub criada ou atualizada. |
|
201 Created |
Solicitação bem-sucedida. Retorna os detalhes da conexão de rede virtual do hub recuperada. |
|
Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory.
Tipo:
oauth2
Flow:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Escopos
Nome | Description |
---|---|
user_impersonation | representar sua conta de usuário |
Exemplos
HubVirtualNetworkConnectionPut
Solicitação de exemplo
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 de exemplo
{
"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"
}
}
}
}
{
"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 |
---|---|
Cloud |
Uma resposta de erro do serviço. |
Cloud |
Uma resposta de erro do serviço. |
Hub |
Recurso HubVirtualNetworkConnection. |
Propagated |
A lista de RouteTables para a qual anunciar as rotas. |
Provisioning |
O estado de provisionamento atual. |
Routing |
Configuração de roteamento que indica as tabelas de rotas associadas e propagadas para essa conexão. |
Static |
Lista de todas as rotas estáticas. |
Static |
Configuração para rotas estáticas neste HubVnetConnectionConfiguration para rotas estáticas neste HubVnetConnection. |
Sub |
Referência a outro sub-recurso. |
Vnet |
Parâmetro que determina se a VNET NVA no spoke é ignorada para tráfego com destino na vnet spoke. |
Vnet |
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 |
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 |
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 exclusivo em um grupo de recursos. Esse nome pode ser usado para acessar o recurso. |
properties.allowHubToRemoteVnetTransit |
boolean |
Preterido: o trânsito do VirtualHub para RemoteVnet está 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 |
O estado de provisionamento do recurso de conexão de rede virtual do hub. |
|
properties.remoteVirtualNetwork |
Referência à rede virtual remota. |
|
properties.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 |
A lista de IDs de recurso 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 |
A ID do recurso RouteTable associada a esse RoutingConfiguration. |
|
inboundRouteMap |
A ID de recurso do RouteMap associado a esse RoutingConfiguration para rotas aprendidas de entrada. |
|
outboundRouteMap |
A ID de recurso do TheRouteMap associada a esse RoutingConfiguration para rotas anunciadas de saída. |
|
propagatedRouteTables |
A lista de RouteTables para a qual anunciar as rotas. |
|
vnetRoutes |
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 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 |
Parâmetro que determina se a rede virtual NVA no 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 VNET NVA no 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 |
A lista de referências a objetos HubBgpConnection. |
|
staticRoutes |
Lista de todas as rotas estáticas. |
|
staticRoutesConfig |
Configuração para rotas estáticas neste HubVnetConnection. |