Acciones de un conjunto de reglas
Un conjunto de reglas de Azure Front Door consta de reglas con una combinación de condiciones y acciones de coincidencia. En este artículo se proporciona una descripción detallada de las acciones que puede usar en un conjunto de reglas. Una acción define el comportamiento que se aplica a un tipo de solicitud que identifica una o más condiciones de coincidencia. En un conjunto de reglas, una regla puede tener hasta cinco acciones. Front Door también admite la variable de servidor en una acción de conjunto de reglas.
Las siguientes acciones están disponibles para su uso en un conjunto de reglas:
Invalidación de la configuración de enrutamiento
La acción de invalidación de configuración de ruta se usa para invalidar el grupo de origen o la configuración de almacenamiento en caché que se usará para la solicitud. Puede optar por invalidar o respetar las configuraciones de grupo de origen especificadas en la ruta. Sin embargo, cuando invalide la configuración de ruta, debe configurar el almacenamiento en caché. De lo contrario, el almacenamiento en caché se deshabilita para la solicitud.
También puede invalidar cómo se almacenan en caché los archivos para solicitudes específicas, como:
- Invalidación del comportamiento de almacenamiento en caché especificado por el origen.
- Cómo se usan los parámetros de cadena de consulta para generar la clave de caché de la solicitud.
- El valor de período de vida (TTL) para controlar cuánto tiempo permanece en caché el contenido.
Propiedades
Propiedad | Valores admitidos |
---|---|
Invalidación de grupo de origen |
|
Almacenamiento en memoria caché |
|
Cuando Override origin group (Invalidar grupo de origen) está establecido en Sí, establezca las propiedades siguientes:
Propiedad | Valores admitidos |
---|---|
Origin group (Grupo de orígenes) | Grupo de origen al que se debe enrutar la solicitud. Esta configuración se invalida la configuración especificada en la ruta del punto de conexión de Front Door. |
Protocolo de reenvío | El protocolo que usará Front Door al reenviar la solicitud al origen. Los valores admitidos son solo HTTP, solo HTTPS y Coincidir solicitud entrante. Esta configuración se invalida la configuración especificada en la ruta del punto de conexión de Front Door. |
Cuando el almacenamiento en caché se establece en Habilitado, establezca las siguientes propiedades:
Propiedad | Valores admitidos |
---|---|
Comportamiento del almacenamiento en caché de cadenas de consulta |
|
Parámetros de consulta | La lista de nombres de parámetro de cadena de consulta, separados por comas. Esta propiedad solo se establece cuando el comportamiento de almacenamiento en caché de cadenas de consulta se establece en Ignore Specified Query Strings (Omitir cadenas de consulta especificadas) o Include Specified Query Strings (Incluir cadenas de consulta especificadas). |
Compresión |
|
Comportamiento de la caché |
|
Duración de la caché | Cuando el comportamiento de la Memoria caché se establece en Override always o Override if origin missing , estos campos deben especificar la duración de la caché que se va a usar. La duración máxima es 366 días. Esta propiedad solo se establece cuando el comportamiento de caché se establece en Invalidar siempre o Invalidar si falta el origen.
|
Ejemplos
En este ejemplo, se enrutan todas las solicitudes coincidentes a un grupo de origen denominado MyOriginGroup
, independientemente de la configuración de la ruta del punto de conexión de Front Door.
En este ejemplo, se establece la clave de caché para incluir un parámetro de cadena de consulta denominado customerId
. La compresión está habilitada y se respetan las directivas de almacenamiento en caché del origen.
En este ejemplo, se invalida la expiración de la memoria caché en 6 horas para las solicitudes coincidentes que ya no especifican una duración de caché. Front Door omite la cadena de consulta cuando determina la clave de caché y la compresión está habilitada.
Modificación del encabezado de solicitud
Use la acción modificar encabezado de solicitud para modificar los encabezados de la solicitud cuando se envíe a su origen.
Propiedades
Propiedad | Valores admitidos |
---|---|
Operator |
|
Nombre de encabezado | Nombre del encabezado que se va a modificar. |
Valor de encabezado | Valor que se va a anexar o sobrescribir. |
Ejemplo
En este ejemplo, se anexa el valor AdditionalValue
al encabezado de la solicitud MyRequestHeader
. Si el origen establece el encabezado de respuesta en un valor de ValueSetByClient
, después de aplicar esta acción, el encabezado de solicitud tendría un valor de ValueSetByClientAdditionalValue
.
Nota:
Algunos encabezados reservados de Azure Front Door no se pueden modificar mediante acciones del motor de reglas, incluidas las acciones para modificar los encabezados de solicitud y los encabezados de respuesta. No se puede modificar la siguiente lista de encabezados reservados, junto con los encabezados que tienen los prefijos x-ec
y x-fd
.
Accept-Ranges
Host
Connection
Content-Length
Transfer-Encoding
TE
Last-Modified
Keep-Alive
Expect
Upgrade
If-Modified-Since
If-Unmodified-Since
If-None-Match
If-Match
Range
If-Range
X-Ms-Via
X-Ms-Force-Refresh
X-MSEdge-Ref
Warning
Forwarded
Via
X-Forwarded-For
X-Forwarded-Proto
X-Forwarded-Host
X-Azure-RequestChain
X-Azure-FDID
X-Azure-RequestChainv2
X-Azure-Ref
Modificación del encabezado de respuesta
Use la acción modificar encabezado de respuesta para modificar los encabezados que están presentes en las respuestas antes de que se devuelvan a los clientes.
Propiedades
Propiedad | Valores admitidos |
---|---|
Operator |
|
Nombre de encabezado | Nombre del encabezado que se va a modificar. |
Valor de encabezado | Valor que se va a anexar o sobrescribir. |
Ejemplo
En este ejemplo, se elimina el encabezado con el nombre X-Powered-By
de las respuestas antes de que se devuelvan al cliente.
Nota:
Algunos encabezados reservados de Azure Front Door no se pueden modificar mediante acciones del motor de reglas, incluidas las acciones para modificar los encabezados de solicitud y los encabezados de respuesta. No se puede modificar la siguiente lista de encabezados reservados, junto con los encabezados que tienen los prefijos x-ec
y x-fd
.
Accept-Ranges
Host
Connection
Content-Length
Transfer-Encoding
TE
Last-Modified
Keep-Alive
Expect
Upgrade
If-Modified-Since
If-Unmodified-Since
If-None-Match
If-Match
Range
If-Range
X-Ms-Via
X-Ms-Force-Refresh
X-MSEdge-Ref
Warning
Forwarded
Via
X-Forwarded-For
X-Forwarded-Proto
X-Forwarded-Host
X-Azure-RequestChain
X-Azure-FDID
X-Azure-RequestChainv2
X-Azure-Ref
Redirección de direcciones URL
Use la acción de redireccionamiento de dirección URL para redirigir a los clientes a una nueva dirección URL. A los clientes se les envía una respuesta de redirección de Front Door. Azure Front Door admite la captura dinámica de la ruta de acceso URL con una variable de servidor {url_path:seg#}
y convierte la ruta de acceso URL a minúsculas o mayúsculas con {url_path.tolower}
o {url_path.toupper}
. Para obtener más información, consulte Variables de servidor.
Propiedades
Propiedad | Valores admitidos |
---|---|
Tipo de redireccionamiento | El tipo de respuesta que se devuelve al solicitante.
|
Protocolo de redireccionamiento |
|
Host de destino | El nombre de host al que desea que se redirija la solicitud. Déjelo en blanco para conservar el host entrante. |
Ruta de acceso de destino | La ruta de acceso que se va a usar en la redirección. Incluya el interlineado / . Déjelo en blanco para conservar la ruta de acceso entrante. |
Cadena de consulta | Defina la cadena de consulta utilizada en la redirección. No incluya el interlineado ? . Déjelo en blanco para conservar la cadena de consulta entrante. |
Fragmento de destino | El fragmento que se va a usar en la redirección. Déjelo en blanco para conservar el fragmento entrante. |
Ejemplo
En este ejemplo, se redirige la solicitud a https://contoso.com/exampleredirection?clientIp={client_ip}
, a la vez que se conserva el fragmento. Se utiliza una redirección temporal HTTP (307). La dirección IP del cliente se usa en lugar del token {client_ip}
dentro de la dirección URL mediante la client_ip
variable de servidor.
Reescritura de direcciones URL
Use la acción reescritura de URL para reescribir la ruta de acceso de una solicitud en camino hacia el origen. Azure Front Door admite la captura dinámica de la ruta de acceso URL con una variable de servidor {url_path:seg#}
y convierte la ruta de acceso URL a minúsculas o mayúsculas con {url_path.tolower}
o {url_path.toupper}
. Para obtener más información, consulte Variables de servidor.
Propiedades
Propiedad | Valores admitidos |
---|---|
Patrón de origen | Defina el patrón de origen en la ruta de acceso URL que se va a reemplazar. Actualmente, el patrón de origen usa una coincidencia basada en el prefijo. Para una coincidencia con todas las ruta de acceso de las direcciones URL, use una barra (/ ) como valor de patrón de origen. |
Destination | Defina la ruta de acceso de destino que se va a usar en la reescritura. La ruta de acceso de destino sobrescribe el patrón de origen. |
Conservar la ruta de acceso sin coincidencia | Si se establece en Sí, el resto de la ruta de acceso después del patrón de origen se anexa a la nueva ruta de acceso de destino. |
Ejemplo
En este ejemplo, se reescriben todas las solicitudes en la ruta de acceso /redirection
y no se conserva el resto de la ruta de acceso.
Importante
Azure Front Door (clásico) se retirará el 31 de marzo de 2027. Para evitar cualquier interrupción del servicio, es importante migrar los perfiles de Azure Front Door (clásico) al nivel Estándar o Premium de Azure Front Door para marzo de 2027. Para obtener más información, consulte retirada de Azure Front Door (clásico).
En Azure Front Door (clásico), un motor de reglas puede constar de hasta 25 reglas que contienen condiciones de coincidencia y acciones asociadas. En este artículo se proporciona una descripción detallada de las acciones que puede definir en una regla.
Una acción define el comportamiento que se aplica al tipo de solicitud que identifica una condición o conjunto de condiciones de coincidencia. En la configuración del motor de reglas, una regla puede tener hasta 10 condiciones de coincidencia y 5 acciones. Solo puede tener una acción Invalidar configuración de enrutamiento en una sola regla.
Las siguientes acciones están disponibles para su uso en la configuración del motor de reglas.
Modificación del encabezado de solicitud
Use estas acciones para modificar los encabezados presentes en las solicitudes enviadas a su back-end.
Campos obligatorios
Acción | Nombre del encabezado HTTP | Value |
---|---|---|
Append | Cuando esta opción está seleccionada y la regla coincide, el encabezado especificado en Nombre del encabezado se agrega a la solicitud con el valor especificado. Si el encabezado ya está presente, este valor se anexa al valor existente. | String |
Sobrescribir | Cuando esta opción está seleccionada y la regla coincide, el encabezado especificado en Nombre del encabezado se agrega a la solicitud con el valor especificado. Si el encabezado ya está presente, el valor especificado sobrescribe el valor existente. | String |
Eliminar | Cuando esta opción está seleccionada con la reglas que coinciden y está presente el encabezado especificado en la regla, este se elimina de la solicitud. | String |
Modificación del encabezado de respuesta
Use estas acciones para modificar los encabezados presentes en las respuestas devueltas a los clientes.
Campos obligatorios
Acción | Nombre del encabezado HTTP | Value |
---|---|---|
Append | Cuando esta opción se selecciona y la regla coincide, el encabezado especificado en Nombre del encabezado se agrega a la respuesta con el Valor especificado. Si el encabezado ya está presente, el Valor se anexa al valor existente. | String |
Sobrescribir | Cuando esta opción está seleccionada y la regla coincide, el encabezado especificado en Nombre del encabezado se agrega a la respuesta con el Valor especificado. Si el encabezado ya está presente, el Valor sobrescribe el valor existente. | String |
Eliminar | Cuando esta opción está seleccionada con la reglas que coinciden y está presente el encabezado especificado en la regla, este se elimina de la respuesta. | String |
Invalidaciones de las configuraciones de enrutamiento
Tipo de enrutamiento: Redirect
Use estas acciones para redirigir a los clientes a una nueva dirección URL.
Campos obligatorios
Campo | Descripción |
---|---|
Tipo de redireccionamiento | La redirección es una manera de enviar usuarios o clientes de una dirección URL a otra. Un tipo de redirección establece el código de estado utilizado por los clientes para entender el propósito de la redirección. Puede seleccionar los siguientes códigos de estado de redirección: Encontrado (302), Movido (301), Redireccionamiento temporal (307) y Redireccionamiento permanente (308). |
Protocolo de redireccionamiento | Conserve el protocolo según la solicitud entrante o defina un nuevo protocolo para el redireccionamiento. Por ejemplo, seleccione "HTTPS" para el redireccionamiento de HTTP a HTTPS. |
Host de destino | Establezca este valor para cambiar el nombre de host en la dirección URL para el redireccionamiento o para retener el nombre de host de la solicitud entrante. |
Ruta de acceso de destino | Retenga la ruta de acceso de acuerdo con cada solicitud entrante, o actualice la ruta de acceso de la dirección URL para el redireccionamiento. |
Cadena de consulta | Establezca este valor para reemplazar cualquier cadena de consulta existente de la dirección URL de solicitud entrante o para retener el conjunto original de cadenas de consulta. |
Fragmento de destino | El fragmento de destino es la parte de la dirección URL tras "#", normalmente los exploradores lo usan para aterrizar en una sección en concreto de una página. Establezca este valor para agregar un fragmento a la dirección URL de redireccionamiento. |
Tipo de enrutamiento: Adelante
Use estas acciones para desviar a los clientes a una nueva dirección URL. Estas acciones también contienen subacciones para la reescritura de direcciones URL y almacenamiento en caché.
Campo | Descripción |
---|---|
Grupo back-end | Seleccione el grupo de back-end para invalidarse y atender las solicitudes; verá todos los grupos de back-end configurados previamente en el perfil de Front Door. |
Protocolo de reenvío | Protocolo que se usa para reenviar la solicitud al back-end o buscar la coincidencia del protocolo de la solicitud entrante. |
Reescritura de URL | Ruta de acceso que se usará al construir la solicitud de reescritura de direcciones URL para reenviar al back-end. |
Almacenamiento en memoria caché | Habilite el almacenamiento en caché para esta regla de enrutamiento. Cuando se habilita, Azure Front Door almacena en caché el contenido estático. |
Reescritura de direcciones URL
Use esta configuración para configurar una ruta de acceso de reenvío personalizada opcional que se usará al construir la solicitud para reenviar al back-end.
Campo | Descripción |
---|---|
Ruta de acceso de reenvío personalizada | Defina una ruta de acceso a la que se desvían las solicitudes. |
Almacenamiento en memoria caché
Use esta configuración para controlar cómo se almacenan en caché los archivos para las solicitudes que contienen cadenas de consulta. Si se va a almacenar en caché el contenido en función de todos los parámetros o de los parámetros seleccionados. Puede usar esta configuración para sobrescribir el valor de período de vida (TTL) y controlar cuánto tiempo permanece en caché el contenido. Para forzar el almacenamiento en caché como una acción, establezca el campo correspondiente en "Habilitado". Al forzar el almacenamiento en caché, aparecen las siguientes opciones:
Comportamiento de la caché | Descripción |
---|---|
Omitir cadena de consulta | Una vez almacenado en caché el recurso, todas las solicitudes posteriores ignorarán las cadenas de consulta hasta que expire el recurso almacenado en caché. |
Usar cadena de consulta | Cada solicitud con una URL única, incluida la cadena de consulta, se trata como un recurso único con su propia memoria caché. |
Omitir las cadenas de consulta especificadas | Las cadenas de consulta de la dirección URL de solicitud que aparecen en el valor "Parámetros de la consulta" se omiten para el almacenamiento en caché. |
Incluir las cadenas de consulta especificadas | Las cadenas de consulta de la dirección URL de solicitud que aparecen en el valor "Parámetros de la consulta" se usan para el almacenamiento en caché. |
Otros campos | Descripción |
---|---|
Compresión dinámica | Front Door puede comprimir dinámicamente el contenido en el borde, lo que genera una respuesta más pequeña y rápida. |
Parámetros de consulta | Lista separada por comas de parámetros permitidos o no permitidos que se pueden usar como base para el almacenamiento en caché. |
Usar duración de caché predeterminada | Establezca el uso de la duración predeterminada de la caché de Azure Front Door o defina una duración de almacenamiento en caché que ignore la directiva de respuesta de origen. |
Pasos siguientes
- Aprenda a configurar el primer Conjunto de reglas.
- Más información sobre las condiciones de coincidencia del conjunto de reglas.
- Obtenga más información acerca de los conjuntos de reglas de Azure Front Door.