Front Doors - Create Or Update

Referencia

Servicio:: Front Door Service

Versión de la API:: 2019-05-01

Crea una nueva instancia de Front Door con un nombre de Front Door en la suscripción y el grupo de recursos especificados.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
frontDoorName	path	True	string	Nombre de Front Door que es único globalmente. Patrón de Regex: `^[a-zA-Z0-9]+([-a-zA-Z0-9]?[a-zA-Z0-9])*$`
resourceGroupName	path	True	string	Nombre del grupo de recursos dentro de la suscripción de Azure. Patrón de Regex: `^[a-zA-Z0-9_\-\.]*[^\.]$`
subscriptionId	path	True	string	Las credenciales de suscripción que identifican de forma exclusiva la suscripción a Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio.
api-version	query	True	string	Versión de API del cliente.

Cuerpo de la solicitud

Nombre	Tipo	Description
location	string	Ubicación del recurso
properties.backendPools	BackendPool[]	Grupos de back-end disponibles para las reglas de enrutamiento.
properties.backendPoolsSettings	BackendPoolsSettings	Configuración de todos los servidores back-endPool
properties.enabledState	FrontDoorEnabledState	Estado operativo del equilibrador de carga de Front Door. Los valores permitidos son "Enabled" o "Disabled"
properties.friendlyName	string	Un nombre descriptivo para frontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Puntos de conexión de front-end disponibles para las reglas de enrutamiento.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Configuración del sondeo de mantenimiento asociada con esta instancia de Front Door.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Configuración de equilibrio de carga asociada con esta instancia de Front Door.
properties.routingRules	RoutingRule[]	Reglas de enrutamiento asociadas a esta instancia de Front Door.
tags	object	Etiquetas del recurso.

Respuestas

Nombre	Tipo	Description
200 OK	FrontDoor	Aceptar. La solicitud se ha realizado correctamente.
201 Created	FrontDoor	Creado. Se ha cumplido la solicitud y se ha creado una nueva instancia de Front Door.
202 Accepted	FrontDoor	Accepted. La solicitud se ha aceptado para su procesamiento y la operación se completará de forma asincrónica.
Other Status Codes	ErrorResponse	Respuesta de error de Front Door que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

Create or update specific Front Door

Solicitud de ejemplo

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"
  }
}

Respuesta de muestra

status code:: 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"
  }
}

status code:: 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"
  }
}

status code:: 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"
  }
}

Definiciones

Nombre	Description
Backend	Dirección de back-end de un equilibrador de carga frontDoor.
backendEnabledState	Si desea habilitar el uso de este servidor back-end. Los valores permitidos son "Enabled" o "Disabled"
BackendPool	Un grupo de back-end es una colección de back-end a los que se puede enrutar.
BackendPoolsSettings	Configuración que se aplica a todos los grupos de back-end.
CacheConfiguration	Configuración de almacenamiento en caché para una ruta de tipo de almacenamiento en caché. Para deshabilitar el almacenamiento en caché, no proporcione un objeto cacheConfiguration.
CustomHttpsConfiguration	Configuración https para un dominio
CustomHttpsProvisioningState	Estado de aprovisionamiento de Https personalizado del frontendEndpoint.
CustomHttpsProvisioningSubstate	El subestado de aprovisionamiento muestra el progreso de la habilitación o deshabilitación de HTTPS personalizado paso a paso.
DynamicCompressionEnabled	Si se debe usar la compresión dinámica para el contenido almacenado en caché
enforceCertificateNameCheckEnabledState	Si se debe aplicar la comprobación del nombre del certificado en las solicitudes HTTPS a todos los grupos de back-end. No hay ningún efecto en las solicitudes que no son HTTPS.
ErrorResponse	La respuesta de error indica que el servicio Front Door no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error.
ForwardingConfiguration	Describe la ruta de reenvío.
FrontDoor	Front Door representa una colección de puntos de conexión de back-end para enrutar el tráfico a junto con reglas que especifican cómo se envía el tráfico allí.
FrontDoorCertificateSource	Define el origen del certificado SSL.
FrontDoorCertificateType	Define el tipo del certificado usado para conexiones seguras a un frontendEndpoint.
FrontDoorEnabledState	Estado operativo del equilibrador de carga de Front Door. Los valores permitidos son "Enabled" o "Disabled"
FrontDoorForwardingProtocol	Protocolo que usará esta regla al reenviar el tráfico a los servidores back-end.
FrontDoorHealthProbeMethod	Configura qué método HTTP se va a usar para sondear los back-end definidos en backendPools.
FrontDoorProtocol	Esquemas de protocolo para que coincidan con esta regla
FrontDoorQuery	Tratamiento de los términos de consulta de dirección URL al formar la clave de caché.
FrontDoorRedirectProtocol	Protocolo del destino al que se redirige el tráfico.
FrontDoorRedirectType	El tipo de redireccionamiento que usará la regla al redirigir el tráfico.
FrontDoorResourceState	Estado del recurso del subrecurso de Front Door o Front Door.
FrontDoorTlsProtocolType	Define el protocolo de extensión TLS que se usa para la entrega segura.
FrontendEndpoint	Un punto de conexión de front-end que se usa para el enrutamiento.
HealthProbeEnabled	Si se habilitan los sondeos de estado que se van a realizar en back-end definidos en backendPools. Los sondeos de estado solo se pueden deshabilitar si hay un único back-end habilitado en un único grupo de back-end habilitado.
HealthProbeSettingsModel	Configuración de equilibrio de carga para un grupo de back-end
LoadBalancingSettingsModel	Configuración de equilibrio de carga para un grupo de back-end
MinimumTLSVersion	La versión mínima de TLS necesaria de los clientes para establecer un protocolo de enlace SSL con Front Door.
RedirectConfiguration	Describe la ruta de redirección.
RoutingRule	Una regla de enrutamiento representa una especificación para que el tráfico trate y dónde enviarlo, junto con la información del sondeo de estado.
routingRuleEnabledState	Si desea habilitar el uso de esta regla. Los valores permitidos son "Enabled" o "Disabled"
SessionAffinityEnabledState	Si desea permitir la afinidad de sesiones en este host. Las opciones válidas son "Habilitado" o "Deshabilitado".
SubResource	Referencia a otro subrecurso.
Vault	La instancia de Key Vault que contiene el certificado SSL
WebApplicationFirewallPolicyLink	Define la directiva de Web Application Firewall para cada host (si procede)

