Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
- последние
- 2025-05-01
- 2025-03-01
- 2025-01-01
- 2024-10-01
- 2024-07-01
- 2024-05-01
- 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
- 2016-03-30
- 2015-06-15
- 2015-05-01-превью
Определение ресурсов Bicep
Тип ресурса VirtualNetworkGateways можно развернуть с помощью операций, предназначенных для следующих целей:
- группы ресурсов . См. команды развертывания группы ресурсов
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.Network/virtualNetworkGateways, добавьте следующий Bicep в шаблон.
resource symbolicname 'Microsoft.Network/virtualNetworkGateways@2022-05-01' = {
extendedLocation: {
name: 'string'
type: 'string'
}
location: 'string'
name: 'string'
properties: {
activeActive: bool
allowRemoteVnetTraffic: bool
allowVirtualWanTraffic: bool
bgpSettings: {
asn: int
bgpPeeringAddress: 'string'
bgpPeeringAddresses: [
{
customBgpIpAddresses: [
'string'
]
ipconfigurationId: 'string'
}
]
peerWeight: int
}
customRoutes: {
addressPrefixes: [
'string'
]
}
disableIPSecReplayProtection: bool
enableBgp: bool
enableBgpRouteTranslationForNat: bool
enableDnsForwarding: bool
enablePrivateIpAddress: bool
gatewayDefaultSite: {
id: 'string'
}
gatewayType: 'string'
ipConfigurations: [
{
id: 'string'
name: 'string'
properties: {
privateIPAllocationMethod: 'string'
publicIPAddress: {
id: 'string'
}
subnet: {
id: 'string'
}
}
}
]
natRules: [
{
id: 'string'
name: 'string'
properties: {
externalMappings: [
{
addressSpace: 'string'
portRange: 'string'
}
]
internalMappings: [
{
addressSpace: 'string'
portRange: 'string'
}
]
ipConfigurationId: 'string'
mode: 'string'
type: 'string'
}
}
]
sku: {
name: 'string'
tier: 'string'
}
virtualNetworkGatewayPolicyGroups: [
{
id: 'string'
name: 'string'
properties: {
isDefault: bool
policyMembers: [
{
attributeType: 'string'
attributeValue: 'string'
name: 'string'
}
]
priority: int
}
}
]
vNetExtendedLocationResourceId: 'string'
vpnClientConfiguration: {
aadAudience: 'string'
aadIssuer: 'string'
aadTenant: 'string'
radiusServerAddress: 'string'
radiusServers: [
{
radiusServerAddress: 'string'
radiusServerScore: int
radiusServerSecret: 'string'
}
]
radiusServerSecret: 'string'
vngClientConnectionConfigurations: [
{
id: 'string'
name: 'string'
properties: {
virtualNetworkGatewayPolicyGroups: [
{
id: 'string'
}
]
vpnClientAddressPool: {
addressPrefixes: [
'string'
]
}
}
}
]
vpnAuthenticationTypes: [
'string'
]
vpnClientAddressPool: {
addressPrefixes: [
'string'
]
}
vpnClientIpsecPolicies: [
{
dhGroup: 'string'
ikeEncryption: 'string'
ikeIntegrity: 'string'
ipsecEncryption: 'string'
ipsecIntegrity: 'string'
pfsGroup: 'string'
saDataSizeKilobytes: int
saLifeTimeSeconds: int
}
]
vpnClientProtocols: [
'string'
]
vpnClientRevokedCertificates: [
{
id: 'string'
name: 'string'
properties: {
thumbprint: 'string'
}
}
]
vpnClientRootCertificates: [
{
id: 'string'
name: 'string'
properties: {
publicCertData: 'string'
}
}
]
}
vpnGatewayGeneration: 'string'
vpnType: 'string'
}
tags: {
{customized property}: 'string'
}
}
Значения свойств
Microsoft.Network/виртуальные сетевые шлюзы
| Имя | Описание | Ценность |
|---|---|---|
| расширенноеМестоположение | Расширенное расположение шлюза локальной виртуальной сети типа. | РасширенноеМестоположение |
| местоположение | Расположение ресурса. | струна |
| имя | Имя ресурса | строка (обязательно) |
| свойства | Свойства шлюза виртуальной сети. | VirtualNetworkGatewayPropertiesFormat (обязательно) |
| Теги | Теги ресурсов | Словарь имен и значений тегов. См. теги в шаблонах |
Адресное пространство
| Имя | Описание | Ценность |
|---|---|---|
| addressПрефиксы | Список блоков адресов, зарезервированных для этой виртуальной сети в нотации CIDR. | строка[] |
Настройки Bgp
| Имя | Описание | Ценность |
|---|---|---|
| асн | ASN докладчика BGP. | int Ограничения целостности: Минимальное значение = 0 Максимальное значение = 4294967295 |
| bgpPeeringAddress | Адрес пиринга BGP и идентификатор BGP этого докладчика BGP. | струна |
| bgpPeeringAddresses | Адрес пиринга BGP с идентификатором IP-конфигурации для шлюза виртуальной сети. | IPConfigurationBgpPeeringAddress[] |
| одноранговый вес | Вес, добавленный к маршрутам, извлеченным из этого докладчика BGP. | инт |
Расширенное местоположение
| Имя | Описание | Ценность |
|---|---|---|
| имя | Имя расширенного расположения. | струна |
| тип | Тип расширенного расположения. | EdgeZone |
IPConfigurationBgpPeeringAddress
| Имя | Описание | Ценность |
|---|---|---|
| customBgpIpАдреса | Список пользовательских адресов пиринга BGP, принадлежащих ip-конфигурации. | строка[] |
| ipconfigurationId | Идентификатор конфигурации IP-адресов, принадлежавшей шлюзу. | струна |
Политика IPSEC
| Имя | Описание | Ценность |
|---|---|---|
| dhGroup | Группа DH, используемая на этапе IKE 1 для начального sa. | DHGroup1 DHGroup14 DHGroup2 DHGroup2048 DHGroup24 "ECP256" "ECP384" "Нет" (обязательно) |
| ikeШифрование | Алгоритм шифрования IKE (этап IKE 2). | "AES128" "AES192" "AES256" "DES" DES3 "GCMAES128" "GCMAES256" (обязательно) |
| ikeIntegrity | Алгоритм целостности IKE (этап IKE 2). | "GCMAES128" "GCMAES256" "MD5" "SHA1" Sha256 SHA384 (обязательно) |
| ipsecШифрование | Алгоритм шифрования IPSec (этап IKE 1). | "AES128" "AES192" "AES256" "DES" DES3 "GCMAES128" "GCMAES192" "GCMAES256" "Нет" (обязательно) |
| ipsecIntegrity | Алгоритм целостности IPSec (этап IKE 1). | "GCMAES128" "GCMAES192" "GCMAES256" "MD5" "SHA1" SHA256 (обязательно) |
| Группа pfs | Группа Pfs, используемая на этапе IKE 2 для нового дочернего SA. | "ECP256" "ECP384" "Нет" «ПФС1» «ПФС14» «ПФС2» "PFS2048" «ПФС24» PFSMM (обязательно) |
| saDataSizeKilobytes | Размер полезных данных IPSec (также называемый быстрым режимом или этапом 2 SA) в КБ для сайта vpn-туннеля. | int (обязательно) |
| saLifeTimeSeconds | Связь безопасности IPSec (также называемая быстрым режимом или этапом 2 SA) в секундах для сайта vpn-туннеля сайта. | int (обязательно) |
Сервер RadiusServer
| Имя | Описание | Ценность |
|---|---|---|
| radiusServerAddress | Адрес этого сервера radius. | строка (обязательно) |
| radiusServerScore | Начальная оценка, назначенная этому серверу radius. | инт |
| radiusServerSecret | Секрет, используемый для этого сервера radius. | струна |
Теги ресурса
| Имя | Описание | Ценность |
|---|
Подресурс
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
VirtualNetworkGatewayIPConfiguration
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства IP-конфигурации шлюза виртуальной сети. | VirtualNetworkGatewayIPConfigurationPropertiesFormat |
VirtualNetworkGatewayIPConfigurationPropertiesFormat
| Имя | Описание | Ценность |
|---|---|---|
| privateIPAllocationMethod | Метод выделения частных IP-адресов. | Dynamic "Статический" |
| publicIPАдрессест | Ссылка на ресурс общедоступного IP-адреса. | Подресурс |
| подсеть | Ссылка на ресурс подсети. | Подресурс |
Правило VirtualNetworkGatewayNatRule
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства правила NAT шлюза виртуальной сети. | Свойства VirtualNetworkGatewayNatRule |
Свойства VirtualNetworkGatewayNatRule
| Имя | Описание | Ценность |
|---|---|---|
| externalMappings | Внешнее сопоставление частных IP-адресов для NAT. | VpnNatRuleMapping[] |
| internalMappings | Внутреннее сопоставление частных IP-адресов для NAT. | VpnNatRuleMapping[] |
| ipConfigurationId | Идентификатор конфигурации IP-адресов, к этому правилу NAT применяется. | струна |
| режим | Направление исходного NAT ДЛЯ VPN-NAT. | EgressSnat «IngressSnat» |
| тип | Тип правила NAT для VPN NAT. | Dynamic "Статический" |
VirtualNetworkGatewayPolicyGroup
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства tVirtualNetworkGatewayPolicyGroup. | VirtualNetworkGatewayPolicyGroupProperties |
VirtualNetworkGatewayPolicyУчастник группы
| Имя | Описание | Ценность |
|---|---|---|
| attributeType | Тип атрибута члена политики VPN. | AADGroupId CertificateGroupId RadiusAzureGroupId |
| Значение атрибута | Значение атрибута, используемого для этого объекта VirtualNetworkGatewayPolicyGroupMember. | струна |
| имя | Имя VirtualNetworkGatewayPolicyGroupMember. | струна |
VirtualNetworkGatewayPolicyGroupProperties
| Имя | Описание | Ценность |
|---|---|---|
| isDefault | Показывает, является ли это VirtualNetworkGatewayPolicyGroup или нет. | bool (обязательно) |
| policyУчастники | Несколько policyMembers для VirtualNetworkGatewayPolicyGroup. | VirtualNetworkGatewayPolicyGroupMember[] (обязательно) |
| приоритет | Приоритет для VirtualNetworkGatewayPolicyGroup. | int (обязательно) |
VirtualNetworkGatewayPropertiesFormat
| Имя | Описание | Ценность |
|---|---|---|
| активныйАктивный | Флаг ActiveActive. | булевая переменная (bool) |
| allowRemoteVnetTraffic | Настройте этот шлюз для приема трафика из других виртуальных сетей Azure. Эта конфигурация не поддерживает подключение к виртуальной глобальной сети Azure. | булевая переменная (bool) |
| allowVirtualWanTraffic | Настраивает этот шлюз для приема трафика из удаленных сетей виртуальной глобальной сети. | булевая переменная (bool) |
| bgpНастройки | Параметры динамиков BGP шлюза виртуальной сети. | Настройки Bgp |
| customRoutes | Ссылка на ресурс адресного пространства, представляющий адресное пространство пользовательских маршрутов, указанное клиентом для шлюза виртуальной сети и VpnClient. | Адресное пространство |
| disableIPSecReplayProtection | флаг disableIPSecReplayProtection. | булевая переменная (bool) |
| enableBgp | Включена ли BGP для этого шлюза виртуальной сети или нет. | булевая переменная (bool) |
| enableBgpRouteTranslationForNat | Флаг EnableBgpRouteTranslationForNat. | булевая переменная (bool) |
| enableDnsForwarding | Включена ли переадресация DNS. | булевая переменная (bool) |
| enablePrivateIpAddress | Необходимо ли включить частный IP-адрес в этом шлюзе для подключений или нет. | булевая переменная (bool) |
| gatewayDefaultSite | Ссылка на ресурс LocalNetworkGateway, представляющий локальный сетевой сайт с маршрутами по умолчанию. Назначьте значение NULL в случае удаления существующего параметра сайта по умолчанию. | Подресурс |
| Тип шлюза | Тип этого шлюза виртуальной сети. | ExpressRoute «Локальный шлюз» "Vpn" |
| ipКонфигурации | IP-конфигурации для шлюза виртуальной сети. | VirtualNetworkGatewayIPConfiguration[] |
| natRules | NatRules для шлюза виртуальной сети. | VirtualNetworkGatewayNatRule[] |
| SKU | Ссылка на ресурс VirtualNetworkGatewaySku, представляющий номер SKU, выбранный для шлюза виртуальной сети. | VirtualNetworkGatewaySku (Виртуальный сетевой шлюз) |
| virtualNetworkGatewayPolicyGroups | Ссылка на ресурс VirtualNetworkGatewayPolicyGroup, представляющий доступную виртуальную сетьGatewayPolicyGroup для шлюза. | VirtualNetworkGatewayPolicyGroup[] |
| vNetExtendedLocationResourceId | Идентификатор ресурса виртуальной сети клиента. VirtualNetworkGateway типа локальный шлюз связан с виртуальной сетью клиента. | струна |
| vpnClientConfiguration | Ссылка на ресурс VpnClientConfiguration, представляющий конфигурации VPNClient P2S. | VpnClientConfiguration (Конфигурация VPN) |
| vpnGatewayGeneration | Поколение для этого VirtualNetworkGateway. Значение None, если gatewayType не является VPN. | "Поколение1" "Поколение2" "Нет" |
| vpnТип | Тип этого шлюза виртуальной сети. | PolicyBased RouteBased |
VirtualNetworkGatewaySku (Виртуальный сетевой шлюз)
| Имя | Описание | Ценность |
|---|---|---|
| имя | Имя SKU шлюза. | "Базовый" 'ErGw1AZ' «ЭрГв2АЗ» «ErGw3AZ» "HighPerformance" "Стандартный" "UltraPerformance" VpnGw1 VpnGw1AZ VpnGw2 VpnGw2AZ VpnGw3 VpnGw3AZ VpnGw4 VpnGw4AZ VpnGw5 VpnGw5AZ |
| ярус | Уровень SKU шлюза. | "Базовый" 'ErGw1AZ' «ЭрГв2АЗ» «ErGw3AZ» "HighPerformance" "Стандартный" "UltraPerformance" VpnGw1 VpnGw1AZ VpnGw2 VpnGw2AZ VpnGw3 VpnGw3AZ VpnGw4 VpnGw4AZ VpnGw5 VpnGw5AZ |
VngClientConnectionConfiguration
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства корневого сертификата vpn-клиента. | VngClientConnectionConfigurationProperties |
VngClientConnectionConfigurationProperties
| Имя | Описание | Ценность |
|---|---|---|
| virtualNetworkGatewayPolicyGroups | Список ссылок на virtualNetworkGatewayPolicyGroups | SubResource[] (обязательно) |
| vpnClientAddressPool | Ссылка на ресурс адресного пространства, представляющий адресное пространство для VpnClient P2S. | AddressSpace (обязательно) |
VpnClientConfiguration (Конфигурация VPN)
| Имя | Описание | Ценность |
|---|---|---|
| aadАудитория | Свойство AADAudience ресурса VirtualNetworkGateway для подключения vpn-клиента, используемого для проверки подлинности AAD. | струна |
| aadЭмитент | Свойство AADIssuer ресурса VirtualNetworkGateway для подключения vpn-клиента, используемого для проверки подлинности AAD. | струна |
| aadTenant | Свойство AADTenant ресурса VirtualNetworkGateway для подключения vpn-клиента, используемого для проверки подлинности AAD. | струна |
| radiusServerAddress | Свойство адреса сервера радиуса ресурса VirtualNetworkGateway для подключения vpn-клиента. | струна |
| radiusServers | Свойство radiusServers для конфигурации нескольких серверов радиуса. | RadiusServer[] |
| radiusServerSecret | Свойство секрета радиуса ресурса VirtualNetworkGateway для подключения vpn-клиента. | струна |
| vngClientConnectionConfigurations | политика подключения пула IP-адресов для клиента P2S шлюза виртуальной сети. | VngClientConnectionConfiguration[] |
| vpnТипы аутентификации | Типы проверки подлинности VPN для шлюза виртуальной сети.. | Массив строк, содержащий любой из: AAD "Сертификат" "Radius" |
| vpnClientAddressPool | Ссылка на ресурс адресного пространства, представляющий адресное пространство для VpnClient P2S. | Адресное пространство |
| vpnClientIpsecPolicies | VpnClientIpsecPolicies для клиента P2S шлюза виртуальной сети. | IpsecPolicy[] |
| vpnClientProtocols | VpnClientProtocols для шлюза виртуальной сети. | Массив строк, содержащий любой из: «ИкеV2» OpenVPN SSTP |
| vpnClientотозванныеСертификаты | VpnClientRevokedCertificate для шлюза виртуальной сети. | VpnClientRevokedCertificate[] |
| vpnClientRootCertificates | VpnClientRootCertificate для шлюза виртуальной сети. | VpnClientRootCertificate[] |
VpnClientотозванныйСертификат
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства отозванного сертификата vpn-клиента. | VpnClientRevokedCertificatePropertiesFormat |
VpnClientRevokedCertificatePropertiesFormat
| Имя | Описание | Ценность |
|---|---|---|
| Отпечаток | Отпечаток отозванного сертификата VPN-клиента. | струна |
Сертификат VpnClientRoot
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства корневого сертификата vpn-клиента. | VpnClientRootCertificatePropertiesFormat (обязательно) |
VpnClientRootCertificatePropertiesFormat
| Имя | Описание | Ценность |
|---|---|---|
| publicCertData | Общедоступные данные сертификата. | строка (обязательно) |
VpnNatRuleMapping
| Имя | Описание | Ценность |
|---|---|---|
| адресное пространство | Адресное пространство для сопоставления Vpn NatRule. | струна |
| portRange | Диапазон портов для сопоставления Vpn NatRule. | струна |
Примеры использования
Примеры Bicep
Простой пример развертывания шлюза виртуальной сети для обеспечения безопасного подключения между организациями.
param resourceName string = 'acctest0001'
param location string = 'centralus'
resource publicIPAddress 'Microsoft.Network/publicIPAddresses@2022-07-01' = {
name: resourceName
location: location
properties: {
ddosSettings: {
protectionMode: 'VirtualNetworkInherited'
}
idleTimeoutInMinutes: 4
publicIPAddressVersion: 'IPv4'
publicIPAllocationMethod: 'Static'
}
sku: {
name: 'Standard'
tier: 'Regional'
}
}
resource virtualNetwork 'Microsoft.Network/virtualNetworks@2022-07-01' = {
name: resourceName
location: location
properties: {
addressSpace: {
addressPrefixes: [
'10.6.0.0/16'
]
}
dhcpOptions: {
dnsServers: []
}
subnets: []
}
tags: {
SkipASMAzSecPack: 'true'
}
}
resource virtualNetworkGateway 'Microsoft.Network/virtualNetworkGateways@2022-07-01' = {
name: resourceName
location: location
properties: {
activeActive: false
enableBgp: false
enablePrivateIpAddress: false
gatewayType: 'ExpressRoute'
ipConfigurations: [
{
name: 'vnetGatewayConfig'
properties: {
privateIPAllocationMethod: 'Dynamic'
publicIPAddress: {
id: publicIPAddress.id
}
subnet: {
id: subnet.id
}
}
}
]
sku: {
name: 'Standard'
tier: 'Standard'
}
vpnType: 'RouteBased'
}
}
resource subnet 'Microsoft.Network/virtualNetworks/subnets@2022-07-01' = {
parent: virtualNetwork
name: 'GatewaySubnet'
properties: {
addressPrefix: '10.6.1.0/24'
delegations: []
privateEndpointNetworkPolicies: 'Enabled'
privateLinkServiceNetworkPolicies: 'Enabled'
serviceEndpointPolicies: []
serviceEndpoints: []
}
}
Проверенные модули Azure
Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.
| Модуль | Описание |
|---|---|
| шлюз виртуальной сети | Модуль ресурсов AVM для шлюза виртуальной сети |
Примеры быстрого запуска Azure
Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.
| Bicep-файл | Описание |
|---|---|
| создание виртуальной сети BGP для подключения виртуальной сети | Этот шаблон позволяет подключить два виртуальных сети с помощью шлюзов виртуальной сети и BGP. |
| создание шлюза "точка — сеть" с помощью Azure AD | Этот шаблон развертывает шлюз виртуальной сети VPN, настроенный с подключением типа "точка — сеть" Azure Active Directory |
| канал ExpressRoute с частным пирингом и виртуальной сетью Azure | Этот шаблон настраивает пиринг Microsoft ExpressRoute, развертывает виртуальную сеть Azure с помощью шлюза Expressroute и связывает виртуальную сеть с каналом ExpressRoute. |
| VPN типа "сеть — сеть" с помощью vpn-шлюзов active-active с BGP | Этот шаблон позволяет развернуть VPN типа "сеть — сеть" между двумя виртуальными сетями с VPN-шлюзами в конфигурации active-active с помощью BGP. Каждый VPN-шлюз Azure разрешает полное доменное имя удаленных одноранговых узлов, чтобы определить общедоступный IP-адрес удаленного VPN-шлюза. Шаблон выполняется должным образом в регионах Azure с зонами доступности. |
| использовать брандмауэр Azure в качестве DNS-прокси в топологии & периферийных концентратора | В этом примере показано, как развернуть звездообразную топологию в Azure с помощью брандмауэра Azure. Виртуальная сеть концентратора выступает в качестве центральной точки подключения ко многим периферийным виртуальным сетям, подключенным к центральной виртуальной сети через пиринг между виртуальными сетями. |
Определение ресурса шаблона ARM
Тип ресурса VirtualNetworkGateways можно развернуть с помощью операций, предназначенных для следующих целей:
- группы ресурсов . См. команды развертывания группы ресурсов
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.Network/virtualNetworkGateways, добавьте следующий код JSON в шаблон.
{
"type": "Microsoft.Network/virtualNetworkGateways",
"apiVersion": "2022-05-01",
"name": "string",
"extendedLocation": {
"name": "string",
"type": "string"
},
"location": "string",
"properties": {
"activeActive": "bool",
"allowRemoteVnetTraffic": "bool",
"allowVirtualWanTraffic": "bool",
"bgpSettings": {
"asn": "int",
"bgpPeeringAddress": "string",
"bgpPeeringAddresses": [
{
"customBgpIpAddresses": [ "string" ],
"ipconfigurationId": "string"
}
],
"peerWeight": "int"
},
"customRoutes": {
"addressPrefixes": [ "string" ]
},
"disableIPSecReplayProtection": "bool",
"enableBgp": "bool",
"enableBgpRouteTranslationForNat": "bool",
"enableDnsForwarding": "bool",
"enablePrivateIpAddress": "bool",
"gatewayDefaultSite": {
"id": "string"
},
"gatewayType": "string",
"ipConfigurations": [
{
"id": "string",
"name": "string",
"properties": {
"privateIPAllocationMethod": "string",
"publicIPAddress": {
"id": "string"
},
"subnet": {
"id": "string"
}
}
}
],
"natRules": [
{
"id": "string",
"name": "string",
"properties": {
"externalMappings": [
{
"addressSpace": "string",
"portRange": "string"
}
],
"internalMappings": [
{
"addressSpace": "string",
"portRange": "string"
}
],
"ipConfigurationId": "string",
"mode": "string",
"type": "string"
}
}
],
"sku": {
"name": "string",
"tier": "string"
},
"virtualNetworkGatewayPolicyGroups": [
{
"id": "string",
"name": "string",
"properties": {
"isDefault": "bool",
"policyMembers": [
{
"attributeType": "string",
"attributeValue": "string",
"name": "string"
}
],
"priority": "int"
}
}
],
"vNetExtendedLocationResourceId": "string",
"vpnClientConfiguration": {
"aadAudience": "string",
"aadIssuer": "string",
"aadTenant": "string",
"radiusServerAddress": "string",
"radiusServers": [
{
"radiusServerAddress": "string",
"radiusServerScore": "int",
"radiusServerSecret": "string"
}
],
"radiusServerSecret": "string",
"vngClientConnectionConfigurations": [
{
"id": "string",
"name": "string",
"properties": {
"virtualNetworkGatewayPolicyGroups": [
{
"id": "string"
}
],
"vpnClientAddressPool": {
"addressPrefixes": [ "string" ]
}
}
}
],
"vpnAuthenticationTypes": [ "string" ],
"vpnClientAddressPool": {
"addressPrefixes": [ "string" ]
},
"vpnClientIpsecPolicies": [
{
"dhGroup": "string",
"ikeEncryption": "string",
"ikeIntegrity": "string",
"ipsecEncryption": "string",
"ipsecIntegrity": "string",
"pfsGroup": "string",
"saDataSizeKilobytes": "int",
"saLifeTimeSeconds": "int"
}
],
"vpnClientProtocols": [ "string" ],
"vpnClientRevokedCertificates": [
{
"id": "string",
"name": "string",
"properties": {
"thumbprint": "string"
}
}
],
"vpnClientRootCertificates": [
{
"id": "string",
"name": "string",
"properties": {
"publicCertData": "string"
}
}
]
},
"vpnGatewayGeneration": "string",
"vpnType": "string"
},
"tags": {
"{customized property}": "string"
}
}
Значения свойств
Microsoft.Network/виртуальные сетевые шлюзы
| Имя | Описание | Ценность |
|---|---|---|
| apiVersion | Версия API | '2022-05-01' |
| расширенноеМестоположение | Расширенное расположение шлюза локальной виртуальной сети типа. | РасширенноеМестоположение |
| местоположение | Расположение ресурса. | струна |
| имя | Имя ресурса | строка (обязательно) |
| свойства | Свойства шлюза виртуальной сети. | VirtualNetworkGatewayPropertiesFormat (обязательно) |
| Теги | Теги ресурсов | Словарь имен и значений тегов. См. теги в шаблонах |
| тип | Тип ресурса | "Microsoft.Network/virtualNetworkGateways" |
Адресное пространство
| Имя | Описание | Ценность |
|---|---|---|
| addressПрефиксы | Список блоков адресов, зарезервированных для этой виртуальной сети в нотации CIDR. | строка[] |
Настройки Bgp
| Имя | Описание | Ценность |
|---|---|---|
| асн | ASN докладчика BGP. | int Ограничения целостности: Минимальное значение = 0 Максимальное значение = 4294967295 |
| bgpPeeringAddress | Адрес пиринга BGP и идентификатор BGP этого докладчика BGP. | струна |
| bgpPeeringAddresses | Адрес пиринга BGP с идентификатором IP-конфигурации для шлюза виртуальной сети. | IPConfigurationBgpPeeringAddress[] |
| одноранговый вес | Вес, добавленный к маршрутам, извлеченным из этого докладчика BGP. | инт |
Расширенное местоположение
| Имя | Описание | Ценность |
|---|---|---|
| имя | Имя расширенного расположения. | струна |
| тип | Тип расширенного расположения. | EdgeZone |
IPConfigurationBgpPeeringAddress
| Имя | Описание | Ценность |
|---|---|---|
| customBgpIpАдреса | Список пользовательских адресов пиринга BGP, принадлежащих ip-конфигурации. | строка[] |
| ipconfigurationId | Идентификатор конфигурации IP-адресов, принадлежавшей шлюзу. | струна |
Политика IPSEC
| Имя | Описание | Ценность |
|---|---|---|
| dhGroup | Группа DH, используемая на этапе IKE 1 для начального sa. | DHGroup1 DHGroup14 DHGroup2 DHGroup2048 DHGroup24 "ECP256" "ECP384" "Нет" (обязательно) |
| ikeШифрование | Алгоритм шифрования IKE (этап IKE 2). | "AES128" "AES192" "AES256" "DES" DES3 "GCMAES128" "GCMAES256" (обязательно) |
| ikeIntegrity | Алгоритм целостности IKE (этап IKE 2). | "GCMAES128" "GCMAES256" "MD5" "SHA1" Sha256 SHA384 (обязательно) |
| ipsecШифрование | Алгоритм шифрования IPSec (этап IKE 1). | "AES128" "AES192" "AES256" "DES" DES3 "GCMAES128" "GCMAES192" "GCMAES256" "Нет" (обязательно) |
| ipsecIntegrity | Алгоритм целостности IPSec (этап IKE 1). | "GCMAES128" "GCMAES192" "GCMAES256" "MD5" "SHA1" SHA256 (обязательно) |
| Группа pfs | Группа Pfs, используемая на этапе IKE 2 для нового дочернего SA. | "ECP256" "ECP384" "Нет" «ПФС1» «ПФС14» «ПФС2» "PFS2048" «ПФС24» PFSMM (обязательно) |
| saDataSizeKilobytes | Размер полезных данных IPSec (также называемый быстрым режимом или этапом 2 SA) в КБ для сайта vpn-туннеля. | int (обязательно) |
| saLifeTimeSeconds | Связь безопасности IPSec (также называемая быстрым режимом или этапом 2 SA) в секундах для сайта vpn-туннеля сайта. | int (обязательно) |
Сервер RadiusServer
| Имя | Описание | Ценность |
|---|---|---|
| radiusServerAddress | Адрес этого сервера radius. | строка (обязательно) |
| radiusServerScore | Начальная оценка, назначенная этому серверу radius. | инт |
| radiusServerSecret | Секрет, используемый для этого сервера radius. | струна |
Теги ресурса
| Имя | Описание | Ценность |
|---|
Подресурс
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
VirtualNetworkGatewayIPConfiguration
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства IP-конфигурации шлюза виртуальной сети. | VirtualNetworkGatewayIPConfigurationPropertiesFormat |
VirtualNetworkGatewayIPConfigurationPropertiesFormat
| Имя | Описание | Ценность |
|---|---|---|
| privateIPAllocationMethod | Метод выделения частных IP-адресов. | Dynamic "Статический" |
| publicIPАдрессест | Ссылка на ресурс общедоступного IP-адреса. | Подресурс |
| подсеть | Ссылка на ресурс подсети. | Подресурс |
Правило VirtualNetworkGatewayNatRule
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства правила NAT шлюза виртуальной сети. | Свойства VirtualNetworkGatewayNatRule |
Свойства VirtualNetworkGatewayNatRule
| Имя | Описание | Ценность |
|---|---|---|
| externalMappings | Внешнее сопоставление частных IP-адресов для NAT. | VpnNatRuleMapping[] |
| internalMappings | Внутреннее сопоставление частных IP-адресов для NAT. | VpnNatRuleMapping[] |
| ipConfigurationId | Идентификатор конфигурации IP-адресов, к этому правилу NAT применяется. | струна |
| режим | Направление исходного NAT ДЛЯ VPN-NAT. | EgressSnat «IngressSnat» |
| тип | Тип правила NAT для VPN NAT. | Dynamic "Статический" |
VirtualNetworkGatewayPolicyGroup
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства tVirtualNetworkGatewayPolicyGroup. | VirtualNetworkGatewayPolicyGroupProperties |
VirtualNetworkGatewayPolicyУчастник группы
| Имя | Описание | Ценность |
|---|---|---|
| attributeType | Тип атрибута члена политики VPN. | AADGroupId CertificateGroupId RadiusAzureGroupId |
| Значение атрибута | Значение атрибута, используемого для этого объекта VirtualNetworkGatewayPolicyGroupMember. | струна |
| имя | Имя VirtualNetworkGatewayPolicyGroupMember. | струна |
VirtualNetworkGatewayPolicyGroupProperties
| Имя | Описание | Ценность |
|---|---|---|
| isDefault | Показывает, является ли это VirtualNetworkGatewayPolicyGroup или нет. | bool (обязательно) |
| policyУчастники | Несколько policyMembers для VirtualNetworkGatewayPolicyGroup. | VirtualNetworkGatewayPolicyGroupMember[] (обязательно) |
| приоритет | Приоритет для VirtualNetworkGatewayPolicyGroup. | int (обязательно) |
VirtualNetworkGatewayPropertiesFormat
| Имя | Описание | Ценность |
|---|---|---|
| активныйАктивный | Флаг ActiveActive. | булевая переменная (bool) |
| allowRemoteVnetTraffic | Настройте этот шлюз для приема трафика из других виртуальных сетей Azure. Эта конфигурация не поддерживает подключение к виртуальной глобальной сети Azure. | булевая переменная (bool) |
| allowVirtualWanTraffic | Настраивает этот шлюз для приема трафика из удаленных сетей виртуальной глобальной сети. | булевая переменная (bool) |
| bgpНастройки | Параметры динамиков BGP шлюза виртуальной сети. | Настройки Bgp |
| customRoutes | Ссылка на ресурс адресного пространства, представляющий адресное пространство пользовательских маршрутов, указанное клиентом для шлюза виртуальной сети и VpnClient. | Адресное пространство |
| disableIPSecReplayProtection | флаг disableIPSecReplayProtection. | булевая переменная (bool) |
| enableBgp | Включена ли BGP для этого шлюза виртуальной сети или нет. | булевая переменная (bool) |
| enableBgpRouteTranslationForNat | Флаг EnableBgpRouteTranslationForNat. | булевая переменная (bool) |
| enableDnsForwarding | Включена ли переадресация DNS. | булевая переменная (bool) |
| enablePrivateIpAddress | Необходимо ли включить частный IP-адрес в этом шлюзе для подключений или нет. | булевая переменная (bool) |
| gatewayDefaultSite | Ссылка на ресурс LocalNetworkGateway, представляющий локальный сетевой сайт с маршрутами по умолчанию. Назначьте значение NULL в случае удаления существующего параметра сайта по умолчанию. | Подресурс |
| Тип шлюза | Тип этого шлюза виртуальной сети. | ExpressRoute «Локальный шлюз» "Vpn" |
| ipКонфигурации | IP-конфигурации для шлюза виртуальной сети. | VirtualNetworkGatewayIPConfiguration[] |
| natRules | NatRules для шлюза виртуальной сети. | VirtualNetworkGatewayNatRule[] |
| SKU | Ссылка на ресурс VirtualNetworkGatewaySku, представляющий номер SKU, выбранный для шлюза виртуальной сети. | VirtualNetworkGatewaySku (Виртуальный сетевой шлюз) |
| virtualNetworkGatewayPolicyGroups | Ссылка на ресурс VirtualNetworkGatewayPolicyGroup, представляющий доступную виртуальную сетьGatewayPolicyGroup для шлюза. | VirtualNetworkGatewayPolicyGroup[] |
| vNetExtendedLocationResourceId | Идентификатор ресурса виртуальной сети клиента. VirtualNetworkGateway типа локальный шлюз связан с виртуальной сетью клиента. | струна |
| vpnClientConfiguration | Ссылка на ресурс VpnClientConfiguration, представляющий конфигурации VPNClient P2S. | VpnClientConfiguration (Конфигурация VPN) |
| vpnGatewayGeneration | Поколение для этого VirtualNetworkGateway. Значение None, если gatewayType не является VPN. | "Поколение1" "Поколение2" "Нет" |
| vpnТип | Тип этого шлюза виртуальной сети. | PolicyBased RouteBased |
VirtualNetworkGatewaySku (Виртуальный сетевой шлюз)
| Имя | Описание | Ценность |
|---|---|---|
| имя | Имя SKU шлюза. | "Базовый" 'ErGw1AZ' «ЭрГв2АЗ» «ErGw3AZ» "HighPerformance" "Стандартный" "UltraPerformance" VpnGw1 VpnGw1AZ VpnGw2 VpnGw2AZ VpnGw3 VpnGw3AZ VpnGw4 VpnGw4AZ VpnGw5 VpnGw5AZ |
| ярус | Уровень SKU шлюза. | "Базовый" 'ErGw1AZ' «ЭрГв2АЗ» «ErGw3AZ» "HighPerformance" "Стандартный" "UltraPerformance" VpnGw1 VpnGw1AZ VpnGw2 VpnGw2AZ VpnGw3 VpnGw3AZ VpnGw4 VpnGw4AZ VpnGw5 VpnGw5AZ |
VngClientConnectionConfiguration
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства корневого сертификата vpn-клиента. | VngClientConnectionConfigurationProperties |
VngClientConnectionConfigurationProperties
| Имя | Описание | Ценность |
|---|---|---|
| virtualNetworkGatewayPolicyGroups | Список ссылок на virtualNetworkGatewayPolicyGroups | SubResource[] (обязательно) |
| vpnClientAddressPool | Ссылка на ресурс адресного пространства, представляющий адресное пространство для VpnClient P2S. | AddressSpace (обязательно) |
VpnClientConfiguration (Конфигурация VPN)
| Имя | Описание | Ценность |
|---|---|---|
| aadАудитория | Свойство AADAudience ресурса VirtualNetworkGateway для подключения vpn-клиента, используемого для проверки подлинности AAD. | струна |
| aadЭмитент | Свойство AADIssuer ресурса VirtualNetworkGateway для подключения vpn-клиента, используемого для проверки подлинности AAD. | струна |
| aadTenant | Свойство AADTenant ресурса VirtualNetworkGateway для подключения vpn-клиента, используемого для проверки подлинности AAD. | струна |
| radiusServerAddress | Свойство адреса сервера радиуса ресурса VirtualNetworkGateway для подключения vpn-клиента. | струна |
| radiusServers | Свойство radiusServers для конфигурации нескольких серверов радиуса. | RadiusServer[] |
| radiusServerSecret | Свойство секрета радиуса ресурса VirtualNetworkGateway для подключения vpn-клиента. | струна |
| vngClientConnectionConfigurations | политика подключения пула IP-адресов для клиента P2S шлюза виртуальной сети. | VngClientConnectionConfiguration[] |
| vpnТипы аутентификации | Типы проверки подлинности VPN для шлюза виртуальной сети.. | Массив строк, содержащий любой из: AAD "Сертификат" "Radius" |
| vpnClientAddressPool | Ссылка на ресурс адресного пространства, представляющий адресное пространство для VpnClient P2S. | Адресное пространство |
| vpnClientIpsecPolicies | VpnClientIpsecPolicies для клиента P2S шлюза виртуальной сети. | IpsecPolicy[] |
| vpnClientProtocols | VpnClientProtocols для шлюза виртуальной сети. | Массив строк, содержащий любой из: «ИкеV2» OpenVPN SSTP |
| vpnClientотозванныеСертификаты | VpnClientRevokedCertificate для шлюза виртуальной сети. | VpnClientRevokedCertificate[] |
| vpnClientRootCertificates | VpnClientRootCertificate для шлюза виртуальной сети. | VpnClientRootCertificate[] |
VpnClientотозванныйСертификат
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства отозванного сертификата vpn-клиента. | VpnClientRevokedCertificatePropertiesFormat |
VpnClientRevokedCertificatePropertiesFormat
| Имя | Описание | Ценность |
|---|---|---|
| Отпечаток | Отпечаток отозванного сертификата VPN-клиента. | струна |
Сертификат VpnClientRoot
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства корневого сертификата vpn-клиента. | VpnClientRootCertificatePropertiesFormat (обязательно) |
VpnClientRootCertificatePropertiesFormat
| Имя | Описание | Ценность |
|---|---|---|
| publicCertData | Общедоступные данные сертификата. | строка (обязательно) |
VpnNatRuleMapping
| Имя | Описание | Ценность |
|---|---|---|
| адресное пространство | Адресное пространство для сопоставления Vpn NatRule. | струна |
| portRange | Диапазон портов для сопоставления Vpn NatRule. | струна |
Примеры использования
Шаблоны быстрого запуска Azure
Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.
| Шаблон | Описание |
|---|---|
|
среда службы приложений с серверной SQL Azure развертывание |
Этот шаблон создает среду службы приложений с серверной частью SQL Azure вместе с частными конечными точками вместе с связанными ресурсами, обычно используемыми в частной или изолированной среде. |
|
подключение канала ExpressRoute к виртуальной сети развертывание |
Этот шаблон создает виртуальную сеть, шлюз ExpresRoute и подключение к подготовленному каналу ExpressRoute с настроенным AzurePrivatePeering. |
|
создание виртуальной сети BGP для подключения виртуальной сети развертывание |
Этот шаблон позволяет подключить два виртуальных сети с помощью шлюзов виртуальной сети и BGP. |
|
создание среды DevTest с помощью VPN-подключения P2S и IIS развертывание |
Этот шаблон создает простую среду DevTest с VPN типа "точка — сеть" и IIS на сервере Windows, который является отличным способом приступить к работе. |
|
создание шлюза "точка — сеть" развертывание |
Этот шаблон позволяет создать подключение типа "точка — сеть" с помощью VirtualNetworkGateways |
|
создание шлюза "точка — сеть" с помощью Azure AD развертывание |
Этот шаблон развертывает шлюз виртуальной сети VPN, настроенный с подключением типа "точка — сеть" Azure Active Directory |
|
создание VPN-подключения типа "сеть — сеть" развертывание |
Этот шаблон позволяет создать VPN-подключение типа "сеть — сеть" с помощью шлюзов виртуальной сети |
|
создание VPN-подключения типа "сеть — сеть" с помощью виртуальной машины развертывание |
Этот шаблон позволяет создать VPN-подключение типа "сеть — сеть" с помощью шлюзов виртуальной сети |
|
создание подключения виртуальной сети к виртуальной сети между двумя регионами развертывание |
Этот шаблон позволяет подключать два виртуальных сети в разных регионах с помощью шлюзов виртуальной сети |
|
Создание SQL MI с настроенным подключением типа "точка — сеть" развертывание |
Разверните управляемый экземпляр Базы данных SQL Azure (SQL MI) и шлюз виртуальной сети, настроенный для подключения типа "точка — сеть" в новой виртуальной сети. |
|
создание трех виртуальных сетей для демонстрации транзитивных подключений BGP развертывание |
Этот шаблон развертывает три виртуальных сети, подключенных с помощью шлюзов виртуальной сети и подключений с поддержкой BGP |
|
Создание виртуальной сети с двумя подсетями, локальной сетью и шлюзом развертывание |
Этот шаблон создает виртуальную сеть, 2 подсети и шлюз |
|
Развертывание изолированной топологии концентратора и периферийной топологии развертывание |
Этот шаблон создает базовую настройку топологии концентратора и периферийной топологии. Она создает виртуальную сеть концентратора с подсетями DMZ, управления, общего доступа и шлюза (при необходимости) с двумя периферийными виртуальными сетями (разработка и производство), содержащим подсеть рабочей нагрузки. Он также развертывает Jump-Host Windows в подсети управления концентратора и устанавливает пиринги виртуальной сети между концентратором и двумя периферийными устройствами. |
|
Развертывание георепликации HBase развертывание |
Этот шаблон позволяет настроить среду Azure для репликации HBase в двух разных регионах с подключением VPN к виртуальной сети. |
|
канал ExpressRoute с частным пирингом и виртуальной сетью Azure развертывание |
Этот шаблон настраивает пиринг Microsoft ExpressRoute, развертывает виртуальную сеть Azure с помощью шлюза Expressroute и связывает виртуальную сеть с каналом ExpressRoute. |
|
расширение существующей виртуальной сети Azure до конфигурации нескольких виртуальных сетей развертывание |
Этот шаблон позволяет расширить существующую среду виртуальной сети в среду с несколькими виртуальными сетями, которая расширяется между двумя регионами центра обработки данных с помощью шлюзов виртуальной сети и виртуальной сети. |
|
VPN типа "сеть — сеть" с помощью vpn-шлюзов active-active с BGP развертывание |
Этот шаблон позволяет развернуть VPN типа "сеть — сеть" между двумя виртуальными сетями с VPN-шлюзами в конфигурации active-active с помощью BGP. Каждый VPN-шлюз Azure разрешает полное доменное имя удаленных одноранговых узлов, чтобы определить общедоступный IP-адрес удаленного VPN-шлюза. Шаблон выполняется должным образом в регионах Azure с зонами доступности. |
|
использовать брандмауэр Azure в качестве DNS-прокси в топологии & периферийных концентратора развертывание |
В этом примере показано, как развернуть звездообразную топологию в Azure с помощью брандмауэра Azure. Виртуальная сеть концентратора выступает в качестве центральной точки подключения ко многим периферийным виртуальным сетям, подключенным к центральной виртуальной сети через пиринг между виртуальными сетями. |
Определение ресурса Terraform (поставщик AzAPI)
Тип ресурса VirtualNetworkGateways можно развернуть с помощью операций, предназначенных для следующих целей:
- Группы ресурсов
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.Network/virtualNetworkGateways, добавьте следующий объект Terraform в шаблон.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Network/virtualNetworkGateways@2022-05-01"
name = "string"
parent_id = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = {
extendedLocation = {
name = "string"
type = "string"
}
properties = {
activeActive = bool
allowRemoteVnetTraffic = bool
allowVirtualWanTraffic = bool
bgpSettings = {
asn = int
bgpPeeringAddress = "string"
bgpPeeringAddresses = [
{
customBgpIpAddresses = [
"string"
]
ipconfigurationId = "string"
}
]
peerWeight = int
}
customRoutes = {
addressPrefixes = [
"string"
]
}
disableIPSecReplayProtection = bool
enableBgp = bool
enableBgpRouteTranslationForNat = bool
enableDnsForwarding = bool
enablePrivateIpAddress = bool
gatewayDefaultSite = {
id = "string"
}
gatewayType = "string"
ipConfigurations = [
{
id = "string"
name = "string"
properties = {
privateIPAllocationMethod = "string"
publicIPAddress = {
id = "string"
}
subnet = {
id = "string"
}
}
}
]
natRules = [
{
id = "string"
name = "string"
properties = {
externalMappings = [
{
addressSpace = "string"
portRange = "string"
}
]
internalMappings = [
{
addressSpace = "string"
portRange = "string"
}
]
ipConfigurationId = "string"
mode = "string"
type = "string"
}
}
]
sku = {
name = "string"
tier = "string"
}
virtualNetworkGatewayPolicyGroups = [
{
id = "string"
name = "string"
properties = {
isDefault = bool
policyMembers = [
{
attributeType = "string"
attributeValue = "string"
name = "string"
}
]
priority = int
}
}
]
vNetExtendedLocationResourceId = "string"
vpnClientConfiguration = {
aadAudience = "string"
aadIssuer = "string"
aadTenant = "string"
radiusServerAddress = "string"
radiusServers = [
{
radiusServerAddress = "string"
radiusServerScore = int
radiusServerSecret = "string"
}
]
radiusServerSecret = "string"
vngClientConnectionConfigurations = [
{
id = "string"
name = "string"
properties = {
virtualNetworkGatewayPolicyGroups = [
{
id = "string"
}
]
vpnClientAddressPool = {
addressPrefixes = [
"string"
]
}
}
}
]
vpnAuthenticationTypes = [
"string"
]
vpnClientAddressPool = {
addressPrefixes = [
"string"
]
}
vpnClientIpsecPolicies = [
{
dhGroup = "string"
ikeEncryption = "string"
ikeIntegrity = "string"
ipsecEncryption = "string"
ipsecIntegrity = "string"
pfsGroup = "string"
saDataSizeKilobytes = int
saLifeTimeSeconds = int
}
]
vpnClientProtocols = [
"string"
]
vpnClientRevokedCertificates = [
{
id = "string"
name = "string"
properties = {
thumbprint = "string"
}
}
]
vpnClientRootCertificates = [
{
id = "string"
name = "string"
properties = {
publicCertData = "string"
}
}
]
}
vpnGatewayGeneration = "string"
vpnType = "string"
}
}
}
Значения свойств
Microsoft.Network/виртуальные сетевые шлюзы
| Имя | Описание | Ценность |
|---|---|---|
| расширенноеМестоположение | Расширенное расположение шлюза локальной виртуальной сети типа. | РасширенноеМестоположение |
| местоположение | Расположение ресурса. | струна |
| имя | Имя ресурса | строка (обязательно) |
| свойства | Свойства шлюза виртуальной сети. | VirtualNetworkGatewayPropertiesFormat (обязательно) |
| Теги | Теги ресурсов | Словарь имен и значений тегов. |
| тип | Тип ресурса | "Microsoft.Network/virtualNetworkGateways@2022-05-01" |
Адресное пространство
| Имя | Описание | Ценность |
|---|---|---|
| addressПрефиксы | Список блоков адресов, зарезервированных для этой виртуальной сети в нотации CIDR. | строка[] |
Настройки Bgp
| Имя | Описание | Ценность |
|---|---|---|
| асн | ASN докладчика BGP. | int Ограничения целостности: Минимальное значение = 0 Максимальное значение = 4294967295 |
| bgpPeeringAddress | Адрес пиринга BGP и идентификатор BGP этого докладчика BGP. | струна |
| bgpPeeringAddresses | Адрес пиринга BGP с идентификатором IP-конфигурации для шлюза виртуальной сети. | IPConfigurationBgpPeeringAddress[] |
| одноранговый вес | Вес, добавленный к маршрутам, извлеченным из этого докладчика BGP. | инт |
Расширенное местоположение
| Имя | Описание | Ценность |
|---|---|---|
| имя | Имя расширенного расположения. | струна |
| тип | Тип расширенного расположения. | EdgeZone |
IPConfigurationBgpPeeringAddress
| Имя | Описание | Ценность |
|---|---|---|
| customBgpIpАдреса | Список пользовательских адресов пиринга BGP, принадлежащих ip-конфигурации. | строка[] |
| ipconfigurationId | Идентификатор конфигурации IP-адресов, принадлежавшей шлюзу. | струна |
Политика IPSEC
| Имя | Описание | Ценность |
|---|---|---|
| dhGroup | Группа DH, используемая на этапе IKE 1 для начального sa. | DHGroup1 DHGroup14 DHGroup2 DHGroup2048 DHGroup24 "ECP256" "ECP384" "Нет" (обязательно) |
| ikeШифрование | Алгоритм шифрования IKE (этап IKE 2). | "AES128" "AES192" "AES256" "DES" DES3 "GCMAES128" "GCMAES256" (обязательно) |
| ikeIntegrity | Алгоритм целостности IKE (этап IKE 2). | "GCMAES128" "GCMAES256" "MD5" "SHA1" Sha256 SHA384 (обязательно) |
| ipsecШифрование | Алгоритм шифрования IPSec (этап IKE 1). | "AES128" "AES192" "AES256" "DES" DES3 "GCMAES128" "GCMAES192" "GCMAES256" "Нет" (обязательно) |
| ipsecIntegrity | Алгоритм целостности IPSec (этап IKE 1). | "GCMAES128" "GCMAES192" "GCMAES256" "MD5" "SHA1" SHA256 (обязательно) |
| Группа pfs | Группа Pfs, используемая на этапе IKE 2 для нового дочернего SA. | "ECP256" "ECP384" "Нет" «ПФС1» «ПФС14» «ПФС2» "PFS2048" «ПФС24» PFSMM (обязательно) |
| saDataSizeKilobytes | Размер полезных данных IPSec (также называемый быстрым режимом или этапом 2 SA) в КБ для сайта vpn-туннеля. | int (обязательно) |
| saLifeTimeSeconds | Связь безопасности IPSec (также называемая быстрым режимом или этапом 2 SA) в секундах для сайта vpn-туннеля сайта. | int (обязательно) |
Сервер RadiusServer
| Имя | Описание | Ценность |
|---|---|---|
| radiusServerAddress | Адрес этого сервера radius. | строка (обязательно) |
| radiusServerScore | Начальная оценка, назначенная этому серверу radius. | инт |
| radiusServerSecret | Секрет, используемый для этого сервера radius. | струна |
Теги ресурса
| Имя | Описание | Ценность |
|---|
Подресурс
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
VirtualNetworkGatewayIPConfiguration
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства IP-конфигурации шлюза виртуальной сети. | VirtualNetworkGatewayIPConfigurationPropertiesFormat |
VirtualNetworkGatewayIPConfigurationPropertiesFormat
| Имя | Описание | Ценность |
|---|---|---|
| privateIPAllocationMethod | Метод выделения частных IP-адресов. | Dynamic "Статический" |
| publicIPАдрессест | Ссылка на ресурс общедоступного IP-адреса. | Подресурс |
| подсеть | Ссылка на ресурс подсети. | Подресурс |
Правило VirtualNetworkGatewayNatRule
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства правила NAT шлюза виртуальной сети. | Свойства VirtualNetworkGatewayNatRule |
Свойства VirtualNetworkGatewayNatRule
| Имя | Описание | Ценность |
|---|---|---|
| externalMappings | Внешнее сопоставление частных IP-адресов для NAT. | VpnNatRuleMapping[] |
| internalMappings | Внутреннее сопоставление частных IP-адресов для NAT. | VpnNatRuleMapping[] |
| ipConfigurationId | Идентификатор конфигурации IP-адресов, к этому правилу NAT применяется. | струна |
| режим | Направление исходного NAT ДЛЯ VPN-NAT. | EgressSnat «IngressSnat» |
| тип | Тип правила NAT для VPN NAT. | Dynamic "Статический" |
VirtualNetworkGatewayPolicyGroup
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства tVirtualNetworkGatewayPolicyGroup. | VirtualNetworkGatewayPolicyGroupProperties |
VirtualNetworkGatewayPolicyУчастник группы
| Имя | Описание | Ценность |
|---|---|---|
| attributeType | Тип атрибута члена политики VPN. | AADGroupId CertificateGroupId RadiusAzureGroupId |
| Значение атрибута | Значение атрибута, используемого для этого объекта VirtualNetworkGatewayPolicyGroupMember. | струна |
| имя | Имя VirtualNetworkGatewayPolicyGroupMember. | струна |
VirtualNetworkGatewayPolicyGroupProperties
| Имя | Описание | Ценность |
|---|---|---|
| isDefault | Показывает, является ли это VirtualNetworkGatewayPolicyGroup или нет. | bool (обязательно) |
| policyУчастники | Несколько policyMembers для VirtualNetworkGatewayPolicyGroup. | VirtualNetworkGatewayPolicyGroupMember[] (обязательно) |
| приоритет | Приоритет для VirtualNetworkGatewayPolicyGroup. | int (обязательно) |
VirtualNetworkGatewayPropertiesFormat
| Имя | Описание | Ценность |
|---|---|---|
| активныйАктивный | Флаг ActiveActive. | булевая переменная (bool) |
| allowRemoteVnetTraffic | Настройте этот шлюз для приема трафика из других виртуальных сетей Azure. Эта конфигурация не поддерживает подключение к виртуальной глобальной сети Azure. | булевая переменная (bool) |
| allowVirtualWanTraffic | Настраивает этот шлюз для приема трафика из удаленных сетей виртуальной глобальной сети. | булевая переменная (bool) |
| bgpНастройки | Параметры динамиков BGP шлюза виртуальной сети. | Настройки Bgp |
| customRoutes | Ссылка на ресурс адресного пространства, представляющий адресное пространство пользовательских маршрутов, указанное клиентом для шлюза виртуальной сети и VpnClient. | Адресное пространство |
| disableIPSecReplayProtection | флаг disableIPSecReplayProtection. | булевая переменная (bool) |
| enableBgp | Включена ли BGP для этого шлюза виртуальной сети или нет. | булевая переменная (bool) |
| enableBgpRouteTranslationForNat | Флаг EnableBgpRouteTranslationForNat. | булевая переменная (bool) |
| enableDnsForwarding | Включена ли переадресация DNS. | булевая переменная (bool) |
| enablePrivateIpAddress | Необходимо ли включить частный IP-адрес в этом шлюзе для подключений или нет. | булевая переменная (bool) |
| gatewayDefaultSite | Ссылка на ресурс LocalNetworkGateway, представляющий локальный сетевой сайт с маршрутами по умолчанию. Назначьте значение NULL в случае удаления существующего параметра сайта по умолчанию. | Подресурс |
| Тип шлюза | Тип этого шлюза виртуальной сети. | ExpressRoute «Локальный шлюз» "Vpn" |
| ipКонфигурации | IP-конфигурации для шлюза виртуальной сети. | VirtualNetworkGatewayIPConfiguration[] |
| natRules | NatRules для шлюза виртуальной сети. | VirtualNetworkGatewayNatRule[] |
| SKU | Ссылка на ресурс VirtualNetworkGatewaySku, представляющий номер SKU, выбранный для шлюза виртуальной сети. | VirtualNetworkGatewaySku (Виртуальный сетевой шлюз) |
| virtualNetworkGatewayPolicyGroups | Ссылка на ресурс VirtualNetworkGatewayPolicyGroup, представляющий доступную виртуальную сетьGatewayPolicyGroup для шлюза. | VirtualNetworkGatewayPolicyGroup[] |
| vNetExtendedLocationResourceId | Идентификатор ресурса виртуальной сети клиента. VirtualNetworkGateway типа локальный шлюз связан с виртуальной сетью клиента. | струна |
| vpnClientConfiguration | Ссылка на ресурс VpnClientConfiguration, представляющий конфигурации VPNClient P2S. | VpnClientConfiguration (Конфигурация VPN) |
| vpnGatewayGeneration | Поколение для этого VirtualNetworkGateway. Значение None, если gatewayType не является VPN. | "Поколение1" "Поколение2" "Нет" |
| vpnТип | Тип этого шлюза виртуальной сети. | PolicyBased RouteBased |
VirtualNetworkGatewaySku (Виртуальный сетевой шлюз)
| Имя | Описание | Ценность |
|---|---|---|
| имя | Имя SKU шлюза. | "Базовый" 'ErGw1AZ' «ЭрГв2АЗ» «ErGw3AZ» "HighPerformance" "Стандартный" "UltraPerformance" VpnGw1 VpnGw1AZ VpnGw2 VpnGw2AZ VpnGw3 VpnGw3AZ VpnGw4 VpnGw4AZ VpnGw5 VpnGw5AZ |
| ярус | Уровень SKU шлюза. | "Базовый" 'ErGw1AZ' «ЭрГв2АЗ» «ErGw3AZ» "HighPerformance" "Стандартный" "UltraPerformance" VpnGw1 VpnGw1AZ VpnGw2 VpnGw2AZ VpnGw3 VpnGw3AZ VpnGw4 VpnGw4AZ VpnGw5 VpnGw5AZ |
VngClientConnectionConfiguration
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства корневого сертификата vpn-клиента. | VngClientConnectionConfigurationProperties |
VngClientConnectionConfigurationProperties
| Имя | Описание | Ценность |
|---|---|---|
| virtualNetworkGatewayPolicyGroups | Список ссылок на virtualNetworkGatewayPolicyGroups | SubResource[] (обязательно) |
| vpnClientAddressPool | Ссылка на ресурс адресного пространства, представляющий адресное пространство для VpnClient P2S. | AddressSpace (обязательно) |
VpnClientConfiguration (Конфигурация VPN)
| Имя | Описание | Ценность |
|---|---|---|
| aadАудитория | Свойство AADAudience ресурса VirtualNetworkGateway для подключения vpn-клиента, используемого для проверки подлинности AAD. | струна |
| aadЭмитент | Свойство AADIssuer ресурса VirtualNetworkGateway для подключения vpn-клиента, используемого для проверки подлинности AAD. | струна |
| aadTenant | Свойство AADTenant ресурса VirtualNetworkGateway для подключения vpn-клиента, используемого для проверки подлинности AAD. | струна |
| radiusServerAddress | Свойство адреса сервера радиуса ресурса VirtualNetworkGateway для подключения vpn-клиента. | струна |
| radiusServers | Свойство radiusServers для конфигурации нескольких серверов радиуса. | RadiusServer[] |
| radiusServerSecret | Свойство секрета радиуса ресурса VirtualNetworkGateway для подключения vpn-клиента. | струна |
| vngClientConnectionConfigurations | политика подключения пула IP-адресов для клиента P2S шлюза виртуальной сети. | VngClientConnectionConfiguration[] |
| vpnТипы аутентификации | Типы проверки подлинности VPN для шлюза виртуальной сети.. | Массив строк, содержащий любой из: AAD "Сертификат" "Radius" |
| vpnClientAddressPool | Ссылка на ресурс адресного пространства, представляющий адресное пространство для VpnClient P2S. | Адресное пространство |
| vpnClientIpsecPolicies | VpnClientIpsecPolicies для клиента P2S шлюза виртуальной сети. | IpsecPolicy[] |
| vpnClientProtocols | VpnClientProtocols для шлюза виртуальной сети. | Массив строк, содержащий любой из: «ИкеV2» OpenVPN SSTP |
| vpnClientотозванныеСертификаты | VpnClientRevokedCertificate для шлюза виртуальной сети. | VpnClientRevokedCertificate[] |
| vpnClientRootCertificates | VpnClientRootCertificate для шлюза виртуальной сети. | VpnClientRootCertificate[] |
VpnClientотозванныйСертификат
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства отозванного сертификата vpn-клиента. | VpnClientRevokedCertificatePropertiesFormat |
VpnClientRevokedCertificatePropertiesFormat
| Имя | Описание | Ценность |
|---|---|---|
| Отпечаток | Отпечаток отозванного сертификата VPN-клиента. | струна |
Сертификат VpnClientRoot
| Имя | Описание | Ценность |
|---|---|---|
| идентификатор | Идентификатор ресурса. | струна |
| имя | Имя ресурса, уникального в группе ресурсов. Это имя можно использовать для доступа к ресурсу. | струна |
| свойства | Свойства корневого сертификата vpn-клиента. | VpnClientRootCertificatePropertiesFormat (обязательно) |
VpnClientRootCertificatePropertiesFormat
| Имя | Описание | Ценность |
|---|---|---|
| publicCertData | Общедоступные данные сертификата. | строка (обязательно) |
VpnNatRuleMapping
| Имя | Описание | Ценность |
|---|---|---|
| адресное пространство | Адресное пространство для сопоставления Vpn NatRule. | струна |
| portRange | Диапазон портов для сопоставления Vpn NatRule. | струна |
Примеры использования
Примеры Terraform
Простой пример развертывания шлюза виртуальной сети для обеспечения безопасного подключения между организациями.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "centralus"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "virtualNetwork" {
type = "Microsoft.Network/virtualNetworks@2022-07-01"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
addressSpace = {
addressPrefixes = [
"10.6.0.0/16",
]
}
dhcpOptions = {
dnsServers = [
]
}
subnets = [
]
}
tags = {
SkipASMAzSecPack = "true"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
lifecycle {
ignore_changes = [body.properties.subnets]
}
}
resource "azapi_resource" "publicIPAddress" {
type = "Microsoft.Network/publicIPAddresses@2022-07-01"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
ddosSettings = {
protectionMode = "VirtualNetworkInherited"
}
idleTimeoutInMinutes = 4
publicIPAddressVersion = "IPv4"
publicIPAllocationMethod = "Static"
}
sku = {
name = "Standard"
tier = "Regional"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
resource "azapi_resource" "subnet" {
type = "Microsoft.Network/virtualNetworks/subnets@2022-07-01"
parent_id = azapi_resource.virtualNetwork.id
name = "GatewaySubnet"
body = {
properties = {
addressPrefix = "10.6.1.0/24"
delegations = [
]
privateEndpointNetworkPolicies = "Enabled"
privateLinkServiceNetworkPolicies = "Enabled"
serviceEndpointPolicies = [
]
serviceEndpoints = [
]
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}
resource "azapi_resource" "virtualNetworkGateway" {
type = "Microsoft.Network/virtualNetworkGateways@2022-07-01"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
location = var.location
body = {
properties = {
activeActive = false
enableBgp = false
enablePrivateIpAddress = false
gatewayType = "ExpressRoute"
ipConfigurations = [
{
name = "vnetGatewayConfig"
properties = {
privateIPAllocationMethod = "Dynamic"
publicIPAddress = {
id = azapi_resource.publicIPAddress.id
}
subnet = {
id = azapi_resource.subnet.id
}
}
},
]
sku = {
name = "Standard"
tier = "Standard"
}
vpnType = "RouteBased"
}
}
schema_validation_enabled = false
response_export_values = ["*"]
}