다음을 통해 공유


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 매개 변수

Name In(다음 안에) 필수 형식 Description
connectionName
path True

string

HubVirtualNetworkConnection의 이름입니다.

resourceGroupName
path True

string

HubVirtualNetworkConnection의 리소스 그룹 이름입니다.

subscriptionId
path True

string

Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 일부를 형성합니다.

virtualHubName
path True

string

VirtualHub의 이름입니다.

api-version
query True

string

클라이언트 API 버전입니다.

요청 본문

Name 형식 Description
id

string

리소스 ID입니다.

name

string

리소스 그룹 내에서 고유한 리소스의 이름입니다. 이 이름은 리소스에 액세스하는 데 사용할 수 있습니다.

properties.allowHubToRemoteVnetTransit

boolean

사용되지 않음: VirtualHub에서 RemoteVnet으로의 전송을 사용하도록 설정하거나 사용하지 않습니다.

properties.allowRemoteVnetToUseHubVnetGateways

boolean

사용되지 않음: RemoteVnet에서 Virtual Hub의 게이트웨이를 사용하도록 허용합니다.

properties.enableInternetSecurity

boolean

인터넷 보안을 사용하도록 설정합니다.

properties.remoteVirtualNetwork

SubResource

원격 가상 네트워크에 대한 참조입니다.

properties.routingConfiguration

RoutingConfiguration

이 연결에 연결된 경로 테이블과 전파된 경로 테이블을 나타내는 라우팅 구성입니다.

응답

Name 형식 Description
200 OK

HubVirtualNetworkConnection

요청이 성공했습니다. 만들거나 업데이트한 허브 가상 네트워크 연결의 세부 정보를 반환합니다.

201 Created

HubVirtualNetworkConnection

요청이 성공했습니다. 검색된 허브 가상 네트워크 연결의 세부 정보를 반환합니다.

Other Status Codes

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

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

정의

Name Description
CloudError

서비스의 오류 응답입니다.

CloudErrorBody

서비스의 오류 응답입니다.

HubVirtualNetworkConnection

HubVirtualNetworkConnection 리소스입니다.

PropagatedRouteTable

경로를 보급할 RouteTable 목록입니다.

ProvisioningState

현재 프로비저닝 상태입니다.

RoutingConfiguration

이 연결에 대해 연결된 경로 테이블과 전파된 경로 테이블을 나타내는 라우팅 구성입니다.

StaticRoute

모든 정적 경로 목록입니다.

StaticRoutesConfig

이 HubVnetConnection의 정적 경로에 대한 이 HubVnetConnectionConfiguration의 정적 경로에 대한 구성입니다.

SubResource

다른 하위 리소스에 대한 참조입니다.

VnetLocalRouteOverrideCriteria

스포크 vnet의 NVA가 스포크 vnet의 대상이 있는 트래픽에 대해 바이패스되는지 여부를 결정하는 매개 변수입니다.

VnetRoute

VirtualHub에서 가상 네트워크 연결로 라우팅을 제어하는 경로 목록입니다.

CloudError

서비스의 오류 응답입니다.

Name 형식 Description
error

CloudErrorBody

클라우드 오류 본문입니다.

CloudErrorBody

서비스의 오류 응답입니다.

Name 형식 Description
code

string

오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.

details

CloudErrorBody[]

오류에 대한 추가 세부 정보 목록입니다.

message

string

사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.

target

string

특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다.

HubVirtualNetworkConnection

HubVirtualNetworkConnection 리소스입니다.

Name 형식 Description
etag

string

리소스를 업데이트할 때마다 변경되는 고유한 읽기 전용 문자열입니다.

id

string

리소스 ID입니다.

name

string

리소스 그룹 내에서 고유한 리소스의 이름입니다. 이 이름은 리소스에 액세스하는 데 사용할 수 있습니다.

properties.allowHubToRemoteVnetTransit