Backend

Dirección de back-end de un equilibrador de carga frontDoor.

Nombre	Tipo	Description
address	string	Ubicación del servidor back-end (dirección IP o FQDN)
backendHostHeader	string	Valor que se usará como el encabezado de host que se envía al servidor back-end. Si está en blanco o no especificado, este valor predeterminado es el host entrante.
enabledState	backendEnabledState	Si desea habilitar el uso de este servidor back-end. Los valores permitidos son "Enabled" o "Disabled"
httpPort	integer	Número de puerto TCP de HTTP. Debe estar entre 1 y 65535.
httpsPort	integer	Número de puerto TCP de HTTPS. Debe estar entre 1 y 65535.
priority	integer	Prioridad que se usará para el equilibrio de carga. Las prioridades más altas no se usarán para el equilibrio de carga si algún back-end de prioridad inferior es correcto.
weight	integer	Peso de este punto de conexión con fines de equilibrio de carga.

backendEnabledState

Si desea habilitar el uso de este servidor back-end. Los valores permitidos son "Enabled" o "Disabled"

Nombre	Tipo	Description
Disabled	string
Enabled	string

BackendPool

Un grupo de back-end es una colección de back-end a los que se puede enrutar.

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.backends	Backend[]	Conjunto de back-end para este grupo
properties.healthProbeSettings	SubResource	Configuración del sondeo de estado L7 para un grupo de back-end
properties.loadBalancingSettings	SubResource	Configuración de equilibrio de carga para un grupo de back-end
properties.resourceState	FrontDoorResourceState	Estado del recurso del subrecurso de Front Door o Front Door. Estado del recurso.
type	string	Tipo de recurso.

BackendPoolsSettings

Configuración que se aplica a todos los grupos de back-end.

Nombre	Tipo	Valor predeterminado	Description
enforceCertificateNameCheck	enforceCertificateNameCheckEnabledState	Enabled	Si se debe aplicar la comprobación de nombres de certificado en las solicitudes HTTPS a todos los grupos de back-end. No hay ningún efecto en las solicitudes que no son HTTPS.
sendRecvTimeoutSeconds	integer		Enviar y recibir el tiempo de espera en la solicitud de reenvío al back-end. Cuando se alcanza el tiempo de espera, se produce un error en la solicitud y se devuelve.

CacheConfiguration

Configuración de almacenamiento en caché para una ruta de tipo de almacenamiento en caché. Para deshabilitar el almacenamiento en caché, no proporcione un objeto cacheConfiguration.

Nombre	Tipo	Description
dynamicCompression	DynamicCompressionEnabled	Si se debe usar la compresión dinámica para el contenido almacenado en caché
queryParameterStripDirective	FrontDoorQuery	Tratamiento de los términos de consulta de dirección URL al formar la clave de caché.

