你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Microsoft.Network publicIPAddresses 2022-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

Bicep 资源定义

可以使用目标操作部署 publicIPAddresses 资源类型：

• 资源组 - 请参阅 资源组部署命令

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Network/publicIPAddresses 资源，请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.Network/publicIPAddresses@2022-01-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'string'
    tier: 'string'
  }
  extendedLocation: {
    name: 'string'
    type: 'EdgeZone'
  }
  properties: {
    ddosSettings: {
      ddosCustomPolicy: {
        id: 'string'
      }
      protectedIP: bool
      protectionCoverage: 'string'
    }
    deleteOption: 'string'
    dnsSettings: {
      domainNameLabel: 'string'
      fqdn: 'string'
      reverseFqdn: 'string'
    }
    idleTimeoutInMinutes: int
    ipAddress: 'string'
    ipTags: [
      {
        ipTagType: 'string'
        tag: 'string'
      }
    ]
    linkedPublicIPAddress: {
      public-ip-address-object
    }
      extendedLocation: {
        name: 'string'
        type: 'EdgeZone'
      }
      id: 'string'
      location: 'string'
      properties: {
      sku: {
        name: 'string'
        tier: 'string'
      }
      tags: {}
      zones: [
        'string'
      ]
    }
    migrationPhase: 'string'
    natGateway: {
      id: 'string'
      location: 'string'
      properties: {
        idleTimeoutInMinutes: int
        publicIpAddresses: [
          {
            id: 'string'
          }
        ]
        publicIpPrefixes: [
          {
            id: 'string'
          }
        ]
      }
      sku: {
        name: 'Standard'
      }
      tags: {}
      zones: [
        'string'
      ]
    }
    publicIPAddressVersion: 'string'
    publicIPAllocationMethod: 'string'
    publicIPPrefix: {
      id: 'string'
    }
    servicePublicIPAddress: {
      public-ip-address-object
    }
      extendedLocation: {
        name: 'string'
        type: 'EdgeZone'
      }
      id: 'string'
      location: 'string'
      properties: {
      sku: {
        name: 'string'
        tier: 'string'
      }
      tags: {}
      zones: [
        'string'
      ]
    }
  }
  zones: [
    'string'
  ]
}

属性值

publicIPAddresses

名字	描述	价值
名字	资源名称	string （必需） 字符限制：1-80 有效字符： 字母数字、下划线、句点和连字符。 从字母数字开始。 结束字母数字或下划线。
位置	资源位置。	字符串
标签	资源标记。	标记名称和值的字典。 请参阅模板 中的 标记
sku	公共 IP 地址 SKU。	PublicIPAddressSku
extendedLocation	公共 IP 地址的扩展位置。	ExtendedLocation
性能	公共 IP 地址属性。	PublicIPAddressPropertiesFormat
区	表示为资源分配的 IP 需要来自的可用性区域列表。	string[]

ExtendedLocation

名字	描述	价值
名字	扩展位置的名称。	字符串
类型	扩展位置的类型。	“EdgeZone”

PublicIPAddressPropertiesFormat

名字	描述	价值
ddosSettings	与公共 IP 地址关联的 DDoS 保护自定义策略。	DdosSettings
deleteOption	指定删除 VM 时公共 IP 地址会发生什么情况	“Delete” “Detach”
dnsSettings	与公共 IP 地址关联的 DNS 记录的 FQDN。	PublicIPAddressDnsSettings
idleTimeoutInMinutes	公共 IP 地址的空闲超时。	int
ipAddress	与公共 IP 地址资源关联的 IP 地址。	字符串
ipTags	与公共 IP 地址关联的标记列表。	IpTag[]
linkedPublicIPAddress	公共 IP 地址资源的链接公共 IP 地址。	PublicIPAddress
migrationPhase	公共 IP 地址的迁移阶段。	“中止” “Commit” “已提交” “None” “准备”
natGateway	公共 IP 地址的 NatGateway。	NatGateway
publicIPAddressVersion	公共 IP 地址版本。	“IPv4” “IPv6”
publicIPAllocationMethod	公共 IP 地址分配方法。	“Dynamic” “Static”
publicIPPrefix	应从中分配此公共 IP 地址的公共 IP 前缀。	SubResource
servicePublicIPAddress	公共 IP 地址资源的服务公共 IP 地址。	PublicIPAddress

DdosSettings

名字	描述	价值
ddosCustomPolicy	与公共 IP 关联的 DDoS 自定义策略。	SubResource
protectedIP	在公共 IP 上启用 DDoS 保护。	bool
protectionCoverage	公共 IP 的 DDoS 保护策略可自定义性。 只有标准覆盖范围才能进行自定义。	“Basic” “Standard”

SubResource

名字	描述	价值
id	资源 ID。	字符串

PublicIPAddressDnsSettings

名字	描述	价值
domainNameLabel	域名标签。 域名标签和区域化 DNS 区域的串联构成了与公共 IP 地址关联的完全限定域名。 如果指定了域名标签，则会为 Microsoft Azure DNS 系统中的公共 IP 创建 A DNS 记录。	字符串
fqdn	与公共 IP 关联的 A DNS 记录的完全限定域名。 这是 domainNameLabel 和区域化 DNS 区域的串联。	字符串
reverseFqdn	反向 FQDN。 解析为此公共 IP 地址的用户可见完全限定域名。 如果指定了 reverseFqdn，则会创建 PTR DNS 记录，该记录从 in-addr.arpa 域中的 IP 地址指向反向 FQDN。	字符串

IpTag

名字	描述	价值
ipTagType	IP 标记类型。 示例：FirstPartyUsage。	字符串
标记	与公共 IP 关联的 IP 标记的值。 示例：SQL。	字符串

PublicIPAddress

名字	描述	价值
extendedLocation	公共 IP 地址的扩展位置。	ExtendedLocation
id	资源 ID。	字符串
位置	资源位置。	字符串
性能	公共 IP 地址属性。	PublicIPAddressPropertiesFormat
sku	公共 IP 地址 SKU。	PublicIPAddressSku
标签	资源标记。	对象
区	表示为资源分配的 IP 需要来自的可用性区域列表。	string[]

