Общедоступный IP-адреса Microsoft.NetworkРефиксы 2025-01-01

Определение ресурсов Bicep

Тип ресурса publicIPPrefixes может быть развернут с помощью операций, нацеленных на:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/publicIPPrefixes, добавьте в шаблон следующий Bicep.

resource symbolicname 'Microsoft.Network/publicIPPrefixes@2025-01-01' = {
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  location: 'string'
  name: 'string'
  properties: {
    customIPPrefix: {
      id: 'string'
    }
    ipTags: [
      {
        ipTagType: 'string'
        tag: 'string'
      }
    ]
    natGateway: {
      id: 'string'
      location: 'string'
      properties: {
        idleTimeoutInMinutes: int
        publicIpAddresses: [
          {
            id: 'string'
          }
        ]
        publicIpAddressesV6: [
          {
            id: 'string'
          }
        ]
        publicIpPrefixes: [
          {
            id: 'string'
          }
        ]
        publicIpPrefixesV6: [
          {
            id: 'string'
          }
        ]
        sourceVirtualNetwork: {
          id: 'string'
        }
      }
      sku: {
        name: 'string'
      }
      tags: {
        {customized property}: 'string'
      }
      zones: [
        'string'
      ]
    }
    prefixLength: int
    publicIPAddressVersion: 'string'
  }
  sku: {
    name: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
  zones: [
    'string'
  ]
}

Значения свойств

Microsoft.Network/publicIPPrefixes

Имя Description Ценность
расширенноеМестоположение Расширенное расположение общедоступного IP-адреса. ExtendedLocation
location Расположение ресурса. струна
имя имя ресурса. строка (обязательно)
properties Свойства префикса общедоступного IP-адреса. ПубличныйIPPrefixPropertiesFormat
sku SKU префикса общедоступного IP-адреса. ПубличныйIPPrefixSku
tags Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
зоны Список зон доступности, обозначающих IP-адрес, выделенный для ресурса, должен поступать из. строка[]

ExtendedLocation

Имя Description Ценность
имя Имя расширенного расположения. струна
type Тип расширенного расположения. EdgeZone

IpTag

Имя Description Ценность
ipTagType Тип тега IP. Пример: FirstPartyUsage. струна
tag Значение тега IP, связанного с общедоступным IP-адресом. Пример: SQL. струна

NatGateway

Имя Description Ценность
id Идентификатор ресурса. струна
location Расположение ресурса. струна
properties Свойства шлюза Nat. NatGatewayPropertiesFormat
sku Номер SKU шлюза NAT. NatGatewaySku
tags Теги ресурсов. ResourceTags
зоны Список зон доступности, обозначающих зону, в которой должен быть развернут шлюз Nat. строка[]

NatGatewayPropertiesFormat

Имя Description Ценность
idleTimeoutInMinutes Время ожидания простоя шлюза NAT. инт
публичные IP-адреса Массив общедоступных IP-адресов V4, связанный с ресурсом шлюза nat. Подресурс[]
публичные IP-адресаV6 Массив общедоступных IP-адресов V6, связанный с ресурсом шлюза nat. Подресурс[]
publicIpPrefixes Массив префиксов публичных ip V4, связанных с ресурсом шлюза nat. Подресурс[]
publicIpPrefixesV6 Массив префиксов общедоступных ip-адресов V6, связанных с ресурсом шлюза nat. Подресурс[]
sourceVirtualNetwork Ссылка на исходную виртуальную сеть, использующую этот ресурс шлюза nat. Подресурс

NatGatewaySku

Имя Description Ценность
имя Имя SKU шлюза Nat. 'Standard'
'СтандартV2'

ПубличныйIPPrefixPropertiesFormat

Имя Description Ценность
customIPПрефикс Префикс customIpPrefix, с которым связан этот префикс. Подресурс
ipТеги Список тегов, связанных с префиксом общедоступного IP-адреса. IpTag[]
natGateway NatGateway префикса общедоступного IP. NatGateway
prefixLength Длина префикса общедоступного IP-адреса. инт
publicIPAddressVersion Версия общедоступного IP-адреса. IPv4
IPv6

ПубличныйIPPrefixSku

Имя Description Ценность
имя Имя номера SKU общедоступного IP-адреса. 'Standard'
'СтандартV2'
tier Уровень SKU общедоступного IP-адреса. "Глобальный"
"Региональный"

ResourceTags

Имя Description Ценность

ResourceTags

Имя Description Ценность

Подресурс

Имя Description Ценность
id Идентификатор ресурса. струна

Примеры использования

Примеры Bicep

Простой пример развертывания префикса общедоступного IP-адреса.

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource publicIPPrefix 'Microsoft.Network/publicIPPrefixes@2022-07-01' = {
  name: resourceName
  location: location
  properties: {
    prefixLength: 30
    publicIPAddressVersion: 'IPv4'
  }
  sku: {
    name: 'Standard'
  }
  zones: [
    '1'
  ]
}

Проверенные модули Azure

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.

Модуль Description
Префикс общедоступного IP Ресурсный модуль AVM для префикса общедоступного IP

Примеры быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.

Файл Bicep Description
кластер AKS с шлюзом NAT и шлюзом приложений В этом примере показано, как развернуть кластер AKS с шлюзом NAT для исходящих подключений и шлюза приложений для входящих подключений.
Создание брандмауэра Azure с несколькими общедоступными IP-адресами Этот шаблон создает брандмауэр Azure с двумя общедоступными IP-адресами и двумя серверами Windows Server 2019 для тестирования.
VMSS с префиксом общедоступного IP-адреса Шаблон для развертывания VMSS с префиксом общедоступного IP-адреса

Определение ресурса шаблона ARM

Тип ресурса publicIPPrefixes может быть развернут с помощью операций, нацеленных на:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/publicIPPrefixes, добавьте в шаблон следующий код JSON.

{
  "type": "Microsoft.Network/publicIPPrefixes",
  "apiVersion": "2025-01-01",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "location": "string",
  "properties": {
    "customIPPrefix": {
      "id": "string"
    },
    "ipTags": [
      {
        "ipTagType": "string",
        "tag": "string"
      }
    ],
    "natGateway": {
      "id": "string",
      "location": "string",
      "properties": {
        "idleTimeoutInMinutes": "int",
        "publicIpAddresses": [
          {
            "id": "string"
          }
        ],
        "publicIpAddressesV6": [
          {
            "id": "string"
          }
        ],
        "publicIpPrefixes": [
          {
            "id": "string"
          }
        ],
        "publicIpPrefixesV6": [
          {
            "id": "string"
          }
        ],
        "sourceVirtualNetwork": {
          "id": "string"
        }
      },
      "sku": {
        "name": "string"
      },
      "tags": {
        "{customized property}": "string"
      },
      "zones": [ "string" ]
    },
    "prefixLength": "int",
    "publicIPAddressVersion": "string"
  },
  "sku": {
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  },
  "zones": [ "string" ]
}

Значения свойств

Microsoft.Network/publicIPPrefixes

Имя Description Ценность
apiVersion Версия API '2025-01-01'
расширенноеМестоположение Расширенное расположение общедоступного IP-адреса. ExtendedLocation
location Расположение ресурса. струна
имя имя ресурса. строка (обязательно)
properties Свойства префикса общедоступного IP-адреса. ПубличныйIPPrefixPropertiesFormat
sku SKU префикса общедоступного IP-адреса. ПубличныйIPPrefixSku
tags Теги ресурсов Словарь имен и значений тегов. См. теги в шаблонах
type Тип ресурса «Microsoft.Network/publicIPPrefixes»
зоны Список зон доступности, обозначающих IP-адрес, выделенный для ресурса, должен поступать из. строка[]

ExtendedLocation

Имя Description Ценность
имя Имя расширенного расположения. струна
type Тип расширенного расположения. EdgeZone

IpTag

Имя Description Ценность
ipTagType Тип тега IP. Пример: FirstPartyUsage. струна
tag Значение тега IP, связанного с общедоступным IP-адресом. Пример: SQL. струна

NatGateway

Имя Description Ценность
id Идентификатор ресурса. струна
location Расположение ресурса. струна
properties Свойства шлюза Nat. NatGatewayPropertiesFormat
sku Номер SKU шлюза NAT. NatGatewaySku
tags Теги ресурсов. ResourceTags
зоны Список зон доступности, обозначающих зону, в которой должен быть развернут шлюз Nat. строка[]

NatGatewayPropertiesFormat

Имя Description Ценность
idleTimeoutInMinutes Время ожидания простоя шлюза NAT. инт
публичные IP-адреса Массив общедоступных IP-адресов V4, связанный с ресурсом шлюза nat. Подресурс[]
публичные IP-адресаV6 Массив общедоступных IP-адресов V6, связанный с ресурсом шлюза nat. Подресурс[]
publicIpPrefixes Массив префиксов публичных ip V4, связанных с ресурсом шлюза nat. Подресурс[]
publicIpPrefixesV6 Массив префиксов общедоступных ip-адресов V6, связанных с ресурсом шлюза nat. Подресурс[]
sourceVirtualNetwork Ссылка на исходную виртуальную сеть, использующую этот ресурс шлюза nat. Подресурс

NatGatewaySku

Имя Description Ценность
имя Имя SKU шлюза Nat. 'Standard'
'СтандартV2'

ПубличныйIPPrefixPropertiesFormat

Имя Description Ценность
customIPПрефикс Префикс customIpPrefix, с которым связан этот префикс. Подресурс
ipТеги Список тегов, связанных с префиксом общедоступного IP-адреса. IpTag[]
natGateway NatGateway префикса общедоступного IP. NatGateway
prefixLength Длина префикса общедоступного IP-адреса. инт
publicIPAddressVersion Версия общедоступного IP-адреса. IPv4
IPv6

ПубличныйIPPrefixSku

Имя Description Ценность
имя Имя номера SKU общедоступного IP-адреса. 'Standard'
'СтандартV2'
tier Уровень SKU общедоступного IP-адреса. "Глобальный"
"Региональный"

ResourceTags

Имя Description Ценность

ResourceTags

Имя Description Ценность

Подресурс

Имя Description Ценность
id Идентификатор ресурса. струна

Примеры использования

Шаблоны быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.

Template Description
кластер AKS с шлюзом NAT и шлюзом приложений

Развертывание в Azure
В этом примере показано, как развернуть кластер AKS с шлюзом NAT для исходящих подключений и шлюза приложений для входящих подключений.
Создание брандмауэра Azure с несколькими общедоступными IP-адресами

Развертывание в Azure
Этот шаблон создает брандмауэр Azure с двумя общедоступными IP-адресами и двумя серверами Windows Server 2019 для тестирования.
VMSS с префиксом общедоступного IP-адреса

Развертывание в Azure
Шаблон для развертывания VMSS с префиксом общедоступного IP-адреса

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса publicIPPrefixes может быть развернут с помощью операций, нацеленных на:

  • Группы ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/publicIPPrefixes, добавьте в шаблон следующую форму Terraform.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/publicIPPrefixes@2025-01-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      customIPPrefix = {
        id = "string"
      }
      ipTags = [
        {
          ipTagType = "string"
          tag = "string"
        }
      ]
      natGateway = {
        id = "string"
        location = "string"
        properties = {
          idleTimeoutInMinutes = int
          publicIpAddresses = [
            {
              id = "string"
            }
          ]
          publicIpAddressesV6 = [
            {
              id = "string"
            }
          ]
          publicIpPrefixes = [
            {
              id = "string"
            }
          ]
          publicIpPrefixesV6 = [
            {
              id = "string"
            }
          ]
          sourceVirtualNetwork = {
            id = "string"
          }
        }
        sku = {
          name = "string"
        }
        tags = {
          {customized property} = "string"
        }
        zones = [
          "string"
        ]
      }
      prefixLength = int
      publicIPAddressVersion = "string"
    }
    sku = {
      name = "string"
      tier = "string"
    }
    zones = [
      "string"
    ]
  }
}

