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


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

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

string

Имя HubVirtualNetworkConnection.

resourceGroupName
path True

string

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

subscriptionId
path True

string

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

virtualHubName
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

SubResource

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

properties.routingConfiguration

RoutingConfiguration

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

Ответы

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

HubVirtualNetworkConnection

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

201 Created

HubVirtualNetworkConnection

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

Other Status Codes

CloudError

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

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

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

Определения

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

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

CloudErrorBody

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

HubVirtualNetworkConnection

Ресурс HubVirtualNetworkConnection.

PropagatedRouteTable

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

ProvisioningState

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

RoutingConfiguration

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

StaticRoute

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

StaticRoutesConfig

Настройка статических маршрутов в этой конфигурации HubVnetConnectionConfiguration для статических маршрутов в этом 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

Не рекомендуется: ВиртуальныйHub в RemoteVnet транзит включен или нет.

properties.allowRemoteVnetToUseHubVnetGateways

boolean

Не рекомендуется: разрешить RemoteVnet использовать шлюзы Виртуального концентратора.

properties.enableInternetSecurity

boolean

Включите интернет-безопасность.

properties.provisioningState

ProvisioningState

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

properties.remoteVirtualNetwork

SubResource

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

properties.routingConfiguration

RoutingConfiguration

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

PropagatedRouteTable

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

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

SubResource[]

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

labels

string[]

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

ProvisioningState

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

Значение Описание
Deleting
Failed
Succeeded
Updating

RoutingConfiguration

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

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

SubResource

Идентификатор ресурса RouteTable, связанный с этой конфигурацией маршрутизации.

inboundRouteMap

SubResource

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

outboundRouteMap

SubResource

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

propagatedRouteTables

PropagatedRouteTable

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

vnetRoutes

VnetRoute

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

StaticRoute

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

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

string[]

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

name

string

Имя staticRoute, уникальное в виртуальной сети.

nextHopIpAddress

string

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

StaticRoutesConfig

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

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

boolean

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

vnetLocalRouteOverrideCriteria

VnetLocalRouteOverrideCriteria

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

SubResource

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

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

string

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

VnetLocalRouteOverrideCriteria

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

Значение Описание
Contains
Equal

VnetRoute

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

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

SubResource[]

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

staticRoutes

StaticRoute[]

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

staticRoutesConfig

StaticRoutesConfig

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