Microsoft.Network virtualNetworks/virtualNetworkPeerings
- 최신
- 2024-03-01
- 2024-01-01
- 2023-11-01
- 2023-09-01
- 2023-06-01
- 2023-05-01
- 2023-04-01
- 2023-02-01
- 2022-11-01
- 2022-09-01
- 2022-07-01
- 2022-05-01
- 2022-01-01
- 2021-08-01
- 2021-05-01
- 2021-03-01
- 2021-02-01
- 2020-11-01
- 2020-08-01
- 2020-07-01
- 2020-06-01
- 2020-05-01
- 2020-04-01
- 2020-03-01
- 2019-12-01
- 2019-11-01
- 2019-09-01
- 2019-08-01
- 2019-07-01
- 2019-06-01
- 2019-04-01
- 2019-02-01
- 2018-12-01
- 2018-11-01
- 2018-10-01
- 2018-08-01
- 2018-07-01
- 2018-06-01
- 2018-04-01
- 2018-02-01
- 2018-01-01
- 2017-11-01
- 2017-10-01
- 2017-09-01
- 2017-08-01
- 2017-06-01
- 2017-03-30
- 2017-03-01
- 2016-12-01
- 2016-09-01
- 2016-06-01
Bicep 리소스 정의
virtualNetworks/virtualNetworkPeerings 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.Network/virtualNetworks/virtualNetworkPeerings 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2024-03-01' = {
name: 'string'
properties: {
allowForwardedTraffic: bool
allowGatewayTransit: bool
allowVirtualNetworkAccess: bool
doNotVerifyRemoteGateways: bool
enableOnlyIPv6Peering: bool
localAddressSpace: {
addressPrefixes: [
'string'
]
}
localSubnetNames: [
'string'
]
localVirtualNetworkAddressSpace: {
addressPrefixes: [
'string'
]
}
peerCompleteVnets: bool
peeringState: 'string'
peeringSyncLevel: 'string'
remoteAddressSpace: {
addressPrefixes: [
'string'
]
}
remoteBgpCommunities: {
virtualNetworkCommunity: 'string'
}
remoteSubnetNames: [
'string'
]
remoteVirtualNetwork: {
id: 'string'
}
remoteVirtualNetworkAddressSpace: {
addressPrefixes: [
'string'
]
}
useRemoteGateways: bool
}
}
속성 값
AddressSpace
| 이름 | 묘사 | 값 |
|---|---|---|
| addressPrefixes | CIDR 표기법으로 이 가상 네트워크에 예약된 주소 블록 목록입니다. | string[] |
Microsoft.Network/virtualNetworks/virtualNetworkPeerings
| 이름 | 묘사 | 값 |
|---|---|---|
| 이름 | 리소스 이름 | string(필수) |
| 부모 | Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다. 자세한 내용은 부모 리소스외부의 자식 리소스 |
형식 리소스의 기호 이름: virtualNetworks |
| 속성 | 가상 네트워크 피어링의 속성입니다. | VirtualNetworkPeeringPropertiesFormat |
SubResource
| 이름 | 묘사 | 값 |
|---|---|---|
| 아이디 | 리소스 ID입니다. | 문자열 |
VirtualNetworkBgpCommunities
| 이름 | 묘사 | 값 |
|---|---|---|
| virtualNetworkCommunity | 가상 네트워크와 연결된 BGP 커뮤니티입니다. | string(필수) |
VirtualNetworkPeeringPropertiesFormat
| 이름 | 묘사 | 값 |
|---|---|---|
| allowForwardedTraffic | 로컬 가상 네트워크의 VM에서 전달된 트래픽이 원격 가상 네트워크에서 허용/허용되지 않는지 여부입니다. | bool |
| allowGatewayTransit | 원격 가상 네트워킹에서 게이트웨이 링크를 사용하여 이 가상 네트워크에 연결할 수 있는 경우 | bool |
| allowVirtualNetworkAccess | 로컬 가상 네트워크 공간의 VM이 원격 가상 네트워크 공간의 VM에 액세스할 수 있는지 여부입니다. | bool |
| doNotVerifyRemoteGateways | 원격 게이트웨이의 프로비저닝 상태를 확인해야 하는 경우 | bool |
| enableOnlyIPv6Peering | 서브넷 피어링을 위해 Ipv6 주소 공간만 피어링되는지 여부입니다. | bool |
| localAddressSpace | 피어되는 로컬 가상 네트워크의 로컬 주소 공간입니다. | AddressSpace |
| localSubnetNames | 원격 가상 네트워크와 피어된 서브넷인 로컬 서브넷 이름 목록입니다. | string[] |
| localVirtualNetworkAddressSpace | 피어된 로컬 가상 네트워크의 현재 로컬 주소 공간입니다. | AddressSpace |
| peerCompleteVnets | 전체 가상 네트워크 주소 공간을 피어로 사용할지 여부입니다. | bool |
| peeringState | 가상 네트워크 피어링의 상태입니다. | '연결됨' '연결 끊김' 'Initiated' |
| peeringSyncLevel | 가상 네트워크 피어링의 피어링 동기화 상태입니다. | 'FullyInSync' 'LocalAndRemoteNotInSync' 'LocalNotInSync' 'RemoteNotInSync' |
| remoteAddressSpace | 원격 가상 네트워크와 피어된 주소 공간에 대한 참조입니다. | AddressSpace |
| remoteBgpCommunities | 원격 가상 네트워크의 Bgp 커뮤니티에 대한 참조입니다. | VirtualNetworkBgpCommunities |
| remoteSubnetNames | 피어된 서브넷인 원격 가상 네트워크의 원격 서브넷 이름 목록입니다. | string[] |
| remoteVirtualNetwork | 원격 가상 네트워크에 대한 참조입니다. 원격 가상 네트워크는 동일하거나 다른 지역(미리 보기)에 있을 수 있습니다. 미리 보기에 등록하고 자세히 알아보려면 여기를 참조하세요(/azure/virtual-network/virtual-network-create-peering). | SubResource |
| remoteVirtualNetworkAddressSpace | 원격 가상 네트워크의 현재 주소 공간에 대한 참조입니다. | AddressSpace |
| useRemoteGateways | 이 가상 네트워크에서 원격 게이트웨이를 사용할 수 있는 경우 플래그가 true로 설정되고 원격 피어링의 allowGatewayTransit도 true이면 가상 네트워크는 전송을 위해 원격 가상 네트워크의 게이트웨이를 사용합니다. 하나의 피어링만 이 플래그를 true로 설정할 수 있습니다. 가상 네트워크에 게이트웨이가 이미 있는 경우 이 플래그를 설정할 수 없습니다. | bool |
빠른 시작 샘플
다음 빠른 시작 샘플은 이 리소스 유형을 배포합니다.
| Bicep 파일 | 묘사 |
|---|---|
| Azure 게임 개발자 Virtual Machine |
Azure 게임 개발자 Virtual Machine에는 Unreal과 같은 라이선스가 부여된 엔진이 포함되어 있습니다. |
| vNet 피어링 사용하여 vNet-vNet 연결 만들기 | 이 템플릿을 사용하면 vNet 피어링을 사용하여 두 개의 vNet을 연결할 수 있습니다. |
| 허브 Virtual Network Bastion 호스트 배포 | 이 템플릿은 피어링이 있는 두 개의 vNet, 허브 vNet의 Bastion 호스트 및 스포크 vNet의 Linux VM을 만듭니다. |
| 단일 지역 내에 있는 두 개의 기존 VNet 피어링 | 이 템플릿을 사용하면 VNet 피어링을 사용하여 동일한 지역의 동일하거나 다른 리소스 그룹에서 두 개의 VNET을 연결할 수 있습니다. |
| 게이트웨이 Load Balancer 연결된 공용 Load Balancer |
이 템플릿을 사용하면 게이트웨이 Load Balancer에 연결된 공용 표준 Load Balancer를 배포할 수 있습니다. 인터넷에서 들어오는 트래픽은 백 엔드 풀에서 NVA(Linux VM)를 사용하여 게이트웨이 Load Balancer로 라우팅됩니다. |
| 허브 & 스포크 토폴로지 Azure Firewall을 DNS 프록시로 사용 | 이 샘플에서는 Azure Firewall을 사용하여 Azure에서 허브-스포크 토폴로지를 배포하는 방법을 보여 줍니다. 허브 가상 네트워크는 가상 네트워크 피어링을 통해 허브 가상 네트워크에 연결된 많은 스포크 가상 네트워크에 대한 연결의 중심 지점 역할을 합니다. |
ARM 템플릿 리소스 정의
virtualNetworks/virtualNetworkPeerings 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.Network/virtualNetworks/virtualNetworkPeerings 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"type": "Microsoft.Network/virtualNetworks/virtualNetworkPeerings",
"apiVersion": "2024-03-01",
"name": "string",
"properties": {
"allowForwardedTraffic": "bool",
"allowGatewayTransit": "bool",
"allowVirtualNetworkAccess": "bool",
"doNotVerifyRemoteGateways": "bool",
"enableOnlyIPv6Peering": "bool",
"localAddressSpace": {
"addressPrefixes": [ "string" ]
},
"localSubnetNames": [ "string" ],
"localVirtualNetworkAddressSpace": {
"addressPrefixes": [ "string" ]
},
"peerCompleteVnets": "bool",
"peeringState": "string",
"peeringSyncLevel": "string",
"remoteAddressSpace": {
"addressPrefixes": [ "string" ]
},
"remoteBgpCommunities": {
"virtualNetworkCommunity": "string"
},
"remoteSubnetNames": [ "string" ],
"remoteVirtualNetwork": {
"id": "string"
},
"remoteVirtualNetworkAddressSpace": {
"addressPrefixes": [ "string" ]
},
"useRemoteGateways": "bool"
}
}
속성 값
AddressSpace
| 이름 | 묘사 | 값 |
|---|---|---|
| addressPrefixes | CIDR 표기법으로 이 가상 네트워크에 예약된 주소 블록 목록입니다. | string[] |
Microsoft.Network/virtualNetworks/virtualNetworkPeerings
| 이름 | 묘사 | 값 |
|---|---|---|
| apiVersion | api 버전 | '2024-03-01' |
| 이름 | 리소스 이름 | string(필수) |
| 속성 | 가상 네트워크 피어링의 속성입니다. | VirtualNetworkPeeringPropertiesFormat |
| 형 | 리소스 종류 | 'Microsoft.Network/virtualNetworks/virtualNetworkPeerings' |
SubResource
| 이름 | 묘사 | 값 |
|---|---|---|
| 아이디 | 리소스 ID입니다. | 문자열 |
VirtualNetworkBgpCommunities
| 이름 | 묘사 | 값 |
|---|---|---|
| virtualNetworkCommunity | 가상 네트워크와 연결된 BGP 커뮤니티입니다. | string(필수) |
VirtualNetworkPeeringPropertiesFormat
| 이름 | 묘사 | 값 |
|---|---|---|
| allowForwardedTraffic | 로컬 가상 네트워크의 VM에서 전달된 트래픽이 원격 가상 네트워크에서 허용/허용되지 않는지 여부입니다. | bool |
| allowGatewayTransit | 원격 가상 네트워킹에서 게이트웨이 링크를 사용하여 이 가상 네트워크에 연결할 수 있는 경우 | bool |
| allowVirtualNetworkAccess | 로컬 가상 네트워크 공간의 VM이 원격 가상 네트워크 공간의 VM에 액세스할 수 있는지 여부입니다. | bool |
| doNotVerifyRemoteGateways | 원격 게이트웨이의 프로비저닝 상태를 확인해야 하는 경우 | bool |
| enableOnlyIPv6Peering | 서브넷 피어링을 위해 Ipv6 주소 공간만 피어링되는지 여부입니다. | bool |
| localAddressSpace | 피어되는 로컬 가상 네트워크의 로컬 주소 공간입니다. | AddressSpace |
| localSubnetNames | 원격 가상 네트워크와 피어된 서브넷인 로컬 서브넷 이름 목록입니다. | string[] |
| localVirtualNetworkAddressSpace | 피어된 로컬 가상 네트워크의 현재 로컬 주소 공간입니다. | AddressSpace |
| peerCompleteVnets | 전체 가상 네트워크 주소 공간을 피어로 사용할지 여부입니다. | bool |
| peeringState | 가상 네트워크 피어링의 상태입니다. | '연결됨' '연결 끊김' 'Initiated' |
| peeringSyncLevel | 가상 네트워크 피어링의 피어링 동기화 상태입니다. | 'FullyInSync' 'LocalAndRemoteNotInSync' 'LocalNotInSync' 'RemoteNotInSync' |
| remoteAddressSpace | 원격 가상 네트워크와 피어된 주소 공간에 대한 참조입니다. | AddressSpace |
| remoteBgpCommunities | 원격 가상 네트워크의 Bgp 커뮤니티에 대한 참조입니다. | VirtualNetworkBgpCommunities |
| remoteSubnetNames | 피어된 서브넷인 원격 가상 네트워크의 원격 서브넷 이름 목록입니다. | string[] |
| remoteVirtualNetwork | 원격 가상 네트워크에 대한 참조입니다. 원격 가상 네트워크는 동일하거나 다른 지역(미리 보기)에 있을 수 있습니다. 미리 보기에 등록하고 자세히 알아보려면 여기를 참조하세요(/azure/virtual-network/virtual-network-create-peering). | SubResource |
| remoteVirtualNetworkAddressSpace | 원격 가상 네트워크의 현재 주소 공간에 대한 참조입니다. | AddressSpace |
| useRemoteGateways | 이 가상 네트워크에서 원격 게이트웨이를 사용할 수 있는 경우 플래그가 true로 설정되고 원격 피어링의 allowGatewayTransit도 true이면 가상 네트워크는 전송을 위해 원격 가상 네트워크의 게이트웨이를 사용합니다. 하나의 피어링만 이 플래그를 true로 설정할 수 있습니다. 가상 네트워크에 게이트웨이가 이미 있는 경우 이 플래그를 설정할 수 없습니다. | bool |
빠른 시작 템플릿
다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.
| 템플렛 | 묘사 |
|---|---|
| Azure 게임 개발자 Virtual Machine Azure |
Azure 게임 개발자 Virtual Machine에는 Unreal과 같은 라이선스가 부여된 엔진이 포함되어 있습니다. |
|
vNet 피어링 사용하여 vNet-vNet 연결 만들기 Azure 배포 |
이 템플릿을 사용하면 vNet 피어링을 사용하여 두 개의 vNet을 연결할 수 있습니다. |
|
강제 터널링 사용하여 Azure Firewall 샌드박스 만들기 Azure 배포 |
이 템플릿은 피어된 VNET의 다른 방화벽을 통해 터널된 하나의 방화벽이 있는 Azure Firewall 샌드박스(Linux)를 만듭니다. |
|
허브 Virtual Network Bastion 호스트 배포 Azure 배포 |
이 템플릿은 피어링이 있는 두 개의 vNet, 허브 vNet의 Bastion 호스트 및 스포크 vNet의 Linux VM을 만듭니다. |
|
허브 및 스포크 토폴로지 샌드박스 배포 Azure 배포 |
이 템플릿은 기본 허브 및 스포크 토폴로지 설정을 만듭니다. 서브넷 DMZ, 관리, 공유 및 게이트웨이(선택 사항)를 사용하여 각각 워크로드 서브넷을 포함하는 두 개의 스포크 VNet(개발 및 프로덕션)을 사용하여 허브 VNet을 만듭니다. 또한 허브의 관리 서브넷에 Windows Jump-Host 배포하고 허브와 두 스포크 간에 VNet 피어링을 설정합니다. |
|
한 지역에 두 개의 VNet을 사용하여 HBase 복제 배포 Azure 배포 |
이 템플릿을 사용하면 HBase 복제를 구성하기 위해 동일한 지역의 두 VNet 내에 두 개의 HBase 클러스터가 있는 AN HBase 환경을 구성할 수 있습니다. |
|
단일 지역 내에 있는 두 개의 기존 VNet 피어링 Azure 배포 |
이 템플릿을 사용하면 VNet 피어링을 사용하여 동일한 지역의 동일하거나 다른 리소스 그룹에서 두 개의 VNET을 연결할 수 있습니다. |
| 게이트웨이 Load Balancer 연결된 공용 Load Balancer Azure |
이 템플릿을 사용하면 게이트웨이 Load Balancer에 연결된 공용 표준 Load Balancer를 배포할 수 있습니다. 인터넷에서 들어오는 트래픽은 백 엔드 풀에서 NVA(Linux VM)를 사용하여 게이트웨이 Load Balancer로 라우팅됩니다. |
|
허브 & 스포크 토폴로지 Azure Firewall을 DNS 프록시로 사용 Azure 배포 |
이 샘플에서는 Azure Firewall을 사용하여 Azure에서 허브-스포크 토폴로지를 배포하는 방법을 보여 줍니다. 허브 가상 네트워크는 가상 네트워크 피어링을 통해 허브 가상 네트워크에 연결된 많은 스포크 가상 네트워크에 대한 연결의 중심 지점 역할을 합니다. |
Terraform(AzAPI 공급자) 리소스 정의
virtualNetworks/virtualNetworkPeerings 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.Network/virtualNetworks/virtualNetworkPeerings 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2024-03-01"
name = "string"
body = jsonencode({
properties = {
allowForwardedTraffic = bool
allowGatewayTransit = bool
allowVirtualNetworkAccess = bool
doNotVerifyRemoteGateways = bool
enableOnlyIPv6Peering = bool
localAddressSpace = {
addressPrefixes = [
"string"
]
}
localSubnetNames = [
"string"
]
localVirtualNetworkAddressSpace = {
addressPrefixes = [
"string"
]
}
peerCompleteVnets = bool
peeringState = "string"
peeringSyncLevel = "string"
remoteAddressSpace = {
addressPrefixes = [
"string"
]
}
remoteBgpCommunities = {
virtualNetworkCommunity = "string"
}
remoteSubnetNames = [
"string"
]
remoteVirtualNetwork = {
id = "string"
}
remoteVirtualNetworkAddressSpace = {
addressPrefixes = [
"string"
]
}
useRemoteGateways = bool
}
})
}
속성 값
AddressSpace
| 이름 | 묘사 | 값 |
|---|---|---|
| addressPrefixes | CIDR 표기법으로 이 가상 네트워크에 예약된 주소 블록 목록입니다. | string[] |
Microsoft.Network/virtualNetworks/virtualNetworkPeerings
| 이름 | 묘사 | 값 |
|---|---|---|
| 이름 | 리소스 이름 | string(필수) |
| parent_id | 이 리소스의 부모인 리소스의 ID입니다. | 형식의 리소스 ID: virtualNetworks |
| 속성 | 가상 네트워크 피어링의 속성입니다. | VirtualNetworkPeeringPropertiesFormat |
| 형 | 리소스 종류 | "Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2024-03-01" |
SubResource
| 이름 | 묘사 | 값 |
|---|---|---|
| 아이디 | 리소스 ID입니다. | 문자열 |
VirtualNetworkBgpCommunities
| 이름 | 묘사 | 값 |
|---|---|---|
| virtualNetworkCommunity | 가상 네트워크와 연결된 BGP 커뮤니티입니다. | string(필수) |
VirtualNetworkPeeringPropertiesFormat
| 이름 | 묘사 | 값 |
|---|---|---|
| allowForwardedTraffic | 로컬 가상 네트워크의 VM에서 전달된 트래픽이 원격 가상 네트워크에서 허용/허용되지 않는지 여부입니다. | bool |
| allowGatewayTransit | 원격 가상 네트워킹에서 게이트웨이 링크를 사용하여 이 가상 네트워크에 연결할 수 있는 경우 | bool |
| allowVirtualNetworkAccess | 로컬 가상 네트워크 공간의 VM이 원격 가상 네트워크 공간의 VM에 액세스할 수 있는지 여부입니다. | bool |
| doNotVerifyRemoteGateways | 원격 게이트웨이의 프로비저닝 상태를 확인해야 하는 경우 | bool |
| enableOnlyIPv6Peering | 서브넷 피어링을 위해 Ipv6 주소 공간만 피어링되는지 여부입니다. | bool |
| localAddressSpace | 피어되는 로컬 가상 네트워크의 로컬 주소 공간입니다. | AddressSpace |
| localSubnetNames | 원격 가상 네트워크와 피어된 서브넷인 로컬 서브넷 이름 목록입니다. | string[] |
| localVirtualNetworkAddressSpace | 피어된 로컬 가상 네트워크의 현재 로컬 주소 공간입니다. | AddressSpace |
| peerCompleteVnets | 전체 가상 네트워크 주소 공간을 피어로 사용할지 여부입니다. | bool |
| peeringState | 가상 네트워크 피어링의 상태입니다. | '연결됨' '연결 끊김' 'Initiated' |
| peeringSyncLevel | 가상 네트워크 피어링의 피어링 동기화 상태입니다. | 'FullyInSync' 'LocalAndRemoteNotInSync' 'LocalNotInSync' 'RemoteNotInSync' |
| remoteAddressSpace | 원격 가상 네트워크와 피어된 주소 공간에 대한 참조입니다. | AddressSpace |
| remoteBgpCommunities | 원격 가상 네트워크의 Bgp 커뮤니티에 대한 참조입니다. | VirtualNetworkBgpCommunities |
| remoteSubnetNames | 피어된 서브넷인 원격 가상 네트워크의 원격 서브넷 이름 목록입니다. | string[] |
| remoteVirtualNetwork | 원격 가상 네트워크에 대한 참조입니다. 원격 가상 네트워크는 동일하거나 다른 지역(미리 보기)에 있을 수 있습니다. 미리 보기에 등록하고 자세히 알아보려면 여기를 참조하세요(/azure/virtual-network/virtual-network-create-peering). | SubResource |
| remoteVirtualNetworkAddressSpace | 원격 가상 네트워크의 현재 주소 공간에 대한 참조입니다. | AddressSpace |
| useRemoteGateways | 이 가상 네트워크에서 원격 게이트웨이를 사용할 수 있는 경우 플래그가 true로 설정되고 원격 피어링의 allowGatewayTransit도 true이면 가상 네트워크는 전송을 위해 원격 가상 네트워크의 게이트웨이를 사용합니다. 하나의 피어링만 이 플래그를 true로 설정할 수 있습니다. 가상 네트워크에 게이트웨이가 이미 있는 경우 이 플래그를 설정할 수 없습니다. | bool |