PublicIPAddressSku

名字	描述	价值
名字	公共 IP 地址 SKU 的名称。	“Basic” “Standard”
层	公共 IP 地址 SKU 的层。	“Global” “区域”

NatGateway

名字	描述	价值
id	资源 ID。	字符串
位置	资源位置。	字符串
性能	Nat 网关属性。	NatGatewayPropertiesFormat
sku	nat 网关 SKU。	NatGatewaySku
标签	资源标记。	对象
区	表示应在其中部署 Nat 网关的区域的可用性区域的列表。	string[]

NatGatewayPropertiesFormat

名字	描述	价值
idleTimeoutInMinutes	nat 网关的空闲超时。	int
publicIpAddresses	与 nat 网关资源关联的公共 IP 地址数组。	SubResource[]
publicIpPrefixes	与 nat 网关资源关联的公共 IP 前缀数组。	SubResource[]

NatGatewaySku

名字	描述	价值
名字	Nat 网关 SKU 的名称。	“Standard”

快速入门模板

以下快速入门模板部署此资源类型。

模板	描述
使用应用程序网关入口控制器 AKS 群集	此示例演示如何使用应用程序网关、应用程序网关入口控制器、Azure 容器注册表、Log Analytics 和 Key Vault 部署 AKS 群集
使用 WAF、SSL、IIS 和 HTTPS 重定向 应用网关	此模板使用 WAF 部署应用程序网关、端到端 SSL 和 HTTP 到 IIS 服务器上的 HTTPS 重定向。
创建 IPv6 应用程序网关	此模板在双堆栈虚拟网络中创建具有 IPv6 前端的应用程序网关。
使用 Key Vault 创建应用程序网关 V2	此模板在虚拟网络、用户定义的标识、Key Vault、机密（证书数据）和 Key Vault 和应用程序网关上的访问策略中部署应用程序网关 V2。
用于多托管 应用程序网关	此模板创建应用程序网关并将其配置为端口 443 上的多托管。
使用路径替代创建应用程序网关	此模板部署应用程序网关，并显示后端地址池的路径替代功能的用法。
使用探测 创建应用程序网关	此模板部署具有增强探测功能的应用程序网关。
创建具有公共 IP 的应用程序网关	此模板创建应用程序网关、应用程序网关的公共 IP 地址，以及在其中部署应用程序网关的虚拟网络。 还配置应用程序网关，以便通过两个后端服务器进行 Http 负载均衡。 请注意，必须指定后端服务器的有效 IP。
创建具有公共 IP 的应用程序网关（卸载）	此模板创建应用程序网关、应用程序网关的公共 IP 地址，以及在其中部署应用程序网关的虚拟网络。 还配置应用程序网关，以便使用两个后端服务器进行 Ssl 卸载和负载均衡。 请注意，必须指定后端服务器的有效 IP。
使用重定向 创建应用程序网关	此模板在虚拟网络中创建具有重定向功能的应用程序网关，并设置负载均衡和重定向规则（基本和基于路径）
使用重写 创建应用程序网关	此模板在虚拟网络中创建具有重写功能的应用程序网关，并设置负载均衡、重写规则
创建应用程序网关（自定义 SSL）	此模板部署使用自定义 ssl 策略配置的应用程序网关。
创建应用程序网关（SSL 策略）	此模板部署使用预定义 ssl 策略配置的应用程序网关。
基于 URL 路径的路由 的应用程序网关	此模板创建应用程序网关并将其配置为基于 URL 路径的路由。
创建应用程序网关 v2	此模板在虚拟网络中创建应用程序网关 v2，并使用公共前端设置自动缩放属性和 HTTP 负载均衡规则
创建应用程序网关（WAF）	此模板在虚拟网络中创建具有 Web 应用程序防火墙功能的应用程序网关，并为任意数量的虚拟机设置负载均衡规则
使用 WAF 和防火墙策略 应用程序网关	此模板创建配置了 WAF 的应用程序网关以及防火墙策略
为具有 IP 限制的 Web 应用 应用程序网关	此模板在 Azure Web 应用前创建应用程序网关，并在 Web 应用上启用了 IP 限制。
为 WebApps 创建应用程序网关	此模板在启用了自定义探测的两个 Azure Web 应用前面创建应用程序网关。
应用程序安全组	此模板演示如何组合使用 NSG 和应用程序安全组来保护工作负荷。 它将部署运行 NGINX 的 Linux VM，并通过在网络安全组中使用应用程序安全组，允许访问分配给名为 webServersAsg 的应用程序安全组的 VM 的端口 22 和 80。
Azure Bastion 即服务	此模板在虚拟网络中预配 Azure Bastion
使用 NSG Azure Bastion 即服务	此模板在虚拟网络中预配 Azure Bastion
使用 Azure 防火墙作为中心 & 辐射型拓扑中的 DNS 代理	此示例演示如何使用 Azure 防火墙在 Azure 中部署中心辐射型拓扑。 中心虚拟网络充当通过虚拟网络对等互连连接到中心虚拟网络的许多辐射虚拟网络的中心点。
创建 Azure 防火墙、客户端 VM 和服务器 VM 的沙盒	此模板创建一个虚拟网络，其中包含 2 个子网（服务器子网和 AzureFirewall 子网）、服务器 VM、客户端 VM、每个 VM 的公共 IP 地址，以及一个路由表，用于通过防火墙在 VM 之间发送流量。
使用规则和 Ipgroups 创建防火墙和 FirewallPolicy	此模板部署包含防火墙策略（包括多个应用程序和网络规则）的 Azure 防火墙，该防火墙引用了应用程序和网络规则中的 IP 组。
使用显式代理创建防火墙、FirewallPolicy	此模板使用 IpGroups 的显式代理和网络规则创建 Azure 防火墙、FirewalllPolicy。 此外，还包括 Linux Jumpbox vm 设置
使用 FirewallPolicy 和 IpGroups 创建防火墙	此模板创建一个包含 FirewalllPolicy 的 Azure 防火墙，该防火墙引用了 IpGroups 的网络规则。 此外，还包括 Linux Jumpbox vm 设置
使用 IpGroups 创建 Azure 防火墙	此模板创建一个 Azure 防火墙，其中包含引用 IP 组的应用程序和网络规则。 此外，还包括 Linux Jumpbox vm 设置
创建包含可用性区域的 Azure 防火墙	此模板创建一个 Azure 防火墙，其中包含可用性区域和虚拟网络中任意数量的公共 IP，并设置 1 个示例应用程序规则和 1 个示例网络规则
创建具有强制隧道 的 Azure 防火墙沙盒	此模板创建一个 Azure 防火墙沙盒（Linux），其中一个防火墙强制通过对等互连 VNET 中的另一个防火墙进行隧道传输
Azure 防火墙高级版 的 测试环境	此模板创建具有高级功能（例如入侵检查检测（IDPS）、TLS 检查和 Web 类别筛选等高级功能的 Azure 防火墙高级和防火墙策略
使用 Linux VM 创建 Azure 防火墙的沙盒设置	此模板创建包含 3 个子网的虚拟网络（服务器子网、jumpbox 子集和 AzureFirewall 子网）、具有公共 IP 的 jumpbox VM、服务器 VM、UDR 路由以指向服务器子网的 Azure 防火墙和具有 1 个或多个公共 IP 地址的 Azure 防火墙、1 个示例应用程序规则、1 个示例网络规则和默认专用范围
使用防火墙策略 创建沙盒设置	此模板创建包含 3 个子网（服务器子网、jumpbox 子集和 AzureFirewall 子网）的虚拟网络、具有公共 IP 的 jumpbox VM、服务器 VM、UDR 路由，以指向服务器子网的 Azure 防火墙以及具有 1 个或多个公共 IP 地址的 Azure 防火墙。 此外，还创建包含 1 个示例应用程序规则、1 个示例网络规则和默认专用范围的防火墙策略
使用区域 创建 Azure 防火墙的沙盒设置	此模板创建包含三个子网（服务器子网、jumpbox 子网和 Azure 防火墙子网）的虚拟网络、具有公共 IP 的 jumpbox VM、A 服务器 VM、UDR 路由以指向 ServerSubnet 的 Azure 防火墙、一个具有一个或多个公共 IP 地址的 Azure 防火墙、一个示例应用程序规则，以及可用性区域 1 中的一个示例网络规则和 Azure 防火墙， 2 和 3。
在中心虚拟网络 部署 Bastion 主机	此模板创建两个具有对等互连的 vNet：中心 vNet 中的 Bastion 主机和辐射 vNet 中的 Linux VM
将 ExpressRoute 线路连接到 VNET	此模板创建 VNET、ExpresRoute 网关和与配置了 AzurePrivatePeering 的预配和已启用的 ExpressRoute 线路的连接。
使用专用对等互连和 Azure VNet ExpressRoute 线路	此模板配置 ExpressRoute Microsoft对等互连，部署包含 Expressroute 网关的 Azure VNet，并将 VNet 链接到 ExpressRoute 线路
将现有 Azure VNET 扩展到多 VNET 配置	使用此模板，可以将现有单一 VNET 环境扩展到使用 VNET 到 VNET 网关跨两个数据中心区域扩展的多 VNET 环境
在扩展区域中创建虚拟机	此模板在扩展区域中创建虚拟机
创建具有多个 IP 公共地址的 Azure 防火墙	此模板创建一个 Azure 防火墙，其中包含两个公共 IP 地址和两台要测试的 Windows Server 2019 服务器。
安全虚拟中心	此模板使用 Azure 防火墙创建安全的虚拟中心，以保护发往 Internet 的云网络流量。
创建标准内部负载均衡器	此模板使用规则负载均衡端口 80 创建标准内部 Azure 负载均衡器
创建跨区域负载均衡器	此模板创建包含两个区域负载均衡器的后端池的跨区域负载均衡器。 跨区域负载均衡器目前在有限的区域中可用。 跨区域负载均衡器后面的区域负载均衡器可以位于任何区域中。
按 IP 地址按 IP 地址 标准负载均衡器	此模板用于演示如何使用 ARM 模板按 IP 地址配置负载均衡器的后端池，如 后端池管理 文档中所述。
创建具有公共 IPv6 地址的负载均衡器	此模板为后端池创建一个面向 Internet 的负载均衡器，其中包含公共 IPv6 地址、负载均衡规则和两个 VM。
创建标准负载均衡器	此模板为后端池创建面向 Internet 的负载均衡器、负载均衡规则和三个 VM，并在冗余区域中为每个 VM 创建一个 VM。
具有 2 个 VIP 的负载均衡器，每个负载均衡器都有一个 LB 规则	此模板允许你为负载均衡器（multivip）、虚拟网络、虚拟网络中的网络接口创建负载均衡器、2 个公共 IP 地址，& 网络接口使用的负载均衡器中的 LB 规则。
使用入站 NAT 规则 负载均衡器	此模板允许你为负载均衡器、虚拟网络、虚拟网络中的网络接口创建负载均衡器、公共 IP 地址，& 网络接口使用的负载均衡器中的 NAT 规则。
使用 VM 虚拟网络 NAT	部署 NAT 网关和虚拟机
虚拟网络 NAT	部署 NAT 网关和虚拟网络
具有公共 IP 地址的网络接口	此模板允许在引用公共 IP 地址的虚拟网络中创建网络信息面。
使用 DDoS IP 保护创建公共 IP	此模板创建使用 DDoS IP 保护保护的公共 IP
创建点到站点网关	使用此模板，可以使用 VirtualNetworkGateways 创建点到站点连接
使用 Azure AD 创建点到站点网关	此模板部署配置了 Azure Active Directory 点到站点连接的 VPN 虚拟网络网关
专用链接服务示例	此模板演示如何创建专用链接服务
保留 IP 用例片段	此模板演示当前支持的保留 IP 用例。 保留 IP 只是静态分配的公共 IP。
在新子网中创建路由服务器	此模板将路由服务器部署到名为 RouteServerSubnet 的子网中。
使用 Quagga 在 BGP 对等互连中 Azure 路由服务器	此模板使用 Quagga 部署路由器服务器和 Ubuntu VM。 路由器服务器和 Quagga 之间建立了两个外部 BGP 会话。 Quagga 的安装和配置由适用于 linux 的 Azure 自定义脚本扩展执行
使用 VM 创建站点到站点 VPN 连接	使用此模板，可以使用虚拟网络网关创建站点到站点 VPN 连接
创建站点到站点 VPN 连接	使用此模板，可以使用虚拟网络网关创建站点到站点 VPN 连接
使用具有 BGP 的主动-主动 VPN 网关 站点到站点 VPN	通过此模板，可以使用 BGP 在配置主动-主动的两个 VNet 之间部署站点到站点 VPN VPN。 每个 Azure VPN 网关解析远程对等方的 FQDN，以确定远程 VPN 网关的公共 IP。 模板在具有可用性区域的 Azure 区域中按预期运行。
Azure 流量管理器 VM 示例	此模板演示如何跨多个虚拟机创建 Azure 流量管理器配置文件负载均衡。
使用可用性区域 Azure 流量管理器 VM 示例	此模板演示如何跨位于可用性区域中的多个虚拟机创建 Azure 流量管理器配置文件负载均衡。
用户定义的路由和设备	此模板部署虚拟网络、相应子网中的 VM 和路由，以将流量定向到设备
201-vnet-2subnets-service-endpoints-storage-integration	在同一 VNet 中的两个不同的子网中，分别创建 2 个具有 NIC 的新 VM。 在某个子网上设置服务终结点，并将存储帐户安全到该子网。
跨两个区域创建 VNET 到 VNET 连接	使用此模板，可以使用虚拟网络网关连接不同区域中的两个 VNET
创建 BGP VNET 到 VNET 连接	使用此模板，可以使用虚拟网络网关和 BGP 连接两个 VNET
创建三个 vNet 来演示 传递的 BGP 连接	此模板部署使用虚拟网络网关和已启用 BGP 的连接连接的三个 vNet