CustomHttpsConfiguration

Configuración https para un dominio

Nombre	Tipo	Description
certificateSource	FrontDoorCertificateSource	Define el origen del certificado SSL.
frontDoorCertificateSourceParameters.certificateType	FrontDoorCertificateType	Define el tipo del certificado usado para conexiones seguras a un frontendEndpoint.
keyVaultCertificateSourceParameters.secretName	string	El nombre del secreto de Key Vault que representa el certificado PFX completo
keyVaultCertificateSourceParameters.secretVersion	string	La versión del secreto de Key Vault que representa el certificado PFX completo
keyVaultCertificateSourceParameters.vault	Vault	La instancia de Key Vault que contiene el certificado SSL
minimumTlsVersion	MinimumTLSVersion	La versión mínima de TLS necesaria de los clientes para establecer un protocolo de enlace SSL con Front Door.
protocolType	FrontDoorTlsProtocolType	Define el protocolo de extensión TLS que se usa para la entrega segura.

CustomHttpsProvisioningState

Estado de aprovisionamiento de Https personalizado del frontendEndpoint.

Nombre	Tipo	Description
Disabled	string
Disabling	string
Enabled	string
Enabling	string
Failed	string

CustomHttpsProvisioningSubstate

El subestado de aprovisionamiento muestra el progreso de la habilitación o deshabilitación de HTTPS personalizado paso a paso.

Nombre	Tipo	Description
CertificateDeleted	string
CertificateDeployed	string
DeletingCertificate	string
DeployingCertificate	string
DomainControlValidationRequestApproved	string
DomainControlValidationRequestRejected	string
DomainControlValidationRequestTimedOut	string
IssuingCertificate	string
PendingDomainControlValidationREquestApproval	string
SubmittingDomainControlValidationRequest	string

DynamicCompressionEnabled

Si se debe usar la compresión dinámica para el contenido almacenado en caché

Nombre	Tipo	Description
Disabled	string
Enabled	string

enforceCertificateNameCheckEnabledState

Si se debe aplicar la comprobación del nombre del certificado en las solicitudes HTTPS a todos los grupos de back-end. No hay ningún efecto en las solicitudes que no son HTTPS.

Nombre	Tipo	Description
Disabled	string
Enabled	string

ErrorResponse

La respuesta de error indica que el servicio Front Door no puede procesar la solicitud entrante. El motivo se proporciona en el mensaje de error.

Nombre	Tipo	Description
code	string	Código de error.
message	string	Mensaje de error que indica por qué se produjo un error en la operación.

ForwardingConfiguration

Describe la ruta de reenvío.

Nombre	Tipo	Description
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorForwardingConfiguration
backendPool	SubResource	Referencia al objeto BackendPool al que se enruta esta regla.
cacheConfiguration	CacheConfiguration	Configuración de almacenamiento en caché asociada a esta regla.
customForwardingPath	string	Ruta de acceso personalizada que se usa para reescribir las rutas de acceso de recursos coincidentes con esta regla. Déjela en blanco para usar la ruta de acceso entrante.
forwardingProtocol	FrontDoorForwardingProtocol	Protocolo que usará esta regla al reenviar el tráfico a los servidores back-end.

FrontDoor

Front Door representa una colección de puntos de conexión de back-end para enrutar el tráfico a junto con reglas que especifican cómo se envía el tráfico allí.

Nombre	Tipo	Description
id	string	Identificador del recurso.
location	string	Ubicación del recurso
name	string	Nombre del recurso.
properties.backendPools	BackendPool[]	Grupos de back-end disponibles para las reglas de enrutamiento.
properties.backendPoolsSettings	BackendPoolsSettings	Configuración de todos los servidores back-endPool
properties.cname	string	Host al que cada frontendEndpoint debe ser CNAME.
properties.enabledState	FrontDoorEnabledState	Estado operativo del equilibrador de carga de Front Door. Los valores permitidos son "Enabled" o "Disabled"
properties.friendlyName	string	Un nombre descriptivo para frontDoor
properties.frontendEndpoints	FrontendEndpoint[]	Puntos de conexión de front-end disponibles para las reglas de enrutamiento.
properties.healthProbeSettings	HealthProbeSettingsModel[]	Configuración del sondeo de mantenimiento asociada con esta instancia de Front Door.
properties.loadBalancingSettings	LoadBalancingSettingsModel[]	Configuración de equilibrio de carga asociada con esta instancia de Front Door.
properties.provisioningState	string	Estado de aprovisionamiento de Front Door.
properties.resourceState	FrontDoorResourceState	Estado del recurso del subrecurso de Front Door o Front Door. Estado del recurso de Front Door.
properties.routingRules	RoutingRule[]	Reglas de enrutamiento asociadas a esta instancia de Front Door.
tags	object	Etiquetas del recurso.
type	string	Tipo de recurso.