Значения свойств

Microsoft.Network/publicIPPrefixes

Имя Description Ценность
расширенноеМестоположение Расширенное расположение общедоступного IP-адреса. ExtendedLocation
location Расположение ресурса. струна
имя имя ресурса. строка (обязательно)
properties Свойства префикса общедоступного IP-адреса. ПубличныйIPPrefixPropertiesFormat
sku SKU префикса общедоступного IP-адреса. ПубличныйIPPrefixSku
tags Теги ресурсов Словарь имен и значений тегов.
type Тип ресурса "Microsoft.Network/publicIPPrefixes@2025-01-01"
зоны Список зон доступности, обозначающих IP-адрес, выделенный для ресурса, должен поступать из. строка[]

ExtendedLocation

Имя Description Ценность
имя Имя расширенного расположения. струна
type Тип расширенного расположения. EdgeZone

IpTag

Имя Description Ценность
ipTagType Тип тега IP. Пример: FirstPartyUsage. струна
tag Значение тега IP, связанного с общедоступным IP-адресом. Пример: SQL. струна

NatGateway

Имя Description Ценность
id Идентификатор ресурса. струна
location Расположение ресурса. струна
properties Свойства шлюза Nat. NatGatewayPropertiesFormat
sku Номер SKU шлюза NAT. NatGatewaySku
tags Теги ресурсов. ResourceTags
зоны Список зон доступности, обозначающих зону, в которой должен быть развернут шлюз Nat. строка[]