ARM 模板资源定义

可以使用目标操作部署 publicIPAddresses 资源类型：

• 资源组 - 请参阅 资源组部署命令

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Network/publicIPAddresses 资源，请将以下 JSON 添加到模板。

{
  "type": "Microsoft.Network/publicIPAddresses",
  "apiVersion": "2022-01-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "string",
    "tier": "string"
  },
  "extendedLocation": {
    "name": "string",
    "type": "EdgeZone"
  },
  "properties": {
    "ddosSettings": {
      "ddosCustomPolicy": {
        "id": "string"
      },
      "protectedIP": "bool",
      "protectionCoverage": "string"
    },
    "deleteOption": "string",
    "dnsSettings": {
      "domainNameLabel": "string",
      "fqdn": "string",
      "reverseFqdn": "string"
    },
    "idleTimeoutInMinutes": "int",
    "ipAddress": "string",
    "ipTags": [
      {
        "ipTagType": "string",
        "tag": "string"
      }
    ],
    "linkedPublicIPAddress": { public-ip-address-object },
      "extendedLocation": {
        "name": "string",
        "type": "EdgeZone"
      },
      "id": "string",
      "location": "string",
      "properties": {
      "sku": {
        "name": "string",
        "tier": "string"
      },
      "tags": {},
      "zones": [ "string" ]
    },
    "migrationPhase": "string",
    "natGateway": {
      "id": "string",
      "location": "string",
      "properties": {
        "idleTimeoutInMinutes": "int",
        "publicIpAddresses": [
          {
            "id": "string"
          }
        ],
        "publicIpPrefixes": [
          {
            "id": "string"
          }
        ]
      },
      "sku": {
        "name": "Standard"
      },
      "tags": {},
      "zones": [ "string" ]
    },
    "publicIPAddressVersion": "string",
    "publicIPAllocationMethod": "string",
    "publicIPPrefix": {
      "id": "string"
    },
    "servicePublicIPAddress": { public-ip-address-object },
      "extendedLocation": {
        "name": "string",
        "type": "EdgeZone"
      },
      "id": "string",
      "location": "string",
      "properties": {
      "sku": {
        "name": "string",
        "tier": "string"
      },
      "tags": {},
      "zones": [ "string" ]
    }
  },
  "zones": [ "string" ]
}