FrontDoorCertificateSource

Define el origen del certificado SSL.

Nombre	Tipo	Description
AzureKeyVault	string
FrontDoor	string

FrontDoorCertificateType

Define el tipo del certificado usado para conexiones seguras a un frontendEndpoint.

Nombre	Tipo	Description
Dedicated	string

FrontDoorEnabledState

Estado operativo del equilibrador de carga de Front Door. Los valores permitidos son "Enabled" o "Disabled"

Nombre	Tipo	Description
Disabled	string
Enabled	string

FrontDoorForwardingProtocol

Protocolo que usará esta regla al reenviar el tráfico a los servidores back-end.

Nombre	Tipo	Description
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorHealthProbeMethod

Configura qué método HTTP se va a usar para sondear los back-end definidos en backendPools.

Nombre	Tipo	Description
GET	string
HEAD	string

FrontDoorProtocol

Esquemas de protocolo para que coincidan con esta regla

Nombre	Tipo	Description
Http	string
Https	string

FrontDoorQuery

Tratamiento de los términos de consulta de dirección URL al formar la clave de caché.

Nombre	Tipo	Description
StripAll	string
StripNone	string

FrontDoorRedirectProtocol

Protocolo del destino al que se redirige el tráfico.

Nombre	Tipo	Description
HttpOnly	string
HttpsOnly	string
MatchRequest	string

FrontDoorRedirectType

El tipo de redireccionamiento que usará la regla al redirigir el tráfico.

Nombre	Tipo	Description
Found	string
Moved	string
PermanentRedirect	string
TemporaryRedirect	string

FrontDoorResourceState

Estado del recurso del subrecurso de Front Door o Front Door.

Nombre	Tipo	Description
Creating	string
Deleting	string
Disabled	string
Disabling	string
Enabled	string
Enabling	string

FrontDoorTlsProtocolType

Define el protocolo de extensión TLS que se usa para la entrega segura.

Nombre	Tipo	Description
ServerNameIndication	string

FrontendEndpoint

Un punto de conexión de front-end que se usa para el enrutamiento.

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.customHttpsConfiguration	CustomHttpsConfiguration	Configuración que especifica cómo habilitar HTTPS
properties.customHttpsProvisioningState	CustomHttpsProvisioningState	Estado de aprovisionamiento de Https personalizado del frontendEndpoint.
properties.customHttpsProvisioningSubstate	CustomHttpsProvisioningSubstate	El substate de aprovisionamiento muestra el progreso de la habilitación o deshabilitación del proceso personalizado https paso a paso.
properties.hostName	string	El nombre de host de frontendEndpoint. Debe ser un nombre de dominio.
properties.resourceState	FrontDoorResourceState	Estado del recurso del subrecurso de Front Door o Front Door. Estado del recurso.
properties.sessionAffinityEnabledState	SessionAffinityEnabledState	Si desea permitir la afinidad de sesiones en este host. Las opciones válidas son "Enabled" o "Disabled"
properties.sessionAffinityTtlSeconds	integer	INUSITADO. Se omitirá este campo. El TTL para usar en segundos para la afinidad de sesiones, si corresponde.
properties.webApplicationFirewallPolicyLink	WebApplicationFirewallPolicyLink	Define la directiva de Web Application Firewall para cada host (si procede)
type	string	Tipo de recurso.

HealthProbeEnabled

Si se habilitan los sondeos de estado que se van a realizar en back-end definidos en backendPools. Los sondeos de estado solo se pueden deshabilitar si hay un único back-end habilitado en un único grupo de back-end habilitado.

Nombre	Tipo	Description
Disabled	string
Enabled	string

HealthProbeSettingsModel

Configuración de equilibrio de carga para un grupo de back-end

Nombre	Tipo	Valor predeterminado	Description
id	string		Identificador del recurso.
name	string		Nombre del recurso.
properties.enabledState	HealthProbeEnabled		Si se habilitan los sondeos de estado que se van a realizar en back-end definidos en backendPools. Los sondeos de estado solo se pueden deshabilitar si hay un único back-end habilitado en un único grupo de back-end habilitado.
properties.healthProbeMethod	FrontDoorHealthProbeMethod	HEAD	Configura qué método HTTP se va a usar para sondear los back-end definidos en backendPools.
properties.intervalInSeconds	integer		Número de segundos entre sondeos de estado.
properties.path	string		Ruta de acceso del sondeo de estado. El valor predeterminado es /
properties.protocol	FrontDoorProtocol		Esquema de protocolo que se va a usar para este sondeo
properties.resourceState	FrontDoorResourceState		Estado del recurso del subrecurso de Front Door o Front Door. Estado del recurso.
type	string		Tipo de recurso.

