Front Doors - Create Or Update

Référence

Service:: Front Door Service

Version d'API:: 2019-05-01

Crée une porte d’entrée avec un nom Front Door sous l’abonnement et le groupe de ressources spécifiés.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/frontDoors/{frontDoorName}?api-version=2019-05-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
frontDoorName	path	True	string	Nom de la porte d’entrée qui est globalement unique. Modèle d’expression régulière: `^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$`
resourceGroupName	path	True	string	Nom du groupe de ressources dans l’abonnement Azure. Modèle d’expression régulière: `^[a-zA-Z0-9_\-\.]*[^\.]$`
subscriptionId	path	True	string	Informations d’identification d’abonnement qui identifient de façon unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service.
api-version	query	True	string	Version d’API client.

Corps de la demande

Nom	Type	Description
location	string	Emplacement de la ressource.
properties.backendPools	BackendPool[]	Pools principaux disponibles pour les règles de routage.
properties.backendPoolsSettings	BackendPoolsSettings	Paramètres de tous les backendPools
properties.enabledState	FrontDoorEnabledState	État opérationnel de l’équilibreur de charge Front Door. Les valeurs autorisées sont « Enabled » ou « Disabled »
properties.friendlyName	string	Un nom convivial pour la porte d’entrée
properties.frontendEndpoints	FrontendEndpoint[]	Points de terminaison front-end disponibles pour les règles de routage.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Paramètres de sonde d’intégrité associés à cette instance Front Door.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Paramètres d’équilibrage de charge associés à cette instance Front Door.
properties.routingRules	RoutingRule[]	Règles de routage associées à cette porte d’entrée.
tags	object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	FrontDoor	OK. La demande a réussi.
201 Created	FrontDoor	Créé. La demande a été satisfaite et une nouvelle porte d’entrée a été créée.
202 Accepted	FrontDoor	Accepté. La demande a été acceptée pour traitement et l’opération se termine de manière asynchrone.
Other Status Codes	ErrorResponse	Réponse d’erreur Front Door décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

Create or update specific Front Door

Exemple de requête

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1?api-version=2019-05-01

{
  "location": "westus",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "routingRules": [
      {
        "name": "routingRule1",
        "properties": {
          "frontendEndpoints": [
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1"
            },
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default"
            }
          ],
          "acceptedProtocols": [
            "Http"
          ],
          "patternsToMatch": [
            "/*"
          ],
          "routeConfiguration": {
            "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
            "backendPool": {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1"
            }
          },
          "enabledState": "Enabled"
        }
      }
    ],
    "healthProbeSettings": [
      {
        "name": "healthProbeSettings1",
        "properties": {
          "path": "/",
          "protocol": "Http",
          "intervalInSeconds": 120,
          "enabledState": "Enabled",
          "healthProbeMethod": "HEAD"
        }
      }
    ],
    "loadBalancingSettings": [
      {
        "name": "loadBalancingSettings1",
        "properties": {
          "sampleSize": 4,
          "successfulSamplesRequired": 2
        }
      }
    ],
    "backendPools": [
      {
        "name": "backendPool1",
        "properties": {
          "backends": [
            {
              "address": "w3.contoso.com",
              "httpPort": 80,
              "httpsPort": 443,
              "weight": 1,
              "priority": 2
            },
            {
              "address": "contoso.com.website-us-west-2.othercloud.net",
              "httpPort": 80,
              "httpsPort": 443,
              "weight": 2,
              "priority": 1
            },
            {
              "address": "contoso1.azurewebsites.net",
              "httpPort": 80,
              "httpsPort": 443,
              "weight": 1,
              "priority": 1
            }
          ],
          "loadBalancingSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/loadBalancingSettings/loadBalancingSettings1"
          },
          "healthProbeSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/healthProbeSettings/healthProbeSettings1"
          }
        }
      }
    ],
    "frontendEndpoints": [
      {
        "name": "frontendEndpoint1",
        "properties": {
          "hostName": "www.contoso.com",
          "sessionAffinityEnabledState": "Enabled",
          "sessionAffinityTtlSeconds": 60,
          "webApplicationFirewallPolicyLink": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoorWebApplicationFirewallPolicies/policy1"
          }
        }
      },
      {
        "name": "default",
        "properties": {
          "hostName": "frontDoor1.azurefd.net"
        }
      }
    ],
    "backendPoolsSettings": {
      "enforceCertificateNameCheck": "Enabled",
      "sendRecvTimeoutSeconds": 60
    },
    "enabledState": "Enabled"
  }
}

