Partager via


Microsoft.Network publicIPPrefixes 2023-06-01

Définition de ressource Bicep

Le type de ressource publicIPPrefixes peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Network/publicIPPrefixes, ajoutez le Bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Network/publicIPPrefixes@2023-06-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    name: 'Standard'
    tier: 'string'
  }
  extendedLocation: {
    name: 'string'
    type: 'EdgeZone'
  }
  properties: {
    customIPPrefix: {
      id: 'string'
    }
    ipTags: [
      {
        ipTagType: 'string'
        tag: 'string'
      }
    ]
    natGateway: {
      id: 'string'
      location: 'string'
      properties: {
        idleTimeoutInMinutes: int
        publicIpAddresses: [
          {
            id: 'string'
          }
        ]
        publicIpPrefixes: [
          {
            id: 'string'
          }
        ]
      }
      sku: {
        name: 'Standard'
      }
      tags: {}
      zones: [
        'string'
      ]
    }
    prefixLength: int
    publicIPAddressVersion: 'string'
  }
  zones: [
    'string'
  ]
}

Valeurs de propriétés

publicIPPrefixes

Nom Description Valeur
name Nom de la ressource string (obligatoire)

Limite de caractères : 1-80

Caractères valides :
Caractères alphanumériques, traits de soulignement, points et traits d’union.

Doit commencer par un caractère alphanumérique. Doit se terminer par un caractère alphanumérique ou un trait de soulignement.
location Emplacement de la ressource. string
tags Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
sku Référence SKU de préfixe d’adresse IP publique. PublicIPPrefixSku
extendedLocation Emplacement étendu de l’adresse IP publique. ExtendedLocation
properties Propriétés de préfixe d’adresse IP publique. PublicIPPrefixPropertiesFormat
zones Liste des zones de disponibilité indiquant l’adresse IP allouée à la ressource doit provenir. string[]

ExtendedLocation

Nom Description Valeur
name Nom de l’emplacement étendu. string
type Type de l’emplacement étendu. 'EdgeZone'

PublicIPPrefixPropertiesFormat

Nom Description Valeur
customIPPrefix CustomIpPrefix auquel ce préfixe est associé. object
ipTags Liste des balises associées au préfixe d’adresse IP publique. IpTag[]
natGateway NatGateway du préfixe d’adresse IP publique. NatGateway
prefixLength Longueur du préfixe d’adresse IP publique. int
publicIPAddressVersion Version de l’adresse IP publique. 'IPv4'
'IPv6'

SubResource

Nom Description Valeur
id ID de la ressource string

IpTag

Nom Description Valeur
ipTagType Type de balise IP. Exemple : FirstPartyUsage. string
étiquette Valeur de la balise IP associée à l’adresse IP publique. Exemple : SQL. string

NatGateway

Nom Description Valeur
id ID de la ressource string
location Emplacement de la ressource. string
properties Propriétés de la passerelle Nat. NatGatewayPropertiesFormat
sku Référence SKU de passerelle nat. NatGatewaySku
tags Balises de ressource. object
zones Liste des zones de disponibilité indiquant la zone dans laquelle Nat Gateway doit être déployé. string[]

NatGatewayPropertiesFormat

Nom Description Valeur
idleTimeoutInMinutes Délai d’inactivité de la passerelle nat. int
publicIpAddresses Tableau d’adresses IP publiques associées à la ressource de passerelle nat. SubResource[]
publicIpPrefixes Tableau de préfixes ip publics associés à la ressource de passerelle nat. SubResource[]

NatGatewaySku

Nom Description Valeur
name Nom de la référence SKU Nat Gateway. 'Standard'

PublicIPPrefixSku

Nom Description Valeur
name Nom d’une référence SKU de préfixe d’adresse IP publique. 'Standard'
Niveau Niveau d’une référence SKU de préfixe d’adresse IP publique. 'Global'
'Régional'

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Cluster AKS avec une passerelle NAT et un Application Gateway

Déployer sur Azure
Cet exemple montre comment déployer un cluster AKS avec une passerelle NAT pour les connexions sortantes et un Application Gateway pour les connexions entrantes.
VMSS avec préfixe d’adresse IP publique

Déployer sur Azure
Modèle de déploiement de VMSS avec préfixe d’adresse IP publique
Créer un pare-feu Azure avec plusieurs adresses IP publiques