boolean

사용되지 않음: VirtualHub에서 RemoteVnet으로의 전송을 사용하도록 설정하거나 사용하지 않습니다.

properties.allowRemoteVnetToUseHubVnetGateways

boolean

사용되지 않음: RemoteVnet에서 Virtual Hub의 게이트웨이를 사용하도록 허용합니다.

properties.enableInternetSecurity

boolean

인터넷 보안을 사용하도록 설정합니다.

properties.provisioningState

ProvisioningState

허브 가상 네트워크 연결 리소스의 프로비전 상태입니다.

properties.remoteVirtualNetwork

SubResource

원격 가상 네트워크에 대한 참조입니다.

properties.routingConfiguration

RoutingConfiguration

이 연결에 연결된 경로 테이블과 전파된 경로 테이블을 나타내는 라우팅 구성입니다.

PropagatedRouteTable

경로를 보급할 RouteTable 목록입니다.

Name 형식 Description
ids

SubResource[]

모든 RouteTable의 리소스 ID 목록입니다.

labels

string[]

레이블 목록입니다.

ProvisioningState

현재 프로비저닝 상태입니다.

Name 형식 Description
Deleting

string

Failed

string

Succeeded

string

Updating

string

RoutingConfiguration

이 연결에 대해 연결된 경로 테이블과 전파된 경로 테이블을 나타내는 라우팅 구성입니다.

Name 형식 Description
associatedRouteTable

SubResource

이 RoutingConfiguration과 연결된 리소스 ID RouteTable입니다.

inboundRouteMap

SubResource

인바운드 학습 경로에 대한 이 RoutingConfiguration과 연결된 RouteMap의 리소스 ID입니다.

outboundRouteMap

SubResource

아웃바운드 보급 경로에 대해 이 RoutingConfiguration과 연결된RouteMap의 리소스 ID입니다.

propagatedRouteTables

PropagatedRouteTable

경로를 보급할 RouteTable 목록입니다.

vnetRoutes

VnetRoute

VirtualHub에서 가상 네트워크 연결로 라우팅을 제어하는 경로 목록입니다.

StaticRoute

모든 정적 경로 목록입니다.

Name 형식 Description
addressPrefixes

string[]

모든 주소 접두사 목록입니다.

name

string

VnetRoute 내에서 고유한 StaticRoute의 이름입니다.

nextHopIpAddress

string

다음 홉의 IP 주소입니다.

StaticRoutesConfig

이 HubVnetConnection의 정적 경로에 대한 이 HubVnetConnectionConfiguration의 정적 경로에 대한 구성입니다.

Name 형식 Description
propagateStaticRoutes

boolean

이 연결의 정적 경로가 이 연결이 전파하는 경로 테이블에 자동으로 전파되는지 여부를 나타내는 부울입니다.

vnetLocalRouteOverrideCriteria

VnetLocalRouteOverrideCriteria

스포크 vnet의 NVA가 스포크에서 대상이 있는 트래픽에 대해 바이패스되는지 여부를 결정하는 매개 변수입니다.

SubResource

다른 하위 리소스에 대한 참조입니다.

Name 형식 Description
id

string

리소스 ID입니다.

VnetLocalRouteOverrideCriteria

스포크 vnet의 NVA가 스포크 vnet의 대상이 있는 트래픽에 대해 바이패스되는지 여부를 결정하는 매개 변수입니다.

Name 형식 Description
Contains

string

Equal

string

VnetRoute

VirtualHub에서 가상 네트워크 연결로 라우팅을 제어하는 경로 목록입니다.

Name 형식 Description
bgpConnections

SubResource[]

HubBgpConnection 개체에 대한 참조 목록입니다.

staticRoutes

StaticRoute[]

모든 정적 경로 목록입니다.

staticRoutesConfig

StaticRoutesConfig

이 HubVnetConnection의 정적 경로에 대한 구성입니다.