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=2024-05-01
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
connection
|
path | True |
string |
Имя HubVirtualNetworkConnection. |
resource
|
path | True |
string |
Имя группы ресурсов HubVirtualNetworkConnection. |
subscription
|
path | True |
string |
Учетные данные подписки, которые однозначно определяют подписку Microsoft Azure. Идентификатор подписки входит в состав URI для каждого вызова службы. |
virtual
|
path | True |
string |
Имя ВиртуальногоHub. |
api-version
|
query | True |
string |
Версия КЛИЕНТСКОго API. |
Текст запроса
Имя | Тип | Описание |
---|---|---|
id |
string |
Идентификатор ресурса. |
name |
string |
Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. |
properties.allowHubToRemoteVnetTransit |
boolean |
Не рекомендуется: ВиртуальныйHub в 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.
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
Имя | Описание |
---|---|
user_impersonation | олицетворения учетной записи пользователя |
Примеры
HubVirtualNetworkConnectionPut
Образец запроса
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"
}
}
}
}
Пример ответа
{
"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 |
Список маршрутов для объявления маршрутов. |
Provisioning |
Текущее состояние подготовки. |
Routing |
Конфигурация маршрутизации, указывающая связанные и распространяемые таблицы маршрутов для этого подключения. |
Static |
Список всех статических маршрутов. |
Static |
Настройка статических маршрутов в этой конфигурации HubVnetConnectionConfiguration для статических маршрутов в этом 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 |
Не рекомендуется: ВиртуальныйHub в RemoteVnet транзит включен или нет. |
properties.allowRemoteVnetToUseHubVnetGateways |
boolean |
Не рекомендуется: разрешить RemoteVnet использовать шлюзы Виртуального концентратора. |
properties.enableInternetSecurity |
boolean |
Включите интернет-безопасность. |
properties.provisioningState |
Состояние подготовки ресурса подключения к виртуальной сети концентратора. |
|
properties.remoteVirtualNetwork |
Ссылка на удаленную виртуальную сеть. |
|
properties.routingConfiguration |
Конфигурация маршрутизации, указывающая связанные и распространяемые таблицы маршрутов для этого подключения. |
PropagatedRouteTable
Список маршрутов для объявления маршрутов.
Имя | Тип | Описание |
---|---|---|
ids |
Список идентификаторов ресурсов всех маршрутов. |
|
labels |
string[] |
Список меток. |
ProvisioningState
Текущее состояние подготовки.
Значение | Описание |
---|---|
Deleting | |
Failed | |
Succeeded | |
Updating |
RoutingConfiguration
Конфигурация маршрутизации, указывающая связанные и распространяемые таблицы маршрутов для этого подключения.
Имя | Тип | Описание |
---|---|---|
associatedRouteTable |
Идентификатор ресурса RouteTable, связанный с этой конфигурацией маршрутизации. |
|
inboundRouteMap |
Идентификатор ресурса RouteMap, связанный с этой маршрутизациейConfiguration для входящих наученных маршрутов. |
|
outboundRouteMap |
Идентификатор ресурса объектаRouteMap, связанного с этой маршрутизациейConfiguration для исходящих объявленных маршрутов. |
|
propagatedRouteTables |
Список маршрутов для объявления маршрутов. |
|
vnetRoutes |
Список маршрутов, которые управляют маршрутизацией из VirtualHub в подключение к виртуальной сети. |
StaticRoute
Список всех статических маршрутов.
Имя | Тип | Описание |
---|---|---|
addressPrefixes |
string[] |
Список всех префиксов адресов. |
name |
string |
Имя staticRoute, уникальное в виртуальной сети. |
nextHopIpAddress |
string |
Ip-адрес следующего прыжка. |
StaticRoutesConfig
Настройка статических маршрутов в этой конфигурации HubVnetConnectionConfiguration для статических маршрутов в этом HubVnetConnection.
Имя | Тип | Описание |
---|---|---|
propagateStaticRoutes |
boolean |
Логическое значение, указывающее, распространяются ли статические маршруты в этом соединении автоматически в таблицы маршрутов, к которым распространяется это соединение. |
vnetLocalRouteOverrideCriteria |
Параметр, определяющий, пропускается ли NVA в периферийной виртуальной сети для трафика с назначением в периферийной сети. |
SubResource
Ссылка на другой подресурс.
Имя | Тип | Описание |
---|---|---|
id |
string |
Идентификатор ресурса. |
VnetLocalRouteOverrideCriteria
Параметр определяет, пропускается ли NVA в периферийной виртуальной сети для трафика с назначением в периферийной виртуальной сети.
Значение | Описание |
---|---|
Contains | |
Equal |
VnetRoute
Список маршрутов, которые управляют маршрутизацией из VirtualHub в подключение к виртуальной сети.
Имя | Тип | Описание |
---|---|---|
bgpConnections |
Список ссылок на объекты HubBgpConnection. |
|
staticRoutes |
Список всех статических маршрутов. |
|
staticRoutesConfig |
Конфигурация статических маршрутов в этом HubVnetConnection. |