Поделиться через


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

Имя В Обязательно Тип Описание
connectionName
path True

string

Имя HubVirtualNetworkConnection.

resourceGroupName
path True

string

Имя группы ресурсов HubVirtualNetworkConnection.

subscriptionId
path True

string

Учетные данные подписки, которые однозначно идентифицируют подписку Microsoft Azure. Идентификатор подписки формирует часть URI для каждого вызова службы.

virtualHubName
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

SubResource

Ссылка на удаленную виртуальную сеть.

properties.routingConfiguration

RoutingConfiguration

Конфигурация маршрутизации, указывающая связанные и распространяемые таблицы маршрутов для этого подключения.

Ответы

Имя Тип Описание
200 OK

HubVirtualNetworkConnection

Запрос выполнен успешно. Возвращает сведения о созданном или обновленном подключении к центральной виртуальной сети.

201 Created

HubVirtualNetworkConnection

Запрос выполнен успешно. Возвращает сведения о полученном подключении к центральной виртуальной сети.

Other Status Codes

CloudError

Ответ об ошибке, описывающий причину сбоя операции.

Безопасность

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

Определения

Имя Описание
CloudError

Ответ об ошибке от службы.

CloudErrorBody

Ответ об ошибке от службы.

HubVirtualNetworkConnection

Ресурс HubVirtualNetworkConnection.

PropagatedRouteTable

Список таблиц RouteTable для объявления маршрутов.

ProvisioningState

Текущее состояние подготовки.

RoutingConfiguration

Конфигурация маршрутизации, указывающая связанные и распространяемые таблицы маршрутов для этого подключения.

StaticRoute

Список всех статических маршрутов.

StaticRoutesConfig

Конфигурация статических маршрутов в этом HubVnetConnectionНастройка статических маршрутов в этом HubVnetConnection.

SubResource

Ссылка на другой подресурс.

VnetLocalRouteOverrideCriteria

Параметр, определяющий, пропускается ли NVA в периферийной виртуальной сети для трафика с назначением в периферийной виртуальной сети.

VnetRoute

Список маршрутов, управляющих маршрутизацией из VirtualHub в подключение к виртуальной сети.

CloudError

Ответ об ошибке от службы.

Имя Тип Описание
error

CloudErrorBody

Текст ошибки облака.

CloudErrorBody

Ответ об ошибке от службы.

Имя Тип Описание
code

string

Идентификатор ошибки. Коды инвариантны и предназначены для программного использования.

details

CloudErrorBody[]

Список дополнительных сведений об ошибке.

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

ProvisioningState

Состояние подготовки ресурса подключения к виртуальной сети концентратора.

properties.remoteVirtualNetwork

SubResource

Ссылка на удаленную виртуальную сеть.

properties.routingConfiguration

RoutingConfiguration

Конфигурация маршрутизации, указывающая связанные и распространяемые таблицы маршрутов для этого подключения.

PropagatedRouteTable

Список таблиц RouteTable для объявления маршрутов.

Имя Тип Описание
ids

SubResource[]

Список идентификаторов ресурсов всех таблиц RouteTable.

labels

string[]

Список меток.

ProvisioningState

Текущее состояние подготовки.

Имя Тип Описание
Deleting

string

Failed

string

Succeeded

string

Updating

string

RoutingConfiguration

Конфигурация маршрутизации, указывающая связанные и распространяемые таблицы маршрутов для этого подключения.

Имя Тип Описание
associatedRouteTable

SubResource

Идентификатор ресурса RouteTable, связанный с данной routingConfiguration.

inboundRouteMap

SubResource

Идентификатор ресурса RouteMap, связанного с данной routingConfiguration для входящие изученные маршруты.

outboundRouteMap

SubResource

Идентификатор ресурса ОбъектаRouteMap, связанного с данной конфигурацией маршрутизации для исходящих объявленных маршрутов.

propagatedRouteTables

PropagatedRouteTable

Список таблиц RouteTable для объявления маршрутов.

vnetRoutes

VnetRoute

Список маршрутов, управляющих маршрутизацией из VirtualHub в подключение к виртуальной сети.

StaticRoute

Список всех статических маршрутов.

Имя Тип Описание
addressPrefixes

string[]

Список всех префиксов адресов.

name

string

Имя StaticRoute, уникальное в пределах VnetRoute.

nextHopIpAddress

string

IP-адрес следующего прыжка.

StaticRoutesConfig

Конфигурация статических маршрутов в этом HubVnetConnectionНастройка статических маршрутов в этом HubVnetConnection.

Имя Тип Описание
propagateStaticRoutes

boolean

Логическое значение, указывающее, распространяется ли автоматически статические маршруты в этом соединении в таблицы маршрутизации, в которые распространяется это соединение.

vnetLocalRouteOverrideCriteria

VnetLocalRouteOverrideCriteria

Параметр, определяющий, пропускается ли NVA в периферийной виртуальной сети для трафика с назначением в периферийной сети.

SubResource

Ссылка на другой подресурс.

Имя Тип Описание
id

string

Идентификатор ресурса.

VnetLocalRouteOverrideCriteria

Параметр, определяющий, пропускается ли NVA в периферийной виртуальной сети для трафика с назначением в периферийной виртуальной сети.

Имя Тип Описание
Contains

string

Equal

string

VnetRoute

Список маршрутов, управляющих маршрутизацией из VirtualHub в подключение к виртуальной сети.

Имя Тип Описание
bgpConnections

SubResource[]

Список ссылок на объекты HubBgpConnection.

staticRoutes

StaticRoute[]

Список всех статических маршрутов.

staticRoutesConfig

StaticRoutesConfig

Настройка статических маршрутов в этом HubVnetConnection.