Exemple de réponse

Code d’état:: 200

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1",
  "name": "frontDoor1",
  "type": "Microsoft.Network/frontDoor",
  "location": "westus",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "routingRules": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/routingRules/routingRule1",
        "name": "routingRule1",
        "properties": {
          "frontendEndpoints": [
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1"
            },
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default"
            }
          ],
          "acceptedProtocols": [
            "Http"
          ],
          "patternsToMatch": [
            "/*"
          ],
          "routeConfiguration": {
            "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
            "customForwardingPath": "",
            "forwardingProtocol": "MatchRequest",
            "backendPool": {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1"
            }
          },
          "enabledState": "Enabled"
        }
      }
    ],
    "healthProbeSettings": [
      {
        "name": "healthProbeSettings1",
        "properties": {
          "path": "/",
          "protocol": "Http",
          "intervalInSeconds": 120,
          "enabledState": "Enabled",
          "healthProbeMethod": "HEAD"
        }
      }
    ],
    "loadBalancingSettings": [
      {
        "name": "loadBalancingSettings1",
        "properties": {
          "sampleSize": 4,
          "successfulSamplesRequired": 2
        }
      }
    ],
    "backendPools": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1",
        "name": "backendPool1",
        "properties": {
          "backends": [
            {
              "address": "w3.contoso.com",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 2
            },
            {
              "address": "contoso.com.website-us-west-2.othercloud.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 2,
              "priority": 1
            },
            {
              "address": "contoso1.azurewebsites.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 1
            }
          ],
          "loadBalancingSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/loadBalancingSettings/loadBalancingSettings1"
          },
          "healthProbeSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/healthProbeSettings/healthProbeSettings1"
          }
        }
      }
    ],
    "frontendEndpoints": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1",
        "name": "frontendEndpoint1",
        "properties": {
          "hostName": "www.contoso.com",
          "sessionAffinityEnabledState": "Enabled",
          "sessionAffinityTtlSeconds": 60,
          "webApplicationFirewallPolicyLink": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoorWebApplicationFirewallPolicies/policy1"
          }
        }
      },
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default",
        "name": "default",
        "properties": {
          "hostName": "frontDoor1.azurefd.net"
        }
      }
    ],
    "backendPoolsSettings": {
      "enforceCertificateNameCheck": "Enabled",
      "sendRecvTimeoutSeconds": 60
    },
    "enabledState": "Enabled",
    "resourceState": "Creating",
    "provisioningState": "Succeeded",
    "cname": "frontDoor1.azurefd.net"
  }
}

