Hub Virtual Network Connections - Create Or Update
Создает подключение к центральной виртуальной сети, если оно не существует, иначе обновляет существующее.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualHubs/{virtualHubName}/hubVirtualNetworkConnections/{connectionName}?api-version=2023-09-01
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
connection
|
path | True |
string |
Имя HubVirtualNetworkConnection. |
resource
|
path | True |
string |
Имя группы ресурсов HubVirtualNetworkConnection. |
subscription
|
path | True |
string |
Учетные данные подписки, которые однозначно идентифицируют подписку Microsoft Azure. Идентификатор подписки формирует часть URI для каждого вызова службы. |
virtual
|
path | True |
string |
Имя Виртуального концентратора. |
api-version
|
query | True |
string |
Версия API клиента. |
Текст запроса
Имя | Тип | Описание |
---|---|---|
id |
string |
Идентификатор ресурса. |
name |
string |
Имя ресурса, уникального в пределах группы ресурсов. Это имя можно использовать для доступа к ресурсу. |
properties.allowHubToRemoteVnetTransit |
boolean |
Нерекомендуемый: транзит Между Виртуальным хубом и RemoteVnet с включенным или нет. |
properties.allowRemoteVnetToUseHubVnetGateways |
boolean |
Не рекомендуется: разрешить RemoteVnet использовать шлюзы Виртуального концентратора. |
properties.enableInternetSecurity |
boolean |
Включите безопасность в Интернете. |
properties.remoteVirtualNetwork |
Ссылка на удаленную виртуальную сеть. |
|
properties.routingConfiguration |
Конфигурация маршрутизации, указывающая связанные и распространяемые таблицы маршрутов для этого подключения. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Запрос выполнен успешно. Возвращает сведения о созданном или обновленном подключении к центральной виртуальной сети. |
|
201 Created |
Запрос выполнен успешно. Возвращает сведения о полученном подключении к центральной виртуальной сети. |
|
Other Status Codes |
Ответ об ошибке, описывающий причину сбоя операции. |
Безопасность
azure_auth
Поток OAuth2 в Azure Active Directory.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Имя | Описание |
---|---|
user_impersonation | олицетворения учетной записи пользователя |
Примеры
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
{
"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"
}
}
}
}
Определения
Имя | Описание |
---|---|
Cloud |
Ответ об ошибке от службы. |
Cloud |
Ответ об ошибке от службы. |
Hub |
Ресурс HubVirtualNetworkConnection. |
Propagated |
Список таблиц RouteTable для объявления маршрутов. |
Provisioning |
Текущее состояние подготовки. |
Routing |
Конфигурация маршрутизации, указывающая связанные и распространяемые таблицы маршрутов для этого подключения. |
Static |
Список всех статических маршрутов. |
Static |
Конфигурация статических маршрутов в этом HubVnetConnectionНастройка статических маршрутов в этом HubVnetConnection. |
Sub |
Ссылка на другой подресурс. |
Vnet |
Параметр, определяющий, пропускается ли NVA в периферийной виртуальной сети для трафика с назначением в периферийной виртуальной сети. |
Vnet |
Список маршрутов, управляющих маршрутизацией из VirtualHub в подключение к виртуальной сети. |
CloudError
Ответ об ошибке от службы.
Имя | Тип | Описание |
---|---|---|
error |
Текст ошибки облака. |
CloudErrorBody
Ответ об ошибке от службы.
Имя | Тип | Описание |
---|---|---|
code |
string |
Идентификатор ошибки. Коды инвариантны и предназначены для программного использования. |
details |
Список дополнительных сведений об ошибке. |
|
message |
string |
Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе. |
target |
string |
Целевой объект конкретной ошибки. Например, имя свойства в ошибке. |
HubVirtualNetworkConnection
Ресурс HubVirtualNetworkConnection.
Имя | Тип | Описание |
---|---|---|
etag |
string |
Уникальная строка, доступная только для чтения, которая изменяется при каждом обновлении ресурса. |
id |
string |
Идентификатор ресурса. |
name |
string |
Имя ресурса, уникального в пределах группы ресурсов. Это имя можно использовать для доступа к ресурсу. |
properties.allowHubToRemoteVnetTransit |
boolean |
Нерекомендуемый: транзит Между Виртуальным хубом и RemoteVnet с включенным или нет. |
properties.allowRemoteVnetToUseHubVnetGateways |
boolean |
Не рекомендуется: разрешить RemoteVnet использовать шлюзы Виртуального концентратора. |
properties.enableInternetSecurity |
boolean |
Включите безопасность в Интернете. |
properties.provisioningState |
Состояние подготовки ресурса подключения к виртуальной сети концентратора. |
|
properties.remoteVirtualNetwork |
Ссылка на удаленную виртуальную сеть. |
|
properties.routingConfiguration |
Конфигурация маршрутизации, указывающая связанные и распространяемые таблицы маршрутов для этого подключения. |
PropagatedRouteTable
Список таблиц RouteTable для объявления маршрутов.
Имя | Тип | Описание |
---|---|---|
ids |
Список идентификаторов ресурсов всех таблиц RouteTable. |
|
labels |
string[] |
Список меток. |
ProvisioningState
Текущее состояние подготовки.
Имя | Тип | Описание |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
RoutingConfiguration
Конфигурация маршрутизации, указывающая связанные и распространяемые таблицы маршрутов для этого подключения.
Имя | Тип | Описание |
---|---|---|
associatedRouteTable |
Идентификатор ресурса RouteTable, связанный с данной routingConfiguration. |
|
inboundRouteMap |
Идентификатор ресурса RouteMap, связанного с данной routingConfiguration для входящие изученные маршруты. |
|
outboundRouteMap |
Идентификатор ресурса ОбъектаRouteMap, связанного с данной конфигурацией маршрутизации для исходящих объявленных маршрутов. |
|
propagatedRouteTables |
Список таблиц RouteTable для объявления маршрутов. |
|
vnetRoutes |
Список маршрутов, управляющих маршрутизацией из VirtualHub в подключение к виртуальной сети. |
StaticRoute
Список всех статических маршрутов.
Имя | Тип | Описание |
---|---|---|
addressPrefixes |
string[] |
Список всех префиксов адресов. |
name |
string |
Имя StaticRoute, уникальное в пределах VnetRoute. |
nextHopIpAddress |
string |
IP-адрес следующего прыжка. |
StaticRoutesConfig
Конфигурация статических маршрутов в этом HubVnetConnectionНастройка статических маршрутов в этом HubVnetConnection.
Имя | Тип | Описание |
---|---|---|
propagateStaticRoutes |
boolean |
Логическое значение, указывающее, распространяется ли автоматически статические маршруты в этом соединении в таблицы маршрутизации, в которые распространяется это соединение. |
vnetLocalRouteOverrideCriteria |
Параметр, определяющий, пропускается ли NVA в периферийной виртуальной сети для трафика с назначением в периферийной сети. |
SubResource
Ссылка на другой подресурс.
Имя | Тип | Описание |
---|---|---|
id |
string |
Идентификатор ресурса. |
VnetLocalRouteOverrideCriteria
Параметр, определяющий, пропускается ли NVA в периферийной виртуальной сети для трафика с назначением в периферийной виртуальной сети.
Имя | Тип | Описание |
---|---|---|
Contains |
string |
|
Equal |
string |
VnetRoute
Список маршрутов, управляющих маршрутизацией из VirtualHub в подключение к виртуальной сети.
Имя | Тип | Описание |
---|---|---|
bgpConnections |
Список ссылок на объекты HubBgpConnection. |
|
staticRoutes |
Список всех статических маршрутов. |
|
staticRoutesConfig |
Настройка статических маршрутов в этом HubVnetConnection. |