Déployer sur Azure
Ce modèle crée un Pare-feu Azure avec deux adresses IP publiques et deux serveurs Windows Server 2019 à tester.

Définition de ressources de modèle ARM

Le type de ressource publicIPPrefixes peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Network/publicIPPrefixes, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.Network/publicIPPrefixes",
  "apiVersion": "2023-06-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "name": "Standard",
    "tier": "string"
  },
  "extendedLocation": {
    "name": "string",
    "type": "EdgeZone"
  },
  "properties": {
    "customIPPrefix": {
      "id": "string"
    },
    "ipTags": [
      {
        "ipTagType": "string",
        "tag": "string"
      }
    ],
    "natGateway": {
      "id": "string",
      "location": "string",
      "properties": {
        "idleTimeoutInMinutes": "int",
        "publicIpAddresses": [
          {
            "id": "string"
          }
        ],
        "publicIpPrefixes": [
          {
            "id": "string"
          }
        ]
      },
      "sku": {
        "name": "Standard"
      },
      "tags": {},
      "zones": [ "string" ]
    },
    "prefixLength": "int",
    "publicIPAddressVersion": "string"
  },
  "zones": [ "string" ]
}

Valeurs de propriétés

publicIPPrefixes

Nom Description Valeur
type Type de ressource 'Microsoft.Network/publicIPPrefixes'
apiVersion Version de l’API de ressource '2023-06-01'
name Nom de la ressource string (obligatoire)

Limite de caractères : 1-80

Caractères valides :
Caractères alphanumériques, traits de soulignement, points et traits d’union.

Doit commencer par un caractère alphanumérique. Doit se terminer par un caractère alphanumérique ou un trait de soulignement.
location Emplacement de la ressource. string
tags Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
sku Référence SKU de préfixe d’adresse IP publique. PublicIPPrefixSku
extendedLocation Emplacement étendu de l’adresse IP publique. ExtendedLocation
properties Propriétés de préfixe d’adresse IP publique. PublicIPPrefixPropertiesFormat
zones Liste des zones de disponibilité indiquant l’adresse IP allouée à la ressource doit provenir. string[]

ExtendedLocation

Nom Description Valeur
name Nom de l’emplacement étendu. string
type Type de l’emplacement étendu. 'EdgeZone'

PublicIPPrefixPropertiesFormat

Nom Description Valeur
customIPPrefix CustomIpPrefix auquel ce préfixe est associé. object
ipTags Liste des balises associées au préfixe d’adresse IP publique. IpTag[]
natGateway NatGateway du préfixe d’adresse IP publique. NatGateway
prefixLength Longueur du préfixe d’adresse IP publique. int
publicIPAddressVersion Version de l’adresse IP publique. 'IPv4'
'IPv6'

SubResource

Nom Description Valeur
id ID de la ressource string

IpTag

Nom Description Valeur
ipTagType Type de balise IP. Exemple : FirstPartyUsage. string
étiquette Valeur de la balise IP associée à l’adresse IP publique. Exemple : SQL. string

NatGateway

Nom Description Valeur
id ID de la ressource string
location Emplacement de la ressource. string
properties Propriétés de la passerelle Nat. NatGatewayPropertiesFormat
sku Référence SKU de passerelle nat. NatGatewaySku
tags Balises de ressource. object
zones Liste des zones de disponibilité indiquant la zone dans laquelle Nat Gateway doit être déployé. string[]

NatGatewayPropertiesFormat

Nom Description Valeur
idleTimeoutInMinutes Délai d’inactivité de la passerelle nat. int
publicIpAddresses Tableau d’adresses IP publiques associées à la ressource de passerelle nat. SubResource[]
publicIpPrefixes Tableau de préfixes ip publics associés à la ressource de passerelle nat. SubResource[]

NatGatewaySku

Nom Description Valeur
name Nom de la référence SKU Nat Gateway. 'Standard'

PublicIPPrefixSku

Nom Description Valeur
name Nom d’une référence SKU de préfixe d’adresse IP publique. 'Standard'
Niveau Niveau d’une référence SKU de préfixe d’adresse IP publique. 'Global'
'Régional'

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Cluster AKS avec une passerelle NAT et un Application Gateway

Déployer sur Azure
Cet exemple montre comment déployer un cluster AKS avec une passerelle NAT pour les connexions sortantes et un Application Gateway pour les connexions entrantes.
VMSS avec préfixe d’adresse IP publique

