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 minLength: 5 maxLength: 64 pattern: ^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$	Nom de la porte d’entrée qui est globalement unique.
resourceGroupName	path	True	string minLength: 1 maxLength: 80 pattern: ^[a-zA-Z0-9_\-\.]*[^\.]$	Nom du groupe de ressources dans l’abonnement Azure.
subscriptionId	path	True	string	Informations d’identification de l’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI de chaque appel de service.
api-version	query	True	string	Version de l’API cliente.

Corps de la demande

Nom	Type	Description
location	string	Emplacement des ressources.
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 le frontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Points de terminaison frontaux 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	D’ACCORD. La demande a réussi.
201 Created	FrontDoor	Créé. La demande a été remplie et une nouvelle porte d’entrée a été créée.
202 Accepted	FrontDoor	Accepté. La demande a été acceptée pour le traitement et l’opération se termine de manière asynchrone.
Other Status Codes	ErrorResponse	Réponse d’erreur Front Door décrivant pourquoi l’opération a échoué.

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 s’il faut activer l’utilisation de ce back-end. Les valeurs autorisées sont « Enabled » ou « Disabled »
BackendPool	Un pool de back-ends 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 d’un itinéraire de type de mise en cache. Pour désactiver la mise en cache, ne fournissez pas d’objet cacheConfiguration.
CustomHttpsConfiguration	Paramètres Https pour un domaine
CustomHttpsProvisioningState	État d’approvisionnement du protocole Https personnalisé du serveur frontalEndpoint.
CustomHttpsProvisioningSubstate	L’état de sous-état d’approvisionnement indique 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 la vérification du nom de certificat sur les requêtes HTTPS à tous les pools principaux. 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 requête 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 principaux pour acheminer le trafic avec des règles qui spécifient la façon dont le trafic est envoyé.
FrontDoorCertificateSource	Définit la source du certificat SSL
FrontDoorCertificateType	Définit le type du certificat utilisé pour les connexions sécurisées à un serveur frontendpoint
FrontDoorEnabledState	État opérationnel de l’équilibreur de charge Front Door. Les valeurs autorisées sont « Enabled » ou « Disabled »
FrontDoorForwardingProtocol	Protocole que cette règle utilisera lors du transfert du trafic vers des 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	État des ressources 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 principal
LoadBalancingSettingsModel	Paramètres d’équilibrage de charge pour un pool principal
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 à l’endroit où l’envoyer, ainsi que les informations de sonde d’intégrité.
routingRuleEnabledState	Indique s’il faut activer l’utilisation de cette règle. Les valeurs autorisées sont « Enabled » ou « Disabled »
SessionAffinityEnabledState	Indique s’il faut 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 pare-feu d’applications web pour chaque hôte (le cas échéant)

Backend

Object

Adresse principale d’un équilibreur de charge frontDoor.

Nom	Type	Description
address	string	Emplacement du serveur principal (adresse IP ou nom de domaine complet)
backendHostHeader	string	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.
enabledState	backendEnabledState	Indique s’il faut activer l’utilisation de ce back-end. Les valeurs autorisées sont « Enabled » ou « Disabled »
httpPort	integer minimum: 1 maximum: 65535 exclusiveMinimum: False exclusiveMaximum: False	Numéro de port TCP HTTP. Doit être compris entre 1 et 65535.
httpsPort	integer minimum: 1 maximum: 65535 exclusiveMinimum: False exclusiveMaximum: False	Numéro de port TCP HTTPS. Doit être compris entre 1 et 65535.
priority	integer minimum: 1 maximum: 5	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.
weight	integer minimum: 1 maximum: 1000	Poids de ce point de terminaison à des fins d’équilibrage de charge.

backendEnabledState

Énumération

Indique s’il faut activer l’utilisation de ce back-end. Les valeurs autorisées sont « Enabled » ou « Disabled »

Valeur	Description
Disabled
Enabled

BackendPool