Code d’état:: 201

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1",
  "name": "frontDoor1",
  "type": "Microsoft.Network/frontDoor",
  "location": "westus",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "routingRules": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/routingRules/routingRule1",
        "name": "routingRule1",
        "properties": {
          "frontendEndpoints": [
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1"
            },
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default"
            }
          ],
          "acceptedProtocols": [
            "Http"
          ],
          "patternsToMatch": [
            "/*"
          ],
          "routeConfiguration": {
            "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
            "customForwardingPath": "",
            "forwardingProtocol": "MatchRequest",
            "backendPool": {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1"
            }
          },
          "enabledState": "Enabled"
        }
      }
    ],
    "healthProbeSettings": [
      {
        "name": "healthProbeSettings1",
        "properties": {
          "path": "/",
          "protocol": "Http",
          "intervalInSeconds": 120,
          "enabledState": "Enabled",
          "healthProbeMethod": "HEAD"
        }
      }
    ],
    "loadBalancingSettings": [
      {
        "name": "loadBalancingSettings1",
        "properties": {
          "sampleSize": 4,
          "successfulSamplesRequired": 2
        }
      }
    ],
    "backendPools": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1",
        "name": "backendPool1",
        "properties": {
          "backends": [
            {
              "address": "w3.contoso.com",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 2
            },
            {
              "address": "contoso.com.website-us-west-2.othercloud.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 2,
              "priority": 1
            },
            {
              "address": "contoso1.azurewebsites.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 1
            }
          ],
          "loadBalancingSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/loadBalancingSettings/loadBalancingSettings1"
          },
          "healthProbeSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/healthProbeSettings/healthProbeSettings1"
          }
        }
      }
    ],
    "frontendEndpoints": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1",
        "name": "frontendEndpoint1",
        "properties": {
          "hostName": "www.contoso.com",
          "sessionAffinityEnabledState": "Enabled",
          "sessionAffinityTtlSeconds": 60,
          "webApplicationFirewallPolicyLink": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoorWebApplicationFirewallPolicies/policy1"
          }
        }
      },
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default",
        "name": "default",
        "properties": {
          "hostName": "frontDoor1.azurefd.net"
        }
      }
    ],
    "backendPoolsSettings": {
      "enforceCertificateNameCheck": "Enabled",
      "sendRecvTimeoutSeconds": 60
    },
    "enabledState": "Enabled",
    "resourceState": "Creating",
    "provisioningState": "Provisioning",
    "cname": "frontDoor1.azurefd.net"
  }
}

Code d’état:: 202

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1",
  "name": "frontDoor1",
  "type": "Microsoft.Network/frontDoor",
  "location": "westus",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "routingRules": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/routingRules/routingRule1",
        "name": "routingRule1",
        "properties": {
          "frontendEndpoints": [
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1"
            },
            {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default"
            }
          ],
          "acceptedProtocols": [
            "Http"
          ],
          "patternsToMatch": [
            "/*"
          ],
          "routeConfiguration": {
            "@odata.type": "#Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration",
            "customForwardingPath": "",
            "forwardingProtocol": "MatchRequest",
            "backendPool": {
              "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1"
            }
          },
          "enabledState": "Enabled"
        }
      }
    ],
    "healthProbeSettings": [
      {
        "name": "healthProbeSettings1",
        "properties": {
          "path": "/",
          "protocol": "Http",
          "intervalInSeconds": 120,
          "enabledState": "Enabled",
          "healthProbeMethod": "HEAD"
        }
      }
    ],
    "loadBalancingSettings": [
      {
        "name": "loadBalancingSettings1",
        "properties": {
          "sampleSize": 4,
          "successfulSamplesRequired": 2
        }
      }
    ],
    "backendPools": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/backendPools/backendPool1",
        "name": "backendPool1",
        "properties": {
          "backends": [
            {
              "address": "w3.contoso.com",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 2
            },
            {
              "address": "contoso.com.website-us-west-2.othercloud.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 2,
              "priority": 1
            },
            {
              "address": "contoso1.azurewebsites.net",
              "httpPort": 80,
              "httpsPort": 443,
              "enabledState": "Enabled",
              "weight": 1,
              "priority": 1
            }
          ],
          "loadBalancingSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/loadBalancingSettings/loadBalancingSettings1"
          },
          "healthProbeSettings": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/healthProbeSettings/healthProbeSettings1"
          }
        }
      }
    ],
    "frontendEndpoints": [
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/frontendEndpoint1",
        "name": "frontendEndpoint1",
        "properties": {
          "hostName": "www.contoso.com",
          "sessionAffinityEnabledState": "Enabled",
          "sessionAffinityTtlSeconds": 60,
          "webApplicationFirewallPolicyLink": {
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoorWebApplicationFirewallPolicies/policy1"
          }
        }
      },
      {
        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/frontDoors/frontDoor1/frontendEndpoints/default",
        "name": "default",
        "properties": {
          "hostName": "frontDoor1.azurefd.net"
        }
      }
    ],
    "backendPoolsSettings": {
      "enforceCertificateNameCheck": "Enabled",
      "sendRecvTimeoutSeconds": 60
    },
    "enabledState": "Enabled",
    "resourceState": "Creating",
    "provisioningState": "Provisioning",
    "cname": "frontDoor1.azurefd.net"
  }
}