属性值

publicIPAddresses

名字	描述	价值
类型	资源类型	“Microsoft.Network/publicIPAddresses”
apiVersion	资源 API 版本	'2022-01-01'
名字	资源名称	string （必需） 字符限制：1-80 有效字符： 字母数字、下划线、句点和连字符。 从字母数字开始。 结束字母数字或下划线。
位置	资源位置。	字符串
标签	资源标记。	标记名称和值的字典。 请参阅模板 中的 标记
sku	公共 IP 地址 SKU。	PublicIPAddressSku
extendedLocation	公共 IP 地址的扩展位置。	ExtendedLocation
性能	公共 IP 地址属性。	PublicIPAddressPropertiesFormat
区	表示为资源分配的 IP 需要来自的可用性区域列表。	string[]

ExtendedLocation

名字	描述	价值
名字	扩展位置的名称。	字符串
类型	扩展位置的类型。	“EdgeZone”

PublicIPAddressPropertiesFormat

名字	描述	价值
ddosSettings	与公共 IP 地址关联的 DDoS 保护自定义策略。	DdosSettings
deleteOption	指定删除 VM 时公共 IP 地址会发生什么情况	“Delete” “Detach”
dnsSettings	与公共 IP 地址关联的 DNS 记录的 FQDN。	PublicIPAddressDnsSettings
idleTimeoutInMinutes	公共 IP 地址的空闲超时。	int
ipAddress	与公共 IP 地址资源关联的 IP 地址。	字符串
ipTags	与公共 IP 地址关联的标记列表。	IpTag[]
linkedPublicIPAddress	公共 IP 地址资源的链接公共 IP 地址。	PublicIPAddress
migrationPhase	公共 IP 地址的迁移阶段。	“中止” “Commit” “已提交” “None” “准备”
natGateway	公共 IP 地址的 NatGateway。	NatGateway
publicIPAddressVersion	公共 IP 地址版本。	“IPv4” “IPv6”
publicIPAllocationMethod	公共 IP 地址分配方法。	“Dynamic” “Static”
publicIPPrefix	应从中分配此公共 IP 地址的公共 IP 前缀。	SubResource
servicePublicIPAddress	公共 IP 地址资源的服务公共 IP 地址。	PublicIPAddress