NatGatewayPropertiesFormat

Имя Description Ценность
idleTimeoutInMinutes Время ожидания простоя шлюза NAT. инт
публичные IP-адреса Массив общедоступных IP-адресов V4, связанный с ресурсом шлюза nat. Подресурс[]
публичные IP-адресаV6 Массив общедоступных IP-адресов V6, связанный с ресурсом шлюза nat. Подресурс[]
publicIpPrefixes Массив префиксов публичных ip V4, связанных с ресурсом шлюза nat. Подресурс[]
publicIpPrefixesV6 Массив префиксов общедоступных ip-адресов V6, связанных с ресурсом шлюза nat. Подресурс[]
sourceVirtualNetwork Ссылка на исходную виртуальную сеть, использующую этот ресурс шлюза nat. Подресурс

NatGatewaySku

Имя Description Ценность
имя Имя SKU шлюза Nat. 'Standard'
'СтандартV2'

ПубличныйIPPrefixPropertiesFormat

Имя Description Ценность
customIPПрефикс Префикс customIpPrefix, с которым связан этот префикс. Подресурс
ipТеги Список тегов, связанных с префиксом общедоступного IP-адреса. IpTag[]
natGateway NatGateway префикса общедоступного IP. NatGateway
prefixLength Длина префикса общедоступного IP-адреса. инт
publicIPAddressVersion Версия общедоступного IP-адреса. IPv4
IPv6

ПубличныйIPPrefixSku

Имя Description Ценность
имя Имя номера SKU общедоступного IP-адреса. 'Standard'
'СтандартV2'
tier Уровень SKU общедоступного IP-адреса. "Глобальный"
"Региональный"

ResourceTags

Имя Description Ценность

ResourceTags

Имя Description Ценность

Подресурс

Имя Description Ценность
id Идентификатор ресурса. струна

Примеры использования

Примеры Terraform

Простой пример развертывания префикса общедоступного IP-адреса.

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 = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "publicIPPrefix" {
  type      = "Microsoft.Network/publicIPPrefixes@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      prefixLength           = 30
      publicIPAddressVersion = "IPv4"
    }
    sku = {
      name = "Standard"
    }
    zones = [
      "1",
    ]
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

Проверенные модули Azure

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.

Модуль Description
Префикс общедоступного IP Ресурсный модуль AVM для префикса общедоступного IP