LoadBalancingSettingsModel

Configuración de equilibrio de carga para un grupo de back-end

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.additionalLatencyMilliseconds	integer	Latencia adicional en milisegundos para que los sondeos entren en el cubo de latencia más baja.
properties.resourceState	FrontDoorResourceState	Estado del recurso del subrecurso de Front Door o Front Door. Estado del recurso.
properties.sampleSize	integer	El número de ejemplos que se deben tener en cuenta para tomar decisiones de equilibrio de carga
properties.successfulSamplesRequired	integer	El número de muestras dentro del período de muestra que debe realizarse correctamente.
type	string	Tipo de recurso.

MinimumTLSVersion

La versión mínima de TLS necesaria de los clientes para establecer un protocolo de enlace SSL con Front Door.

Nombre	Tipo	Description
1.0	string
1.2	string

RedirectConfiguration

Describe la ruta de redirección.

Nombre	Tipo	Description
@odata.type	string: #Microsoft.Azure.FrontDoor.Models.FrontdoorRedirectConfiguration
customFragment	string	Fragmento que se va a agregar a la dirección URL de redireccionamiento. Fragmento es la parte de la dirección URL que viene después de #. No incluya el archivo #.
customHost	string	Host para redirigir. Deje vacío para usar el host entrante como host de destino.
customPath	string	Ruta de acceso completa que se va a redirigir. La ruta de acceso no puede estar vacía y debe comenzar con /. Deje vacío para usar la ruta de acceso entrante como ruta de acceso de destino.
customQueryString	string	Conjunto de cadenas de consulta que se colocarán en la dirección URL de redireccionamiento. Establecer este valor reemplazaría cualquier cadena de consulta existente; deje vacío para conservar la cadena de consulta entrante. La cadena de consulta debe tener el formato = . ¿La primera? y & se agregarán automáticamente, por lo que no los incluyan en el frente, pero separe varias cadenas de consulta con &.
redirectProtocol	FrontDoorRedirectProtocol	Protocolo del destino al que se redirige el tráfico.
redirectType	FrontDoorRedirectType	El tipo de redireccionamiento que usará la regla al redirigir el tráfico.

RoutingRule

Una regla de enrutamiento representa una especificación para que el tráfico trate y dónde enviarlo, junto con la información del sondeo de estado.

Nombre	Tipo	Description
id	string	Identificador del recurso.
name	string	Nombre del recurso.
properties.acceptedProtocols	FrontDoorProtocol[]	Esquemas de protocolo para que coincidan con esta regla
properties.enabledState	routingRuleEnabledState	Si desea habilitar el uso de esta regla. Los valores permitidos son "Enabled" o "Disabled"
properties.frontendEndpoints	SubResource[]	Puntos de conexión de front-end asociados a esta regla
properties.patternsToMatch	string[]	Patrones de ruta de la regla.
properties.resourceState	FrontDoorResourceState	Estado del recurso del subrecurso de Front Door o Front Door. Estado del recurso.
properties.routeConfiguration	RouteConfiguration: ForwardingConfiguration RedirectConfiguration	Referencia a la configuración de enrutamiento.
type	string	Tipo de recurso.

routingRuleEnabledState

Si desea habilitar el uso de esta regla. Los valores permitidos son "Enabled" o "Disabled"

Nombre	Tipo	Description
Disabled	string
Enabled	string

SessionAffinityEnabledState

Si desea permitir la afinidad de sesiones en este host. Las opciones válidas son "Habilitado" o "Deshabilitado".

Nombre	Tipo	Description
Disabled	string
Enabled	string

SubResource

Referencia a otro subrecurso.

Nombre	Tipo	Description
id	string	Identificador del recurso.

Vault

La instancia de Key Vault que contiene el certificado SSL

Nombre	Tipo	Description
id	string	Identificador del recurso.

WebApplicationFirewallPolicyLink

Define la directiva de Web Application Firewall para cada host (si procede)

Nombre	Tipo	Description
id	string	Identificador del recurso.

Compartir a través de

Front Doors - Create Or Update

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

Create or update specific Front Door

Solicitud de ejemplo

Respuesta de muestra

Definiciones

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

Recursos adicionales