Microsoft.Network virtualNetworks/virtualNetworkPeerings

아티클
05/08/2024

Bicep 리소스 정의

virtualNetworks/virtualNetworkPeerings 리소스 종류는 다음을 대상으로 하는 작업과 함께 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령을 참조하세요.

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.Network/virtualNetworks/virtualNetworkPeerings 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2023-11-01' = {
  name: 'string'
  parent: resourceSymbolicName
  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
  }
}

속성 값

virtualNetworks/virtualNetworkPeerings

Name	Description	값
name	리소스 이름 Bicep에서 자식 리소스의 이름과 형식을 설정하는 방법을 참조하세요.	string(필수) 문자 제한: 1-80 유효한 문자: 영숫자, 밑줄, 마침표 및 하이픈 영숫자로 시작합니다. 영숫자 또는 밑줄로 끝납니다.
부모(parent)	Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가하면 됩니다. 자세한 내용은 부모 리소스 외부의 자식 리소스를 참조하세요.	형식의 리소스에 대한 기호화된 이름: virtualNetworks
properties	가상 네트워크 피어링의 속성입니다.	VirtualNetworkPeeringPropertiesFormat

VirtualNetworkPeeringPropertiesFormat

Name	Description	값
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

AddressSpace

Name	Description	값
addressPrefixes	CIDR 표기법으로 이 가상 네트워크에 예약된 주소 블록 목록입니다.	string[]

VirtualNetworkBgpCommunities

Name	Description	값
virtualNetworkCommunity	가상 네트워크와 연결된 BGP 커뮤니티입니다.	string(필수)

SubResource

Name	Description	값
id	리소스 ID입니다.	string

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 종류를 배포합니다.

템플릿	Description
허브 및 스포크 토폴로지 샌드박스 배포	이 템플릿은 기본 허브 및 스포크 토폴로지 설정을 만듭니다. 서브넷 DMZ, 관리, 공유 및 게이트웨이(선택 사항)를 사용하여 각각 워크로드 서브넷을 포함하는 두 개의 스포크 VNet(개발 및 프로덕션)을 사용하여 허브 VNet을 만듭니다. 또한 허브의 관리 서브넷에 Windows Jump-Host 배포하고 허브와 두 스포크 간에 VNet 피어링을 설정합니다.
게이트웨이 Load Balancer 연결된 공용 Load Balancer	이 템플릿을 사용하면 게이트웨이 Load Balancer 연결된 공용 표준 Load Balancer 배포할 수 있습니다. 인터넷에서 들어오는 트래픽은 백 엔드 풀의 NVA(Linux VM)를 사용하여 게이트웨이 Load Balancer 라우팅됩니다.
한 지역에 두 개의 VNet을 사용하여 HBase 복제 배포	이 템플릿을 사용하면 HBase 복제를 구성하기 위해 동일한 지역의 두 VNet 내에 두 개의 HBase 클러스터가 있는N HBase 환경을 구성할 수 있습니다.
허브 & 스포크 토폴로지에서 DNS 프록시로 Azure Firewall 사용	이 샘플에서는 Azure Firewall 사용하여 Azure에서 허브-스포크 토폴로지를 배포하는 방법을 보여 줍니다. 허브 가상 네트워크는 가상 네트워크 피어링을 통해 허브 가상 네트워크에 연결된 많은 스포크 가상 네트워크에 대한 연결의 중심 지점 역할을 합니다.
강제 터널링을 사용하여 Azure Firewall 샌드박스 Create	이 템플릿은 피어링된 VNET의 다른 방화벽을 통해 터널링된 하나의 방화벽이 있는 Azure Firewall 샌드박스(Linux)를 만듭니다.
허브 Virtual Network Bastion 호스트 배포	이 템플릿은 피어링이 있는 두 개의 vNet, 허브 vNet의 Bastion 호스트 및 스포크 vNet의 Linux VM을 만듭니다.
단일 지역 내에서 두 개의 기존 VNet 피어링	이 템플릿을 사용하면 VNet 피어링을 사용하여 동일한 지역의 동일하거나 다른 리소스 그룹에서 두 개의 VNET을 연결할 수 있습니다.
vNet 피어링을 사용하여 vNet 대 vNet 연결 Create	이 템플릿을 사용하면 vNet 피어링을 사용하여 두 개의 vNet을 연결할 수 있습니다.