Déployer sur Azure
Modèle de déploiement de VMSS avec préfixe d’adresse IP publique
Créer un pare-feu Azure avec plusieurs adresses IP publiques

Déployer sur Azure
Ce modèle crée un Pare-feu Azure avec deux adresses IP publiques et deux serveurs Windows Server 2019 à tester.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource publicIPPrefixes peut être déployé avec des opérations qui ciblent :

  • Groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Network/publicIPPrefixes, ajoutez le Terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/publicIPPrefixes@2023-06-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      customIPPrefix = {
        id = "string"
      }
      ipTags = [
        {
          ipTagType = "string"
          tag = "string"
        }
      ]
      natGateway = {
        id = "string"
        location = "string"
        properties = {
          idleTimeoutInMinutes = int
          publicIpAddresses = [
            {
              id = "string"
            }
          ]
          publicIpPrefixes = [
            {
              id = "string"
            }
          ]
        }
        sku = {
          name = "Standard"
        }
        tags = {}
        zones = [
          "string"
        ]
      }
      prefixLength = int
      publicIPAddressVersion = "string"
    }
    zones = [
      "string"
    ]
    sku = {
      name = "Standard"
      tier = "string"
    }
    extendedLocation = {
      name = "string"
      type = "EdgeZone"
    }
  })
}

Valeurs de propriétés

publicIPPrefixes

Nom Description Valeur
type Type de ressource « Microsoft.Network/publicIPPrefixes@2023-06-01 »
name Nom de la ressource string (obligatoire)

Limite de caractères : 1-80

Caractères valides :
Caractères alphanumériques, traits de soulignement, points et traits d’union.

Doit commencer par un caractère alphanumérique. Doit se terminer par un caractère alphanumérique ou un trait de soulignement.
location Emplacement de la ressource. string
parent_id Pour effectuer un déploiement dans un groupe de ressources, utilisez l’ID de ce groupe de ressources. string (obligatoire)
tags Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes.
sku Référence SKU de préfixe d’adresse IP publique. PublicIPPrefixSku
extendedLocation Emplacement étendu de l’adresse IP publique. ExtendedLocation
properties Propriétés de préfixe d’adresse IP publique. PublicIPPrefixPropertiesFormat
zones Liste des zones de disponibilité indiquant l’adresse IP allouée à la ressource doit provenir. string[]

ExtendedLocation

Nom Description Valeur
name Nom de l’emplacement étendu. string
type Type de l’emplacement étendu. « EdgeZone »

PublicIPPrefixPropertiesFormat

Nom Description Valeur
customIPPrefix CustomIpPrefix auquel ce préfixe est associé. object
ipTags Liste des balises associées au préfixe d’adresse IP publique. IpTag[]
natGateway NatGateway du préfixe d’adresse IP publique. NatGateway
prefixLength Longueur du préfixe d’adresse IP publique. int
publicIPAddressVersion Version de l’adresse IP publique. « IPv4 »
« IPv6 »

SubResource

Nom Description Valeur
id ID de la ressource string

IpTag

Nom Description Valeur
ipTagType Type de balise IP. Exemple : FirstPartyUsage. string
étiquette Valeur de la balise IP associée à l’adresse IP publique. Exemple : SQL. string

NatGateway

Nom Description Valeur
id ID de la ressource string
location Emplacement de la ressource. string
properties Propriétés de la passerelle Nat. NatGatewayPropertiesFormat
sku Référence SKU de passerelle nat. NatGatewaySku
tags Balises de ressource. object
zones Liste des zones de disponibilité indiquant la zone dans laquelle Nat Gateway doit être déployé. string[]

NatGatewayPropertiesFormat

Nom Description Valeur
idleTimeoutInMinutes Délai d’inactivité de la passerelle nat. int
publicIpAddresses Tableau d’adresses IP publiques associées à la ressource de passerelle nat. SubResource[]
publicIpPrefixes Tableau de préfixes ip publics associés à la ressource de passerelle nat. SubResource[]

NatGatewaySku

Nom Description Valeur
name Nom de la référence SKU Nat Gateway. « Standard »

PublicIPPrefixSku

Nom Description Valeur
name Nom d’une référence SKU de préfixe d’adresse IP publique. « Standard »
Niveau Niveau d’une référence SKU de préfixe d’adresse IP publique. « Global »
« Régional »