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 |
---|---|---|---|---|
connection
|
path | True |
string |
HubVirtualNetworkConnection의 이름입니다. |
resource
|
path | True |
string |
HubVirtualNetworkConnection의 리소스 그룹 이름입니다. |
subscription
|
path | True |
string |
Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 일부를 형성합니다. |
virtual
|
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 |
원격 가상 네트워크에 대한 참조입니다. |
|
properties.routingConfiguration |
이 연결에 연결된 경로 테이블과 전파된 경로 테이블을 나타내는 라우팅 구성입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
요청이 성공했습니다. 만들거나 업데이트한 허브 가상 네트워크 연결의 세부 정보를 반환합니다. |
|
201 Created |
요청이 성공했습니다. 검색된 허브 가상 네트워크 연결의 세부 정보를 반환합니다. |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
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 |
---|---|
Cloud |
서비스의 오류 응답입니다. |
Cloud |
서비스의 오류 응답입니다. |
Hub |
HubVirtualNetworkConnection 리소스입니다. |
Propagated |
경로를 보급할 RouteTable 목록입니다. |
Provisioning |
현재 프로비저닝 상태입니다. |
Routing |
이 연결에 대해 연결된 경로 테이블과 전파된 경로 테이블을 나타내는 라우팅 구성입니다. |
Static |
모든 정적 경로 목록입니다. |
Static |
이 HubVnetConnection의 정적 경로에 대한 이 HubVnetConnectionConfiguration의 정적 경로에 대한 구성입니다. |
Sub |
다른 하위 리소스에 대한 참조입니다. |
Vnet |
스포크 vnet의 NVA가 스포크 vnet의 대상이 있는 트래픽에 대해 바이패스되는지 여부를 결정하는 매개 변수입니다. |
Vnet |
VirtualHub에서 가상 네트워크 연결로 라우팅을 제어하는 경로 목록입니다. |
CloudError
서비스의 오류 응답입니다.
Name | 형식 | Description |
---|---|---|
error |
클라우드 오류 본문입니다. |
CloudErrorBody
서비스의 오류 응답입니다.
Name | 형식 | Description |
---|---|---|
code |
string |
오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다. |
details |
오류에 대한 추가 세부 정보 목록입니다. |
|
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 |
허브 가상 네트워크 연결 리소스의 프로비전 상태입니다. |
|
properties.remoteVirtualNetwork |
원격 가상 네트워크에 대한 참조입니다. |
|
properties.routingConfiguration |
이 연결에 연결된 경로 테이블과 전파된 경로 테이블을 나타내는 라우팅 구성입니다. |
PropagatedRouteTable
경로를 보급할 RouteTable 목록입니다.
Name | 형식 | Description |
---|---|---|
ids |
모든 RouteTable의 리소스 ID 목록입니다. |
|
labels |
string[] |
레이블 목록입니다. |
ProvisioningState
현재 프로비저닝 상태입니다.
Name | 형식 | Description |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
RoutingConfiguration
이 연결에 대해 연결된 경로 테이블과 전파된 경로 테이블을 나타내는 라우팅 구성입니다.
Name | 형식 | Description |
---|---|---|
associatedRouteTable |
이 RoutingConfiguration과 연결된 리소스 ID RouteTable입니다. |
|
inboundRouteMap |
인바운드 학습 경로에 대한 이 RoutingConfiguration과 연결된 RouteMap의 리소스 ID입니다. |
|
outboundRouteMap |
아웃바운드 보급 경로에 대해 이 RoutingConfiguration과 연결된RouteMap의 리소스 ID입니다. |
|
propagatedRouteTables |
경로를 보급할 RouteTable 목록입니다. |
|
vnetRoutes |
VirtualHub에서 가상 네트워크 연결로 라우팅을 제어하는 경로 목록입니다. |
StaticRoute
모든 정적 경로 목록입니다.
Name | 형식 | Description |
---|---|---|
addressPrefixes |
string[] |
모든 주소 접두사 목록입니다. |
name |
string |
VnetRoute 내에서 고유한 StaticRoute의 이름입니다. |
nextHopIpAddress |
string |
다음 홉의 IP 주소입니다. |
StaticRoutesConfig
이 HubVnetConnection의 정적 경로에 대한 이 HubVnetConnectionConfiguration의 정적 경로에 대한 구성입니다.
Name | 형식 | Description |
---|---|---|
propagateStaticRoutes |
boolean |
이 연결의 정적 경로가 이 연결이 전파하는 경로 테이블에 자동으로 전파되는지 여부를 나타내는 부울입니다. |
vnetLocalRouteOverrideCriteria |
스포크 vnet의 NVA가 스포크에서 대상이 있는 트래픽에 대해 바이패스되는지 여부를 결정하는 매개 변수입니다. |
SubResource
다른 하위 리소스에 대한 참조입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스 ID입니다. |
VnetLocalRouteOverrideCriteria
스포크 vnet의 NVA가 스포크 vnet의 대상이 있는 트래픽에 대해 바이패스되는지 여부를 결정하는 매개 변수입니다.
Name | 형식 | Description |
---|---|---|
Contains |
string |
|
Equal |
string |
VnetRoute
VirtualHub에서 가상 네트워크 연결로 라우팅을 제어하는 경로 목록입니다.
Name | 형식 | Description |
---|---|---|
bgpConnections |
HubBgpConnection 개체에 대한 참조 목록입니다. |
|
staticRoutes |
모든 정적 경로 목록입니다. |
|
staticRoutesConfig |
이 HubVnetConnection의 정적 경로에 대한 구성입니다. |