Microsoft.Network publicIPPrefixes

Article
08/07/2023

Définition de ressource Bicep

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

Groupes de ressources - Voir commandes de déploiement de groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’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-04-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	chaîne (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 du 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 pour 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
préfixeLength	Longueur du préfixe d’adresse IP publique.	int
publicIPAddressVersion	Version de l’adresse IP publique.	'IPv4' 'IPv6'

Sous-ressource

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 la 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.	Sous-ressource[]
publicIpPrefixes	Tableau de préfixes ip publics associés à la ressource de passerelle nat.	Sous-ressource[]

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 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	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	Modèle de déploiement de VMSS avec préfixe IP public
Créer un pare-feu Azure avec plusieurs adresses IP publiques	Ce modèle crée une 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 :

Groupes de ressources - Voir commandes de déploiement de groupes de ressources

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

Format des ressources

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

{
  "type": "Microsoft.Network/publicIPPrefixes",
  "apiVersion": "2023-04-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-04-01'
name	Nom de la ressource	chaîne (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 du 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 pour 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
préfixeLength	Longueur du préfixe d’adresse IP publique.	int
publicIPAddressVersion	Version de l’adresse IP publique.	'IPv4' 'IPv6'

Sous-ressource

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 la 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.	Sous-ressource[]
publicIpPrefixes	Tableau de préfixes ip publics associés à la ressource de passerelle nat.	Sous-ressource[]

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	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	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	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-04-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-04-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 »

Microsoft.Network publicIPPrefixes

Définition de ressource Bicep

Format des ressources

Valeurs de propriétés

publicIPPrefixes

ExtendedLocation

PublicIPPrefixPropertiesFormat

Sous-ressource

IpTag

NatGateway

NatGatewayPropertiesFormat

NatGatewaySku

PublicIPPrefixSku

Modèles de démarrage rapide

Définition de ressources de modèle ARM

Format des ressources

Valeurs de propriétés

publicIPPrefixes

ExtendedLocation

PublicIPPrefixPropertiesFormat

Sous-ressource

IpTag

NatGateway

NatGatewayPropertiesFormat

NatGatewaySku

PublicIPPrefixSku

Modèles de démarrage rapide

Définition de ressource Terraform (fournisseur AzAPI)

Format des ressources

Valeurs de propriétés

publicIPPrefixes

ExtendedLocation

PublicIPPrefixPropertiesFormat

SubResource

IpTag

NatGateway

NatGatewayPropertiesFormat

NatGatewaySku

PublicIPPrefixSku

Commentaires

Commentaires

Ressources supplémentaires