Microsoft.Network frontDoors 2019-05-01

Article
12/09/2024

Définition de ressource Bicep

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

groupes de ressources - Consultez 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 de ressource

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

resource symbolicname 'Microsoft.Network/frontDoors@2019-05-01' = {
  location: 'string'
  name: 'string'
  properties: {
    backendPools: [
      {
        id: 'string'
        name: 'string'
        properties: {
          backends: [
            {
              address: 'string'
              backendHostHeader: 'string'
              enabledState: 'string'
              httpPort: int
              httpsPort: int
              priority: int
              weight: int
            }
          ]
          healthProbeSettings: {
            id: 'string'
          }
          loadBalancingSettings: {
            id: 'string'
          }
        }
      }
    ]
    backendPoolsSettings: {
      enforceCertificateNameCheck: 'string'
      sendRecvTimeoutSeconds: int
    }
    enabledState: 'string'
    friendlyName: 'string'
    frontendEndpoints: [
      {
        id: 'string'
        name: 'string'
        properties: {
          hostName: 'string'
          sessionAffinityEnabledState: 'string'
          sessionAffinityTtlSeconds: int
          webApplicationFirewallPolicyLink: {
            id: 'string'
          }
        }
      }
    ]
    healthProbeSettings: [
      {
        id: 'string'
        name: 'string'
        properties: {
          enabledState: 'string'
          healthProbeMethod: 'string'
          intervalInSeconds: int
          path: 'string'
          protocol: 'string'
        }
      }
    ]
    loadBalancingSettings: [
      {
        id: 'string'
        name: 'string'
        properties: {
          additionalLatencyMilliseconds: int
          sampleSize: int
          successfulSamplesRequired: int
        }
      }
    ]
    routingRules: [
      {
        id: 'string'
        name: 'string'
        properties: {
          acceptedProtocols: [
            'string'
          ]
          enabledState: 'string'
          frontendEndpoints: [
            {
              id: 'string'
            }
          ]
          patternsToMatch: [
            'string'
          ]
          routeConfiguration: {
            @odata.type: 'string'
            // For remaining properties, see RouteConfiguration objects
          }
        }
      }
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

Objets RouteConfiguration

Définissez la propriété @odata.type pour spécifier le type d’objet.

Pour #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration, utilisez :

{
  @odata.type: '#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration'
  backendPool: {
    id: 'string'
  }
  cacheConfiguration: {
    dynamicCompression: 'string'
    queryParameterStripDirective: 'string'
  }
  customForwardingPath: 'string'
  forwardingProtocol: 'string'
}

Pour #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration, utilisez :

{
  @odata.type: '#Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration'
  customFragment: 'string'
  customHost: 'string'
  customPath: 'string'
  customQueryString: 'string'
  redirectProtocol: 'string'
  redirectType: 'string'
}

Valeurs de propriété

Back-end

Nom	Description	Valeur
adresse	Emplacement du serveur principal (adresse IP ou nom de domaine complet)	corde
backendHostHeader	Valeur à utiliser comme en-tête de l’hôte envoyé au back-end. S’il est vide ou non spécifié, il s’agit par défaut de l’hôte entrant.	corde
enabledState	Indique s’il faut activer l’utilisation de ce back-end. Les valeurs autorisées sont « Enabled » ou « Disabled »	'Désactivé' 'Activé'
httpPort	Numéro de port TCP HTTP. Doit être compris entre 1 et 65535.	Int Contraintes: Valeur minimale = 1 Valeur maximale = 65535
httpsPort	Numéro de port TCP HTTPS. Doit être compris entre 1 et 65535.	Int Contraintes: Valeur minimale = 1 Valeur maximale = 65535
priorité	Priorité à utiliser pour l’équilibrage de charge. Les priorités plus élevées ne seront pas utilisées pour l’équilibrage de charge si un back-end de priorité inférieure est sain.	Int Contraintes: Valeur minimale = 1 Valeur maximale = 5
poids	Poids de ce point de terminaison à des fins d’équilibrage de charge.	Int Contraintes: Valeur minimale = 1 Valeur maximale = 1 000

BackendPool

Nom	Description	Valeur
id	ID de ressource.	corde
nom	Nom de la ressource.	corde
Propriétés	Propriétés du pool principal Front Door	BackendPoolProperties

BackendPoolProperties

Nom	Description	Valeur
back-ends	Ensemble de back-ends pour ce pool	principal []
healthProbeSettings	Paramètres de sonde d’intégrité L7 pour un pool principal	SubResource
loadBalancingSettings	Paramètres d’équilibrage de charge pour un pool principal	SubResource

BackendPoolsSettings

Nom	Description	Valeur
enforceCertificateNameCheck	Indique s’il faut appliquer la vérification du nom de certificat sur les requêtes HTTPS à tous les pools principaux. Aucun effet sur les requêtes non HTTPS.	'Désactivé' 'Activé'
sendRecvTimeoutSeconds	Envoyer et recevoir le délai d’expiration lors du transfert de la demande vers le serveur principal. Lorsque le délai d’expiration est atteint, la requête échoue et retourne.	Int Contraintes: Valeur minimale = 16

CacheConfiguration

Nom	Description	Valeur
dynamicCompression	Indique s’il faut utiliser la compression dynamique pour le contenu mis en cache	'Désactivé' 'Activé'
queryParameterStripDirective	Traitement des termes de requête d’URL lors de la formation de la clé de cache.	'StripAll' 'StripNone'

ForwardingConfiguration

Nom	Description	Valeur
@odata.type		'#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration' (obligatoire)
backendPool	Référence au BackendPool vers lequel cette règle est acheminée.	SubResource
cacheConfiguration	Configuration de mise en cache associée à cette règle.	CacheConfiguration
customForwardingPath	Chemin d’accès personnalisé utilisé pour réécrire les chemins de ressources mis en correspondance par cette règle. Laissez vide pour utiliser le chemin entrant.	corde
forwardingProtocol	Protocole que cette règle utilisera lors du transfert du trafic vers des back-ends.	'HttpOnly' 'HttpsOnly' 'MatchRequest'

FrontDoorProperties

Nom	Description	Valeur
backendPools	Pools principaux disponibles pour les règles de routage.	BackendPool[]
backendPoolsSettings	Paramètres de tous les backendPools	BackendPoolsSettings
enabledState	État opérationnel de l’équilibreur de charge Front Door. Les valeurs autorisées sont « Enabled » ou « Disabled »	'Désactivé' 'Activé'
friendlyName	Un nom convivial pour le frontDoor	corde
frontendEndpoints	Points de terminaison frontaux disponibles pour les règles de routage.	frontendpoint[]
healthProbeSettings	Paramètres de sonde d’intégrité associés à cette instance Front Door.	HealthProbeSettingsModel[]
loadBalancingSettings	Paramètres d’équilibrage de charge associés à cette instance Front Door.	LoadBalancingSettingsModel[]
routingRules	Règles de routage associées à cette porte d’entrée.	RoutingRule[]

FrontendEndpoint

Nom	Description	Valeur
id	ID de ressource.	corde
nom	Nom de la ressource.	corde
Propriétés	Propriétés du point de terminaison frontal	FrontendEndpointProperties

FrontendEndpointProperties

Nom	Description	Valeur
hostName	Nom d’hôte du frontendEndpoint. Doit être un nom de domaine.	corde
sessionAffinityEnabledState	Indique s’il faut autoriser l’affinité de session sur cet hôte. Les options valides sont « Activé » ou « Désactivé »	'Désactivé' 'Activé'
sessionAffinityTtlSeconds	INUTILISÉ. Ce champ est ignoré. Durée de vie à utiliser en secondes pour l’affinité de session, le cas échéant.	Int
webApplicationFirewallPolicyLink	Définit la stratégie de pare-feu d’applications web pour chaque hôte (le cas échéant)	FrontendendpointUpdateParametersWebApplicationFirewallPolicyLink

FrontendEndpointUpdateParametersWebApplicationFirewallPolicyLink

Nom	Description	Valeur
id	ID de ressource.	corde

HealthProbeSettingsModel

Nom	Description	Valeur
id	ID de ressource.	corde
nom	Nom de la ressource.	corde
Propriétés	Propriétés des paramètres de la sonde d’intégrité	HealthProbeSettingsProperties

HealthProbeSettingsProperties

Nom	Description	Valeur
enabledState	Indique s’il faut activer les sondes d’intégrité sur les back-ends définis sous backendPools. Les sondes d’intégrité ne peuvent être désactivées que s’il existe un seul back-end activé dans un pool principal activé unique.	'Désactivé' 'Activé'
healthProbeMethod	Configure la méthode HTTP à utiliser pour sonder les back-ends définis sous backendPools.	'GET' 'HEAD'
intervalInSeconds	Nombre de secondes entre les sondes d’intégrité.	Int
chemin	Chemin à utiliser pour la sonde d’intégrité. La valeur par défaut est /	corde
protocole	Schéma de protocole à utiliser pour cette sonde	'Http' 'Https'

LoadBalancingSettingsModel

Nom	Description	Valeur
id	ID de ressource.	corde
nom	Nom de la ressource.	corde
Propriétés	Propriétés des paramètres d’équilibrage de charge	LoadBalancingSettingsProperties

LoadBalancingSettingsProperties

Nom	Description	Valeur
additionalLatencyMilliseconds	Latence supplémentaire en millisecondes pour que les sondes tombent dans le compartiment de latence le plus bas	Int
sampleSize	Nombre d’exemples à prendre en compte pour les décisions d’équilibrage de charge	Int
successfulSamplesRequired	Nombre d’échantillons au cours de la période d’échantillonnage qui doivent réussir	Int