DdosSettings

名字	描述	价值
ddosCustomPolicy	与公共 IP 关联的 DDoS 自定义策略。	SubResource
protectedIP	在公共 IP 上启用 DDoS 保护。	bool
protectionCoverage	公共 IP 的 DDoS 保护策略可自定义性。 只有标准覆盖范围才能进行自定义。	“Basic” “Standard”

SubResource

名字	描述	价值
id	资源 ID。	字符串

PublicIPAddressDnsSettings

名字	描述	价值
domainNameLabel	域名标签。 域名标签和区域化 DNS 区域的串联构成了与公共 IP 地址关联的完全限定域名。 如果指定了域名标签，则会为 Microsoft Azure DNS 系统中的公共 IP 创建 A DNS 记录。	字符串
fqdn	与公共 IP 关联的 A DNS 记录的完全限定域名。 这是 domainNameLabel 和区域化 DNS 区域的串联。	字符串
reverseFqdn	反向 FQDN。 解析为此公共 IP 地址的用户可见完全限定域名。 如果指定了 reverseFqdn，则会创建 PTR DNS 记录，该记录从 in-addr.arpa 域中的 IP 地址指向反向 FQDN。	字符串

IpTag

名字	描述	价值
ipTagType	IP 标记类型。 示例：FirstPartyUsage。	字符串
标记	与公共 IP 关联的 IP 标记的值。 示例：SQL。	字符串

PublicIPAddress

名字	描述	价值
extendedLocation	公共 IP 地址的扩展位置。	ExtendedLocation
id	资源 ID。	字符串
位置	资源位置。	字符串
性能	公共 IP 地址属性。	PublicIPAddressPropertiesFormat
sku	公共 IP 地址 SKU。	PublicIPAddressSku
标签	资源标记。	对象
区	表示为资源分配的 IP 需要来自的可用性区域列表。	string[]

PublicIPAddressSku

名字	描述	价值
名字	公共 IP 地址 SKU 的名称。	“Basic” “Standard”
层	公共 IP 地址 SKU 的层。	“Global” “区域”

NatGateway

名字	描述	价值
id	资源 ID。	字符串
位置	资源位置。	字符串
性能	Nat 网关属性。	NatGatewayPropertiesFormat
sku	nat 网关 SKU。	NatGatewaySku
标签	资源标记。	对象
区	表示应在其中部署 Nat 网关的区域的可用性区域的列表。	string[]

NatGatewayPropertiesFormat

名字	描述	价值
idleTimeoutInMinutes	nat 网关的空闲超时。	int
publicIpAddresses	与 nat 网关资源关联的公共 IP 地址数组。	SubResource[]
publicIpPrefixes	与 nat 网关资源关联的公共 IP 前缀数组。	SubResource[]

NatGatewaySku

名字	描述	价值
名字	Nat 网关 SKU 的名称。	“Standard”

快速入门模板

以下快速入门模板部署此资源类型。