ARM 템플릿 리소스 정의

virtualNetworks/virtualNetworkPeerings 리소스 종류는 다음을 대상으로 하는 작업과 함께 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령을 참조하세요.

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.Network/virtualNetworks/virtualNetworkPeerings 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.Network/virtualNetworks/virtualNetworkPeerings",
  "apiVersion": "2023-11-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"
  }
}

속성 값

virtualNetworks/virtualNetworkPeerings

Name	Description	값
형식	리소스 종류	'Microsoft.Network/virtualNetworks/virtualNetworkPeerings'
apiVersion	리소스 api 버전	'2023-11-01'
name	리소스 이름 JSON ARM 템플릿에서 자식 리소스의 이름 및 형식을 설정하는 방법을 참조하세요.	string(필수) 문자 제한: 1-80 유효한 문자: 영숫자, 밑줄, 마침표 및 하이픈 영숫자로 시작합니다. 영숫자 또는 밑줄로 끝납니다.
properties	가상 네트워크 피어링의 속성입니다.	VirtualNetworkPeeringPropertiesFormat

VirtualNetworkPeeringPropertiesFormat

Name	Description	값
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

AddressSpace

Name	Description	값
addressPrefixes	CIDR 표기법으로 이 가상 네트워크에 예약된 주소 블록 목록입니다.	string[]

VirtualNetworkBgpCommunities

Name	Description	값
virtualNetworkCommunity	가상 네트워크와 연결된 BGP 커뮤니티입니다.	string(필수)

SubResource

Name	Description	값
id	리소스 ID입니다.	문자열

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 종류를 배포합니다.

템플릿	Description
허브 및 스포크 토폴로지 샌드박스 배포	이 템플릿은 기본 허브 및 스포크 토폴로지 설정을 만듭니다. 서브넷 DMZ, 관리, 공유 및 게이트웨이(선택 사항)를 사용하여 각각 워크로드 서브넷을 포함하는 두 개의 스포크 VNet(개발 및 프로덕션)을 사용하여 허브 VNet을 만듭니다. 또한 허브의 관리 서브넷에 Windows Jump-Host 배포하고 허브와 두 스포크 간에 VNet 피어링을 설정합니다.
게이트웨이 Load Balancer 연결된 공용 Load Balancer	이 템플릿을 사용하면 게이트웨이 Load Balancer 연결된 공용 표준 Load Balancer 배포할 수 있습니다. 인터넷에서 들어오는 트래픽은 백 엔드 풀의 NVA(Linux VM)를 사용하여 게이트웨이 Load Balancer 라우팅됩니다.
한 지역에 두 개의 VNet을 사용하여 HBase 복제 배포	이 템플릿을 사용하면 HBase 복제를 구성하기 위해 동일한 지역의 두 VNet 내에 두 개의 HBase 클러스터가 있는N HBase 환경을 구성할 수 있습니다.
허브 & 스포크 토폴로지에서 DNS 프록시로 Azure Firewall 사용	이 샘플에서는 Azure Firewall 사용하여 Azure에서 허브-스포크 토폴로지를 배포하는 방법을 보여 줍니다. 허브 가상 네트워크는 가상 네트워크 피어링을 통해 허브 가상 네트워크에 연결된 많은 스포크 가상 네트워크에 대한 연결의 중심 지점 역할을 합니다.
강제 터널링을 사용하여 Azure Firewall 샌드박스 Create	이 템플릿은 피어링된 VNET의 다른 방화벽을 통해 터널링된 하나의 방화벽이 있는 Azure Firewall 샌드박스(Linux)를 만듭니다.
허브 Virtual Network Bastion 호스트 배포	이 템플릿은 피어링이 있는 두 개의 vNet, 허브 vNet의 Bastion 호스트 및 스포크 vNet의 Linux VM을 만듭니다.
단일 지역 내에서 두 개의 기존 VNet 피어링	이 템플릿을 사용하면 VNet 피어링을 사용하여 동일한 지역의 동일하거나 다른 리소스 그룹에서 두 개의 VNET을 연결할 수 있습니다.
vNet 피어링을 사용하여 vNet-vNet 연결 Create	이 템플릿을 사용하면 vNet 피어링을 사용하여 두 개의 vNet을 연결할 수 있습니다.