Définitions

Nom	Description
Backend	Adresse principale d’un équilibreur de charge frontDoor.
backendEnabledState	Indique si vous voulez activer l’utilisation de ce backend. Les valeurs autorisées sont « Enabled » ou « Disabled »
BackendPool	Un pool back-end est une collection de back-ends qui peuvent être routés vers.
BackendPoolsSettings	Paramètres qui s’appliquent à tous les pools principaux.
CacheConfiguration	Paramètres de mise en cache pour un itinéraire de type mise en cache. Pour désactiver la mise en cache, ne fournissez pas d’objet cacheConfiguration.
CustomHttpsConfiguration	Paramètres Https pour un domaine
CustomHttpsProvisioningState	Provisionnement status de https personnalisé du point de terminaison frontal.
CustomHttpsProvisioningSubstate	Le sous-état d’approvisionnement montre la progression du processus d’activation/désactivation HTTPS personnalisé étape par étape.
DynamicCompressionEnabled	Indique s’il faut utiliser la compression dynamique pour le contenu mis en cache
enforceCertificateNameCheckEnabledState	Indique s’il faut appliquer le nom du certificat case activée sur les requêtes HTTPS à tous les pools back-ends. Aucun effet sur les requêtes non HTTPS.
ErrorResponse	La réponse d’erreur indique que le service Front Door n’est pas en mesure de traiter la demande entrante. La raison est fournie dans le message d’erreur.
ForwardingConfiguration	Décrit l’itinéraire de transfert.
FrontDoor	Front Door représente une collection de points de terminaison back-end à acheminer le trafic avec des règles qui spécifient la façon dont le trafic y est envoyé.
FrontDoorCertificateSource	Définit la source du certificat SSL
FrontDoorCertificateType	Définit le type du certificat utilisé pour sécuriser les connexions à un point de terminaison frontal
FrontDoorEnabledState	État opérationnel de l’équilibreur de charge Front Door. Les valeurs autorisées sont « Enabled » ou « Disabled »
FrontDoorForwardingProtocol	Protocole utilisé par cette règle pour transférer le trafic vers les back-ends.
FrontDoorHealthProbeMethod	Configure la méthode HTTP à utiliser pour sonder les back-ends définis sous backendPools.
FrontDoorProtocol	Schémas de protocole à mettre en correspondance pour cette règle
FrontDoorQuery	Traitement des termes de requête d’URL lors de la formation de la clé de cache.
FrontDoorRedirectProtocol	Protocole de la destination vers laquelle le trafic est redirigé
FrontDoorRedirectType	Type de redirection utilisé par la règle lors de la redirection du trafic.
FrontDoorResourceState	Ressource status de la sous-ressource Front Door ou Front Door.
FrontDoorTlsProtocolType	Définit le protocole d’extension TLS utilisé pour la remise sécurisée
FrontendEndpoint	Point de terminaison frontal utilisé pour le routage.
HealthProbeEnabled	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.
HealthProbeSettingsModel	Paramètres d’équilibrage de charge pour un pool back-end
LoadBalancingSettingsModel	Paramètres d’équilibrage de charge pour un pool back-end
MinimumTLSVersion	Version TLS minimale requise par les clients pour établir une liaison SSL avec Front Door.
RedirectConfiguration	Décrit l’itinéraire de redirection.
RoutingRule	Une règle de routage représente une spécification du trafic à traiter et où l’envoyer, ainsi que les informations de sonde d’intégrité.
routingRuleEnabledState	Indique s’il faut activer l’utilisation de cette route. Les valeurs autorisées sont « Enabled » ou « Disabled »
SessionAffinityEnabledState	Indique s’il faut, ou non, autoriser l’affinité de session sur cet hôte. Les options valides sont « Activé » ou « Désactivé »
SubResource	Référence à une autre sous-ressource.
Vault	Coffre de clés contenant le certificat SSL
WebApplicationFirewallPolicyLink	Définit la stratégie de Web Application Firewall pour chaque hôte (le cas échéant)