模板	描述
使用应用程序网关入口控制器 AKS 群集	此示例演示如何使用应用程序网关、应用程序网关入口控制器、Azure 容器注册表、Log Analytics 和 Key Vault 部署 AKS 群集
使用 WAF、SSL、IIS 和 HTTPS 重定向 应用网关	此模板使用 WAF 部署应用程序网关、端到端 SSL 和 HTTP 到 IIS 服务器上的 HTTPS 重定向。
创建 IPv6 应用程序网关	此模板在双堆栈虚拟网络中创建具有 IPv6 前端的应用程序网关。
使用 Key Vault 创建应用程序网关 V2	此模板在虚拟网络、用户定义的标识、Key Vault、机密（证书数据）和 Key Vault 和应用程序网关上的访问策略中部署应用程序网关 V2。
用于多托管 应用程序网关	此模板创建应用程序网关并将其配置为端口 443 上的多托管。
使用路径替代创建应用程序网关	此模板部署应用程序网关，并显示后端地址池的路径替代功能的用法。
使用探测 创建应用程序网关	此模板部署具有增强探测功能的应用程序网关。
创建具有公共 IP 的应用程序网关	此模板创建应用程序网关、应用程序网关的公共 IP 地址，以及在其中部署应用程序网关的虚拟网络。 还配置应用程序网关，以便通过两个后端服务器进行 Http 负载均衡。 请注意，必须指定后端服务器的有效 IP。
创建具有公共 IP 的应用程序网关（卸载）	此模板创建应用程序网关、应用程序网关的公共 IP 地址，以及在其中部署应用程序网关的虚拟网络。 还配置应用程序网关，以便使用两个后端服务器进行 Ssl 卸载和负载均衡。 请注意，必须指定后端服务器的有效 IP。
使用重定向 创建应用程序网关	此模板在虚拟网络中创建具有重定向功能的应用程序网关，并设置负载均衡和重定向规则（基本和基于路径）
使用重写 创建应用程序网关	此模板在虚拟网络中创建具有重写功能的应用程序网关，并设置负载均衡、重写规则
创建应用程序网关（自定义 SSL）	此模板部署使用自定义 ssl 策略配置的应用程序网关。
创建应用程序网关（SSL 策略）	此模板部署使用预定义 ssl 策略配置的应用程序网关。
基于 URL 路径的路由 的应用程序网关	此模板创建应用程序网关并将其配置为基于 URL 路径的路由。
创建应用程序网关 v2	此模板在虚拟网络中创建应用程序网关 v2，并使用公共前端设置自动缩放属性和 HTTP 负载均衡规则
创建应用程序网关（WAF）	此模板在虚拟网络中创建具有 Web 应用程序防火墙功能的应用程序网关，并为任意数量的虚拟机设置负载均衡规则
使用 WAF 和防火墙策略 应用程序网关	此模板创建配置了 WAF 的应用程序网关以及防火墙策略
为具有 IP 限制的 Web 应用 应用程序网关	此模板在 Azure Web 应用前创建应用程序网关，并在 Web 应用上启用了 IP 限制。
为 WebApps 创建应用程序网关	此模板在启用了自定义探测的两个 Azure Web 应用前面创建应用程序网关。
应用程序安全组	此模板演示如何组合使用 NSG 和应用程序安全组来保护工作负荷。 它将部署运行 NGINX 的 Linux VM，并通过在网络安全组中使用应用程序安全组，允许访问分配给名为 webServersAsg 的应用程序安全组的 VM 的端口 22 和 80。
Azure Bastion 即服务	此模板在虚拟网络中预配 Azure Bastion
使用 NSG Azure Bastion 即服务	此模板在虚拟网络中预配 Azure Bastion
使用 Azure 防火墙作为中心 & 辐射型拓扑中的 DNS 代理	此示例演示如何使用 Azure 防火墙在 Azure 中部署中心辐射型拓扑。 中心虚拟网络充当通过虚拟网络对等互连连接到中心虚拟网络的许多辐射虚拟网络的中心点。
创建 Azure 防火墙、客户端 VM 和服务器 VM 的沙盒	此模板创建一个虚拟网络，其中包含 2 个子网（服务器子网和 AzureFirewall 子网）、服务器 VM、客户端 VM、每个 VM 的公共 IP 地址，以及一个路由表，用于通过防火墙在 VM 之间发送流量。
使用规则和 Ipgroups 创建防火墙和 FirewallPolicy	此模板部署包含防火墙策略（包括多个应用程序和网络规则）的 Azure 防火墙，该防火墙引用了应用程序和网络规则中的 IP 组。
使用显式代理创建防火墙、FirewallPolicy	此模板使用 IpGroups 的显式代理和网络规则创建 Azure 防火墙、FirewalllPolicy。 此外，还包括 Linux Jumpbox vm 设置
使用 FirewallPolicy 和 IpGroups 创建防火墙	此模板创建一个包含 FirewalllPolicy 的 Azure 防火墙，该防火墙引用了 IpGroups 的网络规则。 此外，还包括 Linux Jumpbox vm 设置
使用 IpGroups 创建 Azure 防火墙	此模板创建一个 Azure 防火墙，其中包含引用 IP 组的应用程序和网络规则。 此外，还包括 Linux Jumpbox vm 设置
创建包含可用性区域的 Azure 防火墙	此模板创建一个 Azure 防火墙，其中包含可用性区域和虚拟网络中任意数量的公共 IP，并设置 1 个示例应用程序规则和 1 个示例网络规则
创建具有强制隧道 的 Azure 防火墙沙盒	此模板创建一个 Azure 防火墙沙盒（Linux），其中一个防火墙强制通过对等互连 VNET 中的另一个防火墙进行隧道传输
Azure 防火墙高级版 的 测试环境	此模板创建具有高级功能（例如入侵检查检测（IDPS）、TLS 检查和 Web 类别筛选等高级功能的 Azure 防火墙高级和防火墙策略
使用 Linux VM 创建 Azure 防火墙的沙盒设置	此模板创建包含 3 个子网的虚拟网络（服务器子网、jumpbox 子集和 AzureFirewall 子网）、具有公共 IP 的 jumpbox VM、服务器 VM、UDR 路由以指向服务器子网的 Azure 防火墙和具有 1 个或多个公共 IP 地址的 Azure 防火墙、1 个示例应用程序规则、1 个示例网络规则和默认专用范围
使用防火墙策略 创建沙盒设置	此模板创建包含 3 个子网（服务器子网、jumpbox 子集和 AzureFirewall 子网）的虚拟网络、具有公共 IP 的 jumpbox VM、服务器 VM、UDR 路由，以指向服务器子网的 Azure 防火墙以及具有 1 个或多个公共 IP 地址的 Azure 防火墙。 此外，还创建包含 1 个示例应用程序规则、1 个示例网络规则和默认专用范围的防火墙策略
使用区域 创建 Azure 防火墙的沙盒设置	此模板创建包含三个子网（服务器子网、jumpbox 子网和 Azure 防火墙子网）的虚拟网络、具有公共 IP 的 jumpbox VM、A 服务器 VM、UDR 路由以指向 ServerSubnet 的 Azure 防火墙、一个具有一个或多个公共 IP 地址的 Azure 防火墙、一个示例应用程序规则，以及可用性区域 1 中的一个示例网络规则和 Azure 防火墙， 2 和 3。
在中心虚拟网络 部署 Bastion 主机	此模板创建两个具有对等互连的 vNet：中心 vNet 中的 Bastion 主机和辐射 vNet 中的 Linux VM
将 ExpressRoute 线路连接到 VNET	此模板创建 VNET、ExpresRoute 网关和与配置了 AzurePrivatePeering 的预配和已启用的 ExpressRoute 线路的连接。
使用专用对等互连和 Azure VNet ExpressRoute 线路	此模板配置 ExpressRoute Microsoft对等互连，部署包含 Expressroute 网关的 Azure VNet，并将 VNet 链接到 ExpressRoute 线路
将现有 Azure VNET 扩展到多 VNET 配置	使用此模板，可以将现有单一 VNET 环境扩展到使用 VNET 到 VNET 网关跨两个数据中心区域扩展的多 VNET 环境
在扩展区域中创建虚拟机	此模板在扩展区域中创建虚拟机
创建具有多个 IP 公共地址的 Azure 防火墙	此模板创建一个 Azure 防火墙，其中包含两个公共 IP 地址和两台要测试的 Windows Server 2019 服务器。
安全虚拟中心	此模板使用 Azure 防火墙创建安全的虚拟中心，以保护发往 Internet 的云网络流量。
创建标准内部负载均衡器	此模板使用规则负载均衡端口 80 创建标准内部 Azure 负载均衡器
创建跨区域负载均衡器	此模板创建包含两个区域负载均衡器的后端池的跨区域负载均衡器。 跨区域负载均衡器目前在有限的区域中可用。 跨区域负载均衡器后面的区域负载均衡器可以位于任何区域中。
按 IP 地址按 IP 地址 标准负载均衡器	此模板用于演示如何使用 ARM 模板按 IP 地址配置负载均衡器的后端池，如 后端池管理 文档中所述。
创建具有公共 IPv6 地址的负载均衡器	此模板为后端池创建一个面向 Internet 的负载均衡器，其中包含公共 IPv6 地址、负载均衡规则和两个 VM。
创建标准负载均衡器	此模板为后端池创建面向 Internet 的负载均衡器、负载均衡规则和三个 VM，并在冗余区域中为每个 VM 创建一个 VM。
具有 2 个 VIP 的负载均衡器，每个负载均衡器都有一个 LB 规则	此模板允许你为负载均衡器（multivip）、虚拟网络、虚拟网络中的网络接口创建负载均衡器、2 个公共 IP 地址，& 网络接口使用的负载均衡器中的 LB 规则。
使用入站 NAT 规则 负载均衡器	此模板允许你为负载均衡器、虚拟网络、虚拟网络中的网络接口创建负载均衡器、公共 IP 地址，& 网络接口使用的负载均衡器中的 NAT 规则。
使用 VM 虚拟网络 NAT	部署 NAT 网关和虚拟机
虚拟网络 NAT	部署 NAT 网关和虚拟网络
具有公共 IP 地址的网络接口	此模板允许在引用公共 IP 地址的虚拟网络中创建网络信息面。
使用 DDoS IP 保护创建公共 IP	此模板创建使用 DDoS IP 保护保护的公共 IP
创建点到站点网关	使用此模板，可以使用 VirtualNetworkGateways 创建点到站点连接
使用 Azure AD 创建点到站点网关	此模板部署配置了 Azure Active Directory 点到站点连接的 VPN 虚拟网络网关
专用链接服务示例	此模板演示如何创建专用链接服务
保留 IP 用例片段	此模板演示当前支持的保留 IP 用例。 保留 IP 只是静态分配的公共 IP。
在新子网中创建路由服务器	此模板将路由服务器部署到名为 RouteServerSubnet 的子网中。
使用 Quagga 在 BGP 对等互连中 Azure 路由服务器	此模板使用 Quagga 部署路由器服务器和 Ubuntu VM。 路由器服务器和 Quagga 之间建立了两个外部 BGP 会话。 Quagga 的安装和配置由适用于 linux 的 Azure 自定义脚本扩展执行
使用 VM 创建站点到站点 VPN 连接	使用此模板，可以使用虚拟网络网关创建站点到站点 VPN 连接
创建站点到站点 VPN 连接	使用此模板，可以使用虚拟网络网关创建站点到站点 VPN 连接
使用具有 BGP 的主动-主动 VPN 网关 站点到站点 VPN	通过此模板，可以使用 BGP 在配置主动-主动的两个 VNet 之间部署站点到站点 VPN VPN。 每个 Azure VPN 网关解析远程对等方的 FQDN，以确定远程 VPN 网关的公共 IP。 模板在具有可用性区域的 Azure 区域中按预期运行。
Azure 流量管理器 VM 示例	此模板演示如何跨多个虚拟机创建 Azure 流量管理器配置文件负载均衡。
使用可用性区域 Azure 流量管理器 VM 示例	此模板演示如何跨位于可用性区域中的多个虚拟机创建 Azure 流量管理器配置文件负载均衡。
用户定义的路由和设备	此模板部署虚拟网络、相应子网中的 VM 和路由，以将流量定向到设备
201-vnet-2subnets-service-endpoints-storage-integration	在同一 VNet 中的两个不同的子网中，分别创建 2 个具有 NIC 的新 VM。 在某个子网上设置服务终结点，并将存储帐户安全到该子网。
跨两个区域创建 VNET 到 VNET 连接	使用此模板，可以使用虚拟网络网关连接不同区域中的两个 VNET
创建 BGP VNET 到 VNET 连接	使用此模板，可以使用虚拟网络网关和 BGP 连接两个 VNET
创建三个 vNet 来演示 传递的 BGP 连接	此模板部署使用虚拟网络网关和已启用 BGP 的连接连接的三个 vNet

