Microsoft.Network virtualNetworks/virtualNetworkPeerings 2023-11-01
Определение ресурса 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 | имя ресурса. Узнайте, как задать имена и типы для дочерних ресурсов в Bicep. |
string (обязательно) Ограничение символов: 1-80 Допустимые символы: Буквенно-цифровые символы, символы подчеркивания, точки и дефисы. Начинается с буквенно-цифрового символа. Заканчивается буквенно-цифровым символом или символом подчеркивания. |
| родитель | В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить только в том случае, если дочерний ресурс объявлен за пределами родительского ресурса. Дополнительные сведения см. в разделе Дочерний ресурс за пределами родительского ресурса. |
Символьное имя ресурса типа : virtualNetworks |
| properties | Свойства пиринга виртуальных сетей. | VirtualNetworkPeeringPropertiesFormat |
VirtualNetworkPeeringPropertiesFormat
| Имя | Описание | Значение |
|---|---|---|
| allowForwardedTraffic | Будет ли перенаправленный трафик с виртуальных машин в локальной виртуальной сети разрешен или запрещен в удаленной виртуальной сети. | bool |
| allowGatewayTransit | Если ссылки шлюза можно использовать в удаленной виртуальной сети для связи с этой виртуальной сетью. | bool |
| allowVirtualNetworkAccess | Будут ли виртуальные машины в пространстве локальной виртуальной сети иметь доступ к виртуальным машинам в удаленном пространстве виртуальной сети. | 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
| Имя | Описание | Значение |
|---|---|---|
| addressPrefixes | Список блоков адресов, зарезервированных для этой виртуальной сети в нотации CIDR. | string[] |
VirtualNetworkBgpCommunities
| Имя | Описание | Значение |
|---|---|---|
| virtualNetworkCommunity | Сообщество BGP, связанное с виртуальной сетью. | string (обязательно) |
SubResource
| Имя | Описание | Значение |
|---|---|---|
| идентификатор | Идентификатор ресурса. | строка |
Шаблоны быстрого запуска
Следующие шаблоны быстрого запуска развертывают этот тип ресурса.
| Шаблон | Описание |
|---|---|
Развертывание песочницы звездообразной топологии |
Этот шаблон создает базовую звездообразную топологию. Он создает виртуальную сеть концентратора с подсетями dmz, management, shared и gateway (необязательно) с двумя периферийными виртуальными сетями (разработка и рабочая), содержащими подсеть рабочей нагрузки. Он также развертывает Jump-Host Windows в подсети управления концентратора и устанавливает пиринги виртуальных сетей между концентратором и двумя периферийными узлами. |
| Общедоступный Load Balancer, привязанный к Load Balancer шлюза |
Этот шаблон позволяет развернуть общедоступный Load Balancer (цен. категория , привязанный к Load Balancer шлюза. Трафик, входящий из Интернета, направляется в шлюз Load Balancer с виртуальными машинами Linux (NVA) во внутреннем пуле. |
| Развертывание репликации HBase с двумя виртуальными сетями в одном регионе |
Этот шаблон позволяет настроить среду HBase с двумя кластерами HBase в двух виртуальных сетей в одном регионе для настройки репликации HBase. |
| Использование Брандмауэр Azure в качестве прокси-сервера DNS в звезд & ообразной топологии |
В этом примере показано, как развернуть звездообразную топологию в Azure с помощью Брандмауэр Azure. Центральная виртуальная сеть выступает в качестве центральной точки подключения ко многим периферийным виртуальным сетям, которые подключены к центральной виртуальной сети через пиринг между виртуальными сетями. |
| Create песочнице Брандмауэр Azure с принудительным туннелированием |
Этот шаблон создает песочницу Брандмауэр Azure (Linux) с одним принудительным брандмауэром, туннелированием через другой брандмауэр в одноранговой виртуальной сети. |
| Развертывание узла-бастиона в центральной виртуальная сеть |
Этот шаблон создает две виртуальные сети с пирингами: узел-бастион в центральной виртуальной сети и виртуальную машину Linux в периферийной виртуальной сети. |
| Пиринг двух существующих виртуальных сетей в одном регионе |
Этот шаблон позволяет подключать две виртуальные сети из одной или разных групп ресурсов в одном регионе с помощью пиринга виртуальных сетей. |
| Create подключения виртуальной сети к виртуальной сети с помощью пиринга виртуальных сетей |
Этот шаблон позволяет подключать две виртуальные сети с помощью пиринга виртуальных сетей. |
Определение ресурса шаблона 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
| Имя | Описание | Значение |
|---|---|---|
| тип | Тип ресурса | Microsoft.Network/virtualNetworks/virtualNetworkPeerings |
| версия_API | Версия API ресурсов | '2023-11-01' |
| name | имя ресурса. Узнайте, как задать имена и типы для дочерних ресурсов в шаблонах JSON ARM. |
string (обязательно) Ограничение символов: 1-80 Допустимые символы: Буквенно-цифровые символы, символы подчеркивания, точки и дефисы. Начинается с буквенно-цифрового символа. Заканчивается буквенно-цифровым символом или символом подчеркивания. |
| properties | Свойства пиринга виртуальных сетей. | VirtualNetworkPeeringPropertiesFormat |
VirtualNetworkPeeringPropertiesFormat
| Имя | Описание | Значение |
|---|---|---|
| allowForwardedTraffic | Будет ли перенаправленный трафик с виртуальных машин в локальной виртуальной сети разрешен или запрещен в удаленной виртуальной сети. | bool |
| allowGatewayTransit | Если ссылки шлюза можно использовать в удаленной виртуальной сети для связи с этой виртуальной сетью. | bool |
| allowVirtualNetworkAccess | Будут ли виртуальные машины в пространстве локальной виртуальной сети иметь доступ к виртуальным машинам в удаленном пространстве виртуальной сети. | 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
| Имя | Описание | Значение |
|---|---|---|
| addressPrefixes | Список блоков адресов, зарезервированных для этой виртуальной сети в нотации CIDR. | string[] |
VirtualNetworkBgpCommunities
| Имя | Описание | Значение |
|---|---|---|
| virtualNetworkCommunity | Сообщество BGP, связанное с виртуальной сетью. | string (обязательно) |
SubResource
| Имя | Описание | Значение |
|---|---|---|
| идентификатор | Идентификатор ресурса. | строка |
Шаблоны быстрого запуска
Следующие шаблоны быстрого запуска развертывают этот тип ресурса.
| Шаблон | Описание |
|---|---|
| Развертывание песочницы звездообразной топологии |
Этот шаблон создает базовую звездообразную топологию. Он создает виртуальную сеть концентратора с подсетями dmz, management, shared и gateway (необязательно) с двумя периферийными виртуальными сетями (разработка и рабочая), содержащими подсеть рабочей нагрузки. Он также развертывает Jump-Host Windows в подсети управления концентратора и устанавливает пиринги виртуальных сетей между концентратором и двумя периферийными узлами. |
| Общедоступный Load Balancer, привязанный к Load Balancer шлюза |
Этот шаблон позволяет развернуть общедоступный Load Balancer (цен. категория , привязанный к Load Balancer шлюза. Трафик, входящий из Интернета, направляется в шлюз Load Balancer с виртуальными машинами Linux (NVA) во внутреннем пуле. |
| Развертывание репликации HBase с двумя виртуальными сетями в одном регионе |
Этот шаблон позволяет настроить среду HBase с двумя кластерами HBase в двух виртуальных сетей в одном регионе для настройки репликации HBase. |
| Использование Брандмауэр Azure в качестве прокси-сервера DNS в звезд & ообразной топологии |
В этом примере показано, как развернуть звездообразную топологию в Azure с помощью Брандмауэр Azure. Виртуальная сеть концентратора выступает в качестве центральной точки подключения ко многим периферийным виртуальным сетям, которые подключены к центральной виртуальной сети через пиринг виртуальных сетей. |
| Create песочницу Брандмауэр Azure с принудительным туннелированием |
Этот шаблон создает песочницу Брандмауэр Azure (Linux) с одним принудительного туннелирования брандмауэра через другой брандмауэр в пиринговой виртуальной сети. |
| Развертывание узла-бастиона в центральной виртуальная сеть |
Этот шаблон создает две виртуальные сети с пирингами: узел-бастион в центральной виртуальной сети и виртуальную машину Linux в периферийной виртуальной сети. |
| Пиринг между двумя существующими виртуальными сетями в одном регионе |
Этот шаблон позволяет подключать две виртуальные сети из одной или разных групп ресурсов в одном регионе с помощью пиринга виртуальных сетей |
| Create подключения между виртуальными сетями с помощью пиринга виртуальных сетей |
Этот шаблон позволяет подключить две виртуальные сети с помощью пиринга виртуальных сетей |
Определение ресурса 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
| Имя | Описание | Значение |
|---|---|---|
| тип | Тип ресурса | "Microsoft.Network/virtualNetworks/virtualNetworkPeerings@2023-11-01" |
| name | имя ресурса. | строка (обязательно) Ограничение символов: 1–80 Допустимые символы: Буквенно-цифровые символы, символы подчеркивания, точки и дефисы. Начинается с буквенно-цифрового символа. Заканчивается буквенно-цифровым символом или символом подчеркивания. |
| parent_id | Идентификатор ресурса, который является родительским для этого ресурса. | Идентификатор ресурса типа: virtualNetworks |
| properties | Свойства пиринга виртуальных сетей. | VirtualNetworkPeeringPropertiesFormat |
VirtualNetworkPeeringPropertiesFormat
| Имя | Описание | Значение |
|---|---|---|
| allowForwardedTraffic | Будет ли перенаправленный трафик с виртуальных машин в локальной виртуальной сети разрешен или запрещен в удаленной виртуальной сети. | bool |
| allowGatewayTransit | Если для связи с этой виртуальной сетью можно использовать каналы шлюза в удаленной виртуальной сети. | bool |
| allowVirtualNetworkAccess | Будут ли виртуальные машины в пространстве локальной виртуальной сети иметь доступ к виртуальным машинам в удаленном пространстве виртуальной сети. | 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
| Имя | Описание | Значение |
|---|---|---|
| addressPrefixes | Список блоков адресов, зарезервированных для этой виртуальной сети в нотации CIDR. | string[] |
VirtualNetworkBgpCommunities
| Имя | Описание | Значение |
|---|---|---|
| virtualNetworkCommunity | Сообщество BGP, связанное с виртуальной сетью. | string (обязательно) |
SubResource
| Имя | Описание | Значение |
|---|---|---|
| идентификатор | Идентификатор ресурса. | строка |