Backend

Adresse principale d’un équilibreur de charge frontDoor.

Nom	Type	Description
address	string	Emplacement du backend (adresse IP ou nom de domaine complet)
backendHostHeader	string	Valeur à utiliser comme en-tête d’hôte envoyé au backend. S’il est vide ou non spécifié, il s’agit par défaut de l’hôte entrant.
enabledState	backendEnabledState	Indique si vous voulez activer l’utilisation de ce backend. Les valeurs autorisées sont « Enabled » ou « Disabled »
httpPort	integer	Numéro du port TCP HTTP. Doit être compris entre 1 et 65535.
httpsPort	integer	Numéro du port TCP HTTPS. Doit être compris entre 1 et 65535.
priority	integer	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 serveur principal de priorité inférieure est sain.
weight	integer	Poids de ce point de terminaison à des fins d’équilibrage de charge.

backendEnabledState

Indique si vous voulez activer l’utilisation de ce backend. Les valeurs autorisées sont « Enabled » ou « Disabled »

Nom	Type	Description
Disabled	string
Enabled	string

BackendPool

Un pool back-end est une collection de back-ends qui peuvent être routés vers.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.backends	Backend[]	Ensemble de back-ends pour ce pool
properties.healthProbeSettings	SubResource	Paramètres de sonde d’intégrité L7 pour un pool principal
properties.loadBalancingSettings	SubResource	Paramètres d’équilibrage de charge pour un pool back-end
properties.resourceState	FrontDoorResourceState	Ressource status de la sous-ressource Front Door ou Front Door. Status de ressources.
type	string	Type de ressource.

BackendPoolsSettings

Paramètres qui s’appliquent à tous les pools principaux.

Nom	Type	Valeur par défaut	Description
enforceCertificateNameCheck	enforceCertificateNameCheckEnabledState	Enabled	S’il faut appliquer le nom de certificat case activée sur les requêtes HTTPS à tous les pools back-ends. Aucun effet sur les requêtes non HTTPS.
sendRecvTimeoutSeconds	integer		Envoyez et recevez un délai d’attente lors du transfert de la demande vers le back-end. Lorsque le délai d’expiration est atteint, la demande échoue et retourne.

CacheConfiguration

Paramètres de mise en cache pour un itinéraire de type mise en cache. Pour désactiver la mise en cache, ne fournissez pas d’objet cacheConfiguration.

Nom	Type	Description
dynamicCompression	DynamicCompressionEnabled	Indique s’il faut utiliser la compression dynamique pour le contenu mis en cache
queryParameterStripDirective	FrontDoorQuery	Traitement des termes de requête d’URL lors de la formation de la clé de cache.

CustomHttpsConfiguration

Paramètres Https pour un domaine

Nom	Type	Description
certificateSource	FrontDoorCertificateSource	Définit la source du certificat SSL
frontDoorCertificateSourceParameters.certificateType	FrontDoorCertificateType	Définit le type du certificat utilisé pour sécuriser les connexions à un point de terminaison frontal
keyVaultCertificateSourceParameters.secretName	string	Nom du secret Key Vault représentant le certificat PFX complet
keyVaultCertificateSourceParameters.secretVersion	string	Version du secret Key Vault représentant le certificat PFX complet
keyVaultCertificateSourceParameters.vault	Vault	Coffre de clés contenant le certificat SSL
minimumTlsVersion	MinimumTLSVersion	Version TLS minimale requise par les clients pour établir une liaison SSL avec Front Door.
protocolType	FrontDoorTlsProtocolType	Définit le protocole d’extension TLS utilisé pour la remise sécurisée

CustomHttpsProvisioningState

Provisionnement status de https personnalisé du point de terminaison frontal.

Nom	Type	Description
Disabled	string
Disabling	string
Enabled	string
Enabling	string
Failed	string

CustomHttpsProvisioningSubstate

Le sous-état d’approvisionnement montre la progression du processus d’activation/désactivation HTTPS personnalisé étape par étape.