Terraform （AzAPI 提供程序）资源定义

可以使用目标操作部署 publicIPAddresses 资源类型：

• 资源组

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Network/publicIPAddresses 资源，请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/publicIPAddresses@2022-01-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      ddosSettings = {
        ddosCustomPolicy = {
          id = "string"
        }
        protectedIP = bool
        protectionCoverage = "string"
      }
      deleteOption = "string"
      dnsSettings = {
        domainNameLabel = "string"
        fqdn = "string"
        reverseFqdn = "string"
      }
      idleTimeoutInMinutes = int
      ipAddress = "string"
      ipTags = [
        {
          ipTagType = "string"
          tag = "string"
        }
      ]
      linkedPublicIPAddress = {
        public-ip-address-object
      }
        extendedLocation = {
          name = "string"
          type = "EdgeZone"
        }
        id = "string"
        location = "string"
        properties = {
        sku = {
          name = "string"
          tier = "string"
        }
        tags = {}
        zones = [
          "string"
        ]
      }
      migrationPhase = "string"
      natGateway = {
        id = "string"
        location = "string"
        properties = {
          idleTimeoutInMinutes = int
          publicIpAddresses = [
            {
              id = "string"
            }
          ]
          publicIpPrefixes = [
            {
              id = "string"
            }
          ]
        }
        sku = {
          name = "Standard"
        }
        tags = {}
        zones = [
          "string"
        ]
      }
      publicIPAddressVersion = "string"
      publicIPAllocationMethod = "string"
      publicIPPrefix = {
        id = "string"
      }
      servicePublicIPAddress = {
        public-ip-address-object
      }
        extendedLocation = {
          name = "string"
          type = "EdgeZone"
        }
        id = "string"
        location = "string"
        properties = {
        sku = {
          name = "string"
          tier = "string"
        }
        tags = {}
        zones = [
          "string"
        ]
      }
    }
    zones = [
      "string"
    ]
    sku = {
      name = "string"
      tier = "string"
    }
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