Object

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

Nom	Type	Description
id	string	ID de 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 principal
properties.resourceState	FrontDoorResourceState	État des ressources de la sous-ressource Front Door ou Front Door. État de la ressource.
type	string	Type de ressource.

BackendPoolsSettings

Object

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

Nom	Type	Valeur par défaut	Description
enforceCertificateNameCheck	enforceCertificateNameCheckEnabledState	Enabled	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.
sendRecvTimeoutSeconds	integer minimum: 16 exclusiveMinimum: False		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.

CacheConfiguration

Object

Paramètres de mise en cache d’un itinéraire de type de 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

Object

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 les connexions sécurisées à un serveur frontendpoint
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

Énumération

État d’approvisionnement du protocole Https personnalisé du serveur frontalEndpoint.

Valeur	Description
Disabled
Disabling
Enabled
Enabling
Failed

CustomHttpsProvisioningSubstate

Énumération

L’état de sous-état d’approvisionnement indique la progression du processus d’activation/désactivation HTTPS personnalisé étape par étape.

Valeur	Description
CertificateDeleted
CertificateDeployed
DeletingCertificate
DeployingCertificate
DomainControlValidationRequestApproved
DomainControlValidationRequestRejected
DomainControlValidationRequestTimedOut
IssuingCertificate
PendingDomainControlValidationREquestApproval
SubmittingDomainControlValidationRequest

DynamicCompressionEnabled

Énumération

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

Valeur	Description
Disabled
Enabled

enforceCertificateNameCheckEnabledState

Énumération

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.

Valeur	Description
Disabled
Enabled

ErrorResponse

Object

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

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d’erreur indiquant pourquoi l’opération a échoué.

ForwardingConfiguration

Object

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 est acheminée.
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 de ressources mis en correspondance par cette règle. Laissez vide pour utiliser le chemin entrant.
forwardingProtocol	FrontDoorForwardingProtocol	Protocole que cette règle utilisera lors du transfert du trafic vers des back-ends.

FrontDoor

Object

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

Nom	Type	Description
id	string	ID de ressource.
location	string	Emplacement des ressources.
name	string	Nom 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.cname	string	L’hôte auquel chaque frontendEndpoint doit être 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 le frontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Points de terminaison frontaux 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	État des ressources de la sous-ressource Front Door ou Front Door. État des 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

Énumération

Définit la source du certificat SSL

Valeur	Description
AzureKeyVault
FrontDoor

FrontDoorCertificateType

Énumération

Définit le type du certificat utilisé pour les connexions sécurisées à un serveur frontendpoint

Valeur	Description
Dedicated

FrontDoorEnabledState

Énumération

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

Valeur	Description
Disabled
Enabled

FrontDoorForwardingProtocol

Énumération

Protocole que cette règle utilisera lors du transfert du trafic vers des back-ends.

Valeur	Description
HttpOnly
HttpsOnly
MatchRequest

FrontDoorHealthProbeMethod

Énumération

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

Valeur	Description
GET
HEAD

FrontDoorProtocol

Énumération

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

Valeur	Description
Http
Https

FrontDoorQuery

Énumération

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

Valeur	Description
StripAll
StripNone

FrontDoorRedirectProtocol

Énumération

Protocole de la destination vers laquelle le trafic est redirigé

Valeur	Description
HttpOnly
HttpsOnly
MatchRequest

FrontDoorRedirectType

Énumération

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

Valeur	Description
Found
Moved
PermanentRedirect
TemporaryRedirect

FrontDoorResourceState

Énumération

État des ressources de la sous-ressource Front Door ou Front Door.

Valeur	Description
Creating
Deleting
Disabled
Disabling
Enabled
Enabling

FrontDoorTlsProtocolType

Énumération

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

Valeur	Description
ServerNameIndication

FrontendEndpoint

Object

Point de terminaison frontal utilisé pour le routage.