Nom	Type	Description
CertificateDeleted	string
CertificateDeployed	string
DeletingCertificate	string
DeployingCertificate	string
DomainControlValidationRequestApproved	string
DomainControlValidationRequestRejected	string
DomainControlValidationRequestTimedOut	string
IssuingCertificate	string
PendingDomainControlValidationREquestApproval	string
SubmittingDomainControlValidationRequest	string

DynamicCompressionEnabled

Indique s’il faut utiliser la compression dynamique pour le contenu mis en cache

Nom	Type	Description
Disabled	string
Enabled	string

enforceCertificateNameCheckEnabledState

Indique s’il faut appliquer le nom du certificat case activée sur les requêtes HTTPS à tous les pools back-ends. Aucun effet sur les requêtes non HTTPS.

Nom	Type	Description
Disabled	string
Enabled	string

ErrorResponse

La réponse d’erreur indique que le service Front Door n’est pas en mesure de traiter la demande entrante. La raison est fournie dans le message d’erreur.

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d’erreur indiquant la raison de l’échec de l’opération.

ForwardingConfiguration

Décrit l’itinéraire de transfert.

Nom	Type	Description
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration
backendPool	SubResource	Référence au BackendPool vers lequel cette règle achemine.
cacheConfiguration	CacheConfiguration	Configuration de mise en cache associée à cette règle.
customForwardingPath	string	Chemin d’accès personnalisé utilisé pour réécrire les chemins d’accès aux ressources correspondant à cette règle. Laissez cette option vide pour utiliser le chemin entrant.
forwardingProtocol	FrontDoorForwardingProtocol	Protocole utilisé par cette règle pour transférer le trafic vers les back-ends.

FrontDoor

Front Door représente une collection de points de terminaison back-end à acheminer le trafic avec des règles qui spécifient la façon dont le trafic y est envoyé.

Nom	Type	Description
id	string	ID de la ressource
location	string	Emplacement de la ressource.
name	string	Nom de la ressource.
properties.backendPools	BackendPool[]	Pools back-end disponibles pour les règles de routage.
properties.backendPoolsSettings	BackendPoolsSettings	Paramètres de tous les back-endsPools
properties.cname	string	Hôte pour lequel chaque frontendEndpoint doit CNAME.
properties.enabledState	FrontDoorEnabledState	État opérationnel de l’équilibreur de charge Front Door. Les valeurs autorisées sont « Enabled » ou « Disabled »
properties.friendlyName	string	Un nom convivial pour la porte d’entrée
properties.frontendEndpoints	FrontendEndpoint[]	Points de terminaison front-end disponibles pour les règles de routage.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Paramètres de sonde d’intégrité associés à cette instance Front Door.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Paramètres d’équilibrage de charge associés à cette instance Front Door.
properties.provisioningState	string	État d’approvisionnement de la porte d’entrée.
properties.resourceState	FrontDoorResourceState	Ressource status de la sous-ressource Front Door ou Front Door. Status de ressources de la porte d’entrée.
properties.routingRules	RoutingRule[]	Règles de routage associées à cette porte d’entrée.
tags	object	Balises de ressource.
type	string	Type de ressource.

FrontDoorCertificateSource

Définit la source du certificat SSL

Nom	Type	Description
AzureKeyVault	string
FrontDoor	string

FrontDoorCertificateType

Définit le type du certificat utilisé pour sécuriser les connexions à un point de terminaison frontal

Nom	Type	Description
Dedicated	string

FrontDoorEnabledState

État opérationnel de l’équilibreur de charge Front Door. Les valeurs autorisées sont « Enabled » ou « Disabled »

Nom	Type	Description
Disabled	string
Enabled	string

FrontDoorForwardingProtocol

Protocole utilisé par cette règle pour transférer le trafic vers les back-ends.

Nom	Type	Description
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorHealthProbeMethod

Configure la méthode HTTP à utiliser pour sonder les back-ends définis sous backendPools.

Nom	Type	Description
GET	string
HEAD	string

FrontDoorProtocol

Schémas de protocole à mettre en correspondance pour cette règle

Nom	Type	Description
Http	string
Https	string

FrontDoorQuery

Traitement des termes de requête d’URL lors de la formation de la clé de cache.

Nom	Type	Description
StripAll	string
StripNone	string

FrontDoorRedirectProtocol

Protocole de la destination vers laquelle le trafic est redirigé

Nom	Type	Description
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorRedirectType

Type de redirection utilisé par la règle lors de la redirection du trafic.

Nom	Type	Description
Found	string
Moved	string
PermanentRedirect	string
TemporaryRedirect	string

FrontDoorResourceState

Ressource status de la sous-ressource Front Door ou Front Door.

Nom	Type	Description
Creating	string
Deleting	string
Disabled	string
Disabling	string
Enabled	string
Enabling	string

FrontDoorTlsProtocolType

Définit le protocole d’extension TLS utilisé pour la remise sécurisée

Nom	Type	Description
ServerNameIndication	string

FrontendEndpoint

Point de terminaison frontal utilisé pour le routage.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.customHttpsConfiguration	CustomHttpsConfiguration	Configuration spécifiant comment activer HTTPS
properties.customHttpsProvisioningState	CustomHttpsProvisioningState	Approvisionnement status du https personnalisé du frontendEndpoint.
properties.customHttpsProvisioningSubstate	CustomHttpsProvisioningSubstate	Le sous-état d’approvisionnement montre la progression du processus d’activation/désactivation https personnalisé étape par étape.
properties.hostName	string	Nom d’hôte du point de terminaison frontend (frontendEndpoint). Doit être un nom de domaine.
properties.resourceState	FrontDoorResourceState	Ressource status de la sous-ressource Front Door ou Front Door. Status de ressources.
properties.sessionAffinityEnabledState	SessionAffinityEnabledState	Indique s’il faut, ou non, autoriser l’affinité de session sur cet hôte. Les options valides sont « Enabled » ou « Disabled »
properties.sessionAffinityTtlSeconds	integer	INUTILISÉS. Ce champ sera ignoré. Durée de vie (TTL) à utiliser, en secondes, pour l’affinité de session, le cas échéant.
properties.webApplicationFirewallPolicyLink	WebApplicationFirewallPolicyLink	Définit la stratégie Web Application Firewall pour chaque hôte (le cas échéant)
type	string	Type de ressource.

HealthProbeEnabled

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.

Nom	Type	Description
Disabled	string
Enabled	string

HealthProbeSettingsModel

Paramètres d’équilibrage de charge pour un pool back-end

Nom	Type	Valeur par défaut	Description
id	string		ID de la ressource
name	string		Nom de la ressource.
properties.enabledState	HealthProbeEnabled		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.
properties.healthProbeMethod	FrontDoorHealthProbeMethod	HEAD	Configure la méthode HTTP à utiliser pour sonder les back-ends définis sous backendPools.
properties.intervalInSeconds	integer		Nombre de secondes entre les sondes d’intégrité.
properties.path	string		Chemin à utiliser pour la sonde d’intégrité. La valeur par défaut est /
properties.protocol	FrontDoorProtocol		Schéma de protocole à utiliser pour cette sonde
properties.resourceState	FrontDoorResourceState		Ressource status de la sous-ressource Front Door ou Front Door. Status de ressources.
type	string		Type de ressource.

LoadBalancingSettingsModel

Paramètres d’équilibrage de charge pour un pool back-end

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.additionalLatencyMilliseconds	integer	Latence supplémentaire en millisecondes pour que les sondes tombent dans le compartiment de latence le plus faible
properties.resourceState	FrontDoorResourceState	Ressource status de la sous-ressource Front Door ou Front Door. Status de ressources.
properties.sampleSize	integer	Nombre d’exemples à prendre en compte pour les décisions d’équilibrage de charge
properties.successfulSamplesRequired	integer	Nombre d’échantillons dans la période d’échantillonnage qui doivent réussir
type	string	Type de ressource.

MinimumTLSVersion

Version TLS minimale requise par les clients pour établir une liaison SSL avec Front Door.

Nom	Type	Description
1.0	string
1.2	string

RedirectConfiguration

Décrit l’itinéraire de redirection.

Nom	Type	Description
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration
customFragment	string	Fragment à ajouter à l’URL de redirection. Fragment est la partie de l’URL qui se trouve après #. N’incluez pas le #.
customHost	string	Hôte à rediriger. Laissez vide pour utiliser l’hôte entrant comme hôte de destination.
customPath	string	Chemin d’accès complet à rediriger. Le chemin d’accès ne peut pas être vide et doit commencer par /. Laissez vide pour utiliser le chemin d’accès entrant comme chemin de destination.
customQueryString	string	Ensemble de chaînes de requête à placer dans l’URL de redirection. La définition de cette valeur remplacerait toute chaîne de requête existante ; Laissez vide pour conserver la chaîne de requête entrante. La chaîne de requête doit être au format = . Le premier ? et & seront ajoutés automatiquement, ne les incluez pas à l’avant, mais séparez plusieurs chaînes de requête avec &.
redirectProtocol	FrontDoorRedirectProtocol	Protocole de la destination vers laquelle le trafic est redirigé
redirectType	FrontDoorRedirectType	Type de redirection utilisé par la règle lors de la redirection du trafic.

RoutingRule

Une règle de routage représente une spécification du trafic à traiter et où l’envoyer, ainsi que les informations de sonde d’intégrité.

Nom	Type	Description
id	string	ID de la ressource
name	string	Nom de la ressource.
properties.acceptedProtocols	FrontDoorProtocol[]	Schémas de protocole à mettre en correspondance pour cette règle
properties.enabledState	routingRuleEnabledState	Indique s’il faut activer l’utilisation de cette route. Les valeurs autorisées sont « Enabled » ou « Disabled »
properties.frontendEndpoints	SubResource[]	Points de terminaison front-end associés à cette règle
properties.patternsToMatch	string[]	Modèles d’itinéraire de la règle.
properties.resourceState	FrontDoorResourceState	Ressource status de la sous-ressource Front Door ou Front Door. Status de ressources.
properties.routeConfiguration	RouteConfiguration: ForwardingConfiguration RedirectConfiguration	Référence à la configuration de routage.
type	string	Type de ressource.

routingRuleEnabledState

Indique s’il faut activer l’utilisation de cette route. Les valeurs autorisées sont « Enabled » ou « Disabled »

Nom	Type	Description
Disabled	string
Enabled	string

SessionAffinityEnabledState

Indique s’il faut, ou non, autoriser l’affinité de session sur cet hôte. Les options valides sont « Activé » ou « Désactivé »

Nom	Type	Description
Disabled	string
Enabled	string

SubResource

Référence à une autre sous-ressource.

Nom	Type	Description
id	string	ID de la ressource

Vault

Coffre de clés contenant le certificat SSL

Nom	Type	Description
id	string	ID de la ressource

WebApplicationFirewallPolicyLink

Définit la stratégie de Web Application Firewall pour chaque hôte (le cas échéant)

Nom	Type	Description
id	string	ID de la ressource

Partager via

Front Doors - Create Or Update

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

Create or update specific Front Door

Exemple de requête

Exemple de réponse

Définitions

Backend

backendEnabledState

BackendPool

BackendPoolsSettings

CacheConfiguration

CustomHttpsConfiguration

CustomHttpsProvisioningState

CustomHttpsProvisioningSubstate

DynamicCompressionEnabled

enforceCertificateNameCheckEnabledState

ErrorResponse

ForwardingConfiguration

FrontDoor

FrontDoorCertificateSource

FrontDoorCertificateType

FrontDoorEnabledState

FrontDoorForwardingProtocol

FrontDoorHealthProbeMethod

FrontDoorProtocol

FrontDoorQuery

FrontDoorRedirectProtocol

FrontDoorRedirectType

FrontDoorResourceState

FrontDoorTlsProtocolType

FrontendEndpoint

HealthProbeEnabled

HealthProbeSettingsModel

LoadBalancingSettingsModel

MinimumTLSVersion

RedirectConfiguration

RoutingRule

routingRuleEnabledState

SessionAffinityEnabledState

SubResource

Vault

WebApplicationFirewallPolicyLink

Ressources supplémentaires