Terraform(AzAPI 공급자) 리소스 정의

virtualNetworks/virtualNetworkPeerings 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.

리소스 형식

Microsoft.Network/virtualNetworks/virtualNetworkPeerings 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2023-11-01"
  name = "string"
  parent_id = "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
    }
  })
}

속성 값

virtualNetworks/virtualNetworkPeerings

Name	Description	값
형식	리소스 종류	"Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2023-11-01"
name	리소스 이름	string(필수) 문자 제한: 1-80 유효한 문자: 영숫자, 밑줄, 마침표 및 하이픈 영숫자로 시작합니다. 영숫자 또는 밑줄로 끝납니다.
parent_id	이 리소스의 부모인 리소스의 ID입니다.	형식의 리소스에 대한 ID: virtualNetworks
properties	가상 네트워크 피어링의 속성입니다.	VirtualNetworkPeeringPropertiesFormat

VirtualNetworkPeeringPropertiesFormat

Name	Description	값
allowForwardedTraffic	로컬 가상 네트워크의 VM에서 전달된 트래픽이 원격 가상 네트워크에서 허용/허용되지 않는지 여부입니다.	bool
allowGatewayTransit	게이트웨이 링크를 원격 가상 네트워킹에서 사용하여 이 가상 네트워크에 연결할 수 있는 경우	bool
allowVirtualNetworkAccess	로컬 가상 네트워크 공간의 VM이 원격 가상 네트워크 공간의 VM에 액세스할 수 있는지 여부입니다.	bool
doNotVerifyRemoteGateways	원격 게이트웨이의 프로비전 상태를 확인해야 하는 경우	bool
enableOnlyIPv6Peering	서브넷 피어링을 위해 Ipv6 주소 공간만 피어링되는지 여부입니다.	bool
localAddressSpace	피어링되는 로컬 가상 네트워크의 로컬 주소 공간입니다.	AddressSpace
localSubnetNames	원격 가상 네트워크와 피어링된 서브넷인 로컬 서브넷 이름 목록입니다.	string[]
localVirtualNetworkAddressSpace	피어링되는 로컬 가상 네트워크의 현재 로컬 주소 공간입니다.	AddressSpace
peerCompleteVnets	전체 가상 네트워크 주소 공간을 피어링할지 여부입니다.	bool
peeringState	가상 네트워크 피어링의 상태.	"연결됨" "연결 끊김" "시작됨"
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

AddressSpace

Name	Description	값
addressPrefixes	CIDR 표기법으로 이 가상 네트워크에 예약된 주소 블록 목록입니다.	string[]

VirtualNetworkBgpCommunities

Name	Description	값
virtualNetworkCommunity	가상 네트워크와 연결된 BGP 커뮤니티입니다.	string(필수)

SubResource

Name	Description	값
id	리소스 ID입니다.	string

Share via

Microsoft.Network virtualNetworks/virtualNetworkPeerings

Bicep 리소스 정의

리소스 형식

속성 값

virtualNetworks/virtualNetworkPeerings

VirtualNetworkPeeringPropertiesFormat

AddressSpace

VirtualNetworkBgpCommunities

SubResource

빠른 시작 템플릿

ARM 템플릿 리소스 정의

리소스 형식

속성 값

virtualNetworks/virtualNetworkPeerings

VirtualNetworkPeeringPropertiesFormat

AddressSpace

VirtualNetworkBgpCommunities

SubResource

빠른 시작 템플릿

Terraform(AzAPI 공급자) 리소스 정의

리소스 형식

속성 값

virtualNetworks/virtualNetworkPeerings

VirtualNetworkPeeringPropertiesFormat

AddressSpace

VirtualNetworkBgpCommunities

SubResource

피드백

피드백

추가 리소스