Nom	Type	Description
id	string	ID de ressource.
name	string	Nom de la ressource.
properties.customHttpsConfiguration	CustomHttpsConfiguration	Configuration spécifiant comment activer HTTPS
properties.customHttpsProvisioningState	CustomHttpsProvisioningState	État d’approvisionnement du protocole Https personnalisé du serveur frontalEndpoint.
properties.customHttpsProvisioningSubstate	CustomHttpsProvisioningSubstate	L’état de sous-état d’approvisionnement indique la progression du processus d’activation/désactivation HTTPS personnalisé étape par étape.
properties.hostName	string	Nom d’hôte du frontendEndpoint. Doit être un nom de domaine.
properties.resourceState	FrontDoorResourceState	État des ressources de la sous-ressource Front Door ou Front Door. État de la ressource.
properties.sessionAffinityEnabledState	SessionAffinityEnabledState	Indique s’il faut autoriser l’affinité de session sur cet hôte. Les options valides sont « Activé » ou « Désactivé »
properties.sessionAffinityTtlSeconds	integer	INUTILISÉ. Ce champ est ignoré. Durée de vie à utiliser en secondes pour l’affinité de session, le cas échéant.
properties.webApplicationFirewallPolicyLink	WebApplicationFirewallPolicyLink	Définit la stratégie de pare-feu d’applications web pour chaque hôte (le cas échéant)
type	string	Type de ressource.

HealthProbeEnabled

Énumération

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.

Valeur	Description
Disabled
Enabled

HealthProbeSettingsModel

Object

Paramètres d’équilibrage de charge pour un pool principal

Nom	Type	Valeur par défaut	Description
id	string		ID de 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		État des ressources de la sous-ressource Front Door ou Front Door. État de la ressource.
type	string		Type de ressource.

LoadBalancingSettingsModel

Object

Paramètres d’équilibrage de charge pour un pool principal

Nom	Type	Description
id	string	ID de 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 bas
properties.resourceState	FrontDoorResourceState	État des ressources de la sous-ressource Front Door ou Front Door. État de la ressource.
properties.sampleSize	integer	Nombre d’exemples à prendre en compte pour les décisions d’équilibrage de charge
properties.successfulSamplesRequired	integer	Nombre d’échantillons au cours de la période d’échantillonnage qui doivent réussir
type	string	Type de ressource.

MinimumTLSVersion

Énumération

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

Valeur	Description
1.0
1.2

RedirectConfiguration

Object

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. Le fragment fait partie de l’URL qui vient 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 complet à rediriger. Le chemin d’accès ne peut pas être vide et doit commencer par /. Laissez vide pour utiliser le chemin 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 remplace 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 = . La première ? et & seront ajoutés automatiquement afin de ne pas les inclure dans le front, mais de séparer 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

Object

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

Nom	Type	Description
id	string	ID de 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 règle. Les valeurs autorisées sont « Enabled » ou « Disabled »
properties.frontendEndpoints	SubResource[]	Points de terminaison frontaux associés à cette règle
properties.patternsToMatch	string[]	Modèles d’itinéraire de la règle.
properties.resourceState	FrontDoorResourceState	État des ressources de la sous-ressource Front Door ou Front Door. État de la ressource.
properties.routeConfiguration	RouteConfiguration: ForwardingConfiguration RedirectConfiguration	Référence à la configuration du routage.
type	string	Type de ressource.

routingRuleEnabledState

Énumération

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

Valeur	Description
Disabled
Enabled

SessionAffinityEnabledState

Énumération

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

Valeur	Description
Disabled
Enabled

SubResource

Object

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

Nom	Type	Description
id	string	ID de ressource.

Vault

Object

Coffre de clés contenant le certificat SSL

Nom	Type	Description
id	string	ID de ressource.

WebApplicationFirewallPolicyLink

Object

Définit la stratégie de pare-feu d’applications web pour chaque hôte (le cas échéant)

Nom	Type	Description
id	string	ID de 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