属性值

publicIPAddresses

名字	描述	价值
类型	资源类型	“Microsoft.Network/publicIPAddresses@2022-01-01”
名字	资源名称	string （必需） 字符限制：1-80 有效字符： 字母数字、下划线、句点和连字符。 从字母数字开始。 结束字母数字或下划线。
位置	资源位置。	字符串
parent_id	若要部署到资源组，请使用该资源组的 ID。	string （必需）
标签	资源标记。	标记名称和值的字典。
sku	公共 IP 地址 SKU。	PublicIPAddressSku
extendedLocation	公共 IP 地址的扩展位置。	ExtendedLocation
性能	公共 IP 地址属性。	PublicIPAddressPropertiesFormat
区	表示为资源分配的 IP 需要来自的可用性区域列表。	string[]

ExtendedLocation

名字	描述	价值
名字	扩展位置的名称。	字符串
类型	扩展位置的类型。	“EdgeZone”

PublicIPAddressPropertiesFormat

名字	描述	价值
ddosSettings	与公共 IP 地址关联的 DDoS 保护自定义策略。	DdosSettings
deleteOption	指定删除 VM 时公共 IP 地址会发生什么情况	“Delete” “分离”
dnsSettings	与公共 IP 地址关联的 DNS 记录的 FQDN。	PublicIPAddressDnsSettings
idleTimeoutInMinutes	公共 IP 地址的空闲超时。	int
ipAddress	与公共 IP 地址资源关联的 IP 地址。	字符串
ipTags	与公共 IP 地址关联的标记列表。	IpTag[]
linkedPublicIPAddress	公共 IP 地址资源的链接公共 IP 地址。	PublicIPAddress
migrationPhase	公共 IP 地址的迁移阶段。	“中止” “提交” “已提交” “None” “准备”
natGateway	公共 IP 地址的 NatGateway。	NatGateway
publicIPAddressVersion	公共 IP 地址版本。	“IPv4” “IPv6”
publicIPAllocationMethod	公共 IP 地址分配方法。	“Dynamic” “Static”
publicIPPrefix	应从中分配此公共 IP 地址的公共 IP 前缀。	SubResource
servicePublicIPAddress	公共 IP 地址资源的服务公共 IP 地址。	PublicIPAddress

DdosSettings

名字	描述	价值
ddosCustomPolicy	与公共 IP 关联的 DDoS 自定义策略。	SubResource
protectedIP	在公共 IP 上启用 DDoS 保护。	bool
protectionCoverage	公共 IP 的 DDoS 保护策略可自定义性。 只有标准覆盖范围才能进行自定义。	“Basic” “Standard”

SubResource

名字	描述	价值
id	资源 ID。	字符串

PublicIPAddressDnsSettings

名字	描述	价值
domainNameLabel	域名标签。 域名标签和区域化 DNS 区域的串联构成了与公共 IP 地址关联的完全限定域名。 如果指定了域名标签，则会为 Microsoft Azure DNS 系统中的公共 IP 创建 A DNS 记录。	字符串
fqdn	与公共 IP 关联的 A DNS 记录的完全限定域名。 这是 domainNameLabel 和区域化 DNS 区域的串联。	字符串
reverseFqdn	反向 FQDN。 解析为此公共 IP 地址的用户可见完全限定域名。 如果指定了 reverseFqdn，则会创建 PTR DNS 记录，该记录从 in-addr.arpa 域中的 IP 地址指向反向 FQDN。	字符串

IpTag

名字	描述	价值
ipTagType	IP 标记类型。 示例：FirstPartyUsage。	字符串
标记	与公共 IP 关联的 IP 标记的值。 示例：SQL。	字符串

PublicIPAddress

名字	描述	价值
extendedLocation	公共 IP 地址的扩展位置。	ExtendedLocation
id	资源 ID。	字符串
位置	资源位置。	字符串
性能	公共 IP 地址属性。	PublicIPAddressPropertiesFormat
sku	公共 IP 地址 SKU。	PublicIPAddressSku
标签	资源标记。	对象
区	表示为资源分配的 IP 需要来自的可用性区域列表。	string[]

PublicIPAddressSku

名字	描述	价值
名字	公共 IP 地址 SKU 的名称。	“Basic” “Standard”
层	公共 IP 地址 SKU 的层。	“Global” “区域”

NatGateway

名字	描述	价值
id	资源 ID。	字符串
位置	资源位置。	字符串
性能	Nat 网关属性。	NatGatewayPropertiesFormat
sku	nat 网关 SKU。	NatGatewaySku
标签	资源标记。	对象
区	表示应在其中部署 Nat 网关的区域的可用性区域的列表。	string[]

NatGatewayPropertiesFormat

名字	描述	价值
idleTimeoutInMinutes	nat 网关的空闲超时。	int
publicIpAddresses	与 nat 网关资源关联的公共 IP 地址数组。	SubResource[]
publicIpPrefixes	与 nat 网关资源关联的公共 IP 前缀数组。	SubResource[]

NatGatewaySku

名字	描述	价值
名字	Nat 网关 SKU 的名称。	“Standard”