Rules - Update
Actualiza una regla de entrega existente dentro de un conjunto de reglas.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/ruleSets/{ruleSetName}/rules/{ruleName}?api-version=2025-04-15
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
profile
|
path | True |
string minLength: 1maxLength: 260 pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$ |
Nombre de Azure Front Door Standard o Azure Front Door Premium que es único dentro del grupo de recursos. |
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
rule
|
path | True |
string |
Nombre de la regla de entrega que es única dentro del punto de conexión. |
rule
|
path | True |
string |
Nombre del conjunto de reglas en el perfil. |
subscription
|
path | True |
string (uuid) |
Identificador de la suscripción de destino. El valor debe ser un UUID. |
api-version
|
query | True |
string minLength: 1 |
Versión de la API que se va a usar para esta operación. |
Cuerpo de la solicitud
Nombre | Tipo | Description |
---|---|---|
properties.actions | DeliveryRuleAction[]: |
Lista de acciones que se ejecutan cuando se cumplen todas las condiciones de una regla. |
properties.conditions |
DeliveryRuleCondition[]:
|
Lista de condiciones que deben coincidir para que se ejecuten las acciones |
properties.matchProcessingBehavior |
Si esta regla es una coincidencia, el motor de reglas seguirá ejecutando las reglas restantes o deténgase. Si no está presente, el valor predeterminado es Continuar. |
|
properties.order |
integer (int32) |
Orden en el que se aplican las reglas para el punto de conexión. Valores posibles {0,1,2,.........}. Una regla con un orden menor se aplicará antes de una regla con un orden mayor. La regla con el orden 0 es una regla especial. No requiere ninguna condición y acciones enumeradas en él siempre se aplicarán. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
De acuerdo |
|
202 Accepted |
Aceptado. La solicitud se ha aceptado para su procesamiento y la operación se completará de forma asincrónica. Encabezados location: string |
|
Other Status Codes |
Respuesta de error de Azure Front Door que describe por qué se produjo un error en la operación. |
Seguridad
azure_auth
Flujo de 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 | suplantar la cuenta de usuario |
Ejemplos
Rules_Update
Solicitud de ejemplo
PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/ruleSets/ruleSet1/rules/rule1?api-version=2025-04-15
{
"properties": {
"order": 1,
"actions": [
{
"name": "ModifyResponseHeader",
"parameters": {
"typeName": "DeliveryRuleHeaderActionParameters",
"headerAction": "Overwrite",
"headerName": "X-CDN",
"value": "MSFT"
}
}
]
}
}
Respuesta de muestra
{
"name": "rule1",
"id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/rulesets/ruleSet1/rules/rule1",
"type": "Microsoft.Cdn/profiles/rulesets/rules",
"properties": {
"order": 1,
"conditions": [
{
"name": "RequestMethod",
"parameters": {
"typeName": "DeliveryRuleRequestMethodConditionParameters",
"operator": "Equal",
"matchValues": [
"GET"
],
"negateCondition": false,
"transforms": []
}
}
],
"actions": [
{
"name": "ModifyResponseHeader",
"parameters": {
"typeName": "DeliveryRuleHeaderActionParameters",
"headerAction": "Overwrite",
"headerName": "X-CDN",
"value": "MSFT"
}
}
],
"matchProcessingBehavior": "Continue",
"provisioningState": "Succeeded",
"deploymentStatus": "NotStarted"
}
}
azure-asyncoperation: https://management.azure.com/subscriptions/subid/resourcegroups/resourceGroupName/providers/Microsoft.Cdn/operationresults/operationId?api-version=2025-04-15
{
"name": "rule1",
"id": "/subscriptions/subid/resourcegroups/RG/providers/Microsoft.Cdn/profiles/profile1/rulesets/ruleSet1/rules/rule1",
"type": "Microsoft.Cdn/profiles/rulesets/rules",
"properties": {
"order": 1,
"conditions": [
{
"name": "RequestMethod",
"parameters": {
"typeName": "DeliveryRuleRequestMethodConditionParameters",
"operator": "Equal",
"matchValues": [
"GET"
],
"negateCondition": false,
"transforms": []
}
}
],
"actions": [
{
"name": "ModifyResponseHeader",
"parameters": {
"typeName": "DeliveryRuleHeaderActionParameters",
"headerAction": "Overwrite",
"headerName": "X-CDN",
"value": "MSFT"
}
}
],
"matchProcessingBehavior": "Continue",
"provisioningState": "Updating",
"deploymentStatus": "NotStarted"
}
}
Definiciones
Nombre | Description |
---|---|
Afd |
Estado de aprovisionamiento |
algorithm |
Algoritmo que se va a usar para la firma de direcciones URL |
cache |
Comportamiento de almacenamiento en caché de las solicitudes |
Cache |
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. |
Cache |
Define los parámetros para la acción de expiración de caché. |
Cache |
Define los parámetros de la acción de cadena de consulta de clave de caché. |
Cache |
Nivel en el que se debe almacenar en caché el contenido. |
Client |
Define los parámetros para las condiciones de coincidencia de ClientPort. |
Client |
Describe el operador que se va a hacer coincidir. |
Cookies |
Define los parámetros para las condiciones de coincidencia de cookies. |
Cookies |
Describe el operador que se va a hacer coincidir. |
created |
Tipo de identidad que creó el recurso. |
Delivery |
Define la acción de expiración de caché para la regla de entrega. |
Delivery |
Define la acción de cadena de consulta de clave caché para la regla de entrega. |
Delivery |
Define la condición ClientPort para la regla de entrega. |
Delivery |
Define la condición Cookies para la regla de entrega. |
Delivery |
Define la condición HostName para la regla de entrega. |
Delivery |
Define la condición HttpVersion para la regla de entrega. |
Delivery |
Define la condición IsDevice para la regla de entrega. |
Delivery |
Define la condición PostArgs para la regla de entrega. |
Delivery |
Define la condición QueryString para la regla de entrega. |
Delivery |
Define la condición RemoteAddress para la regla de entrega. |
Delivery |
Define la condición RequestBody para la regla de entrega. |
Delivery |
Define la acción del encabezado de solicitud para la regla de entrega. |
Delivery |
Define la condición RequestHeader para la regla de entrega. |
Delivery |
Define la condición RequestMethod para la regla de entrega. |
Delivery |
Define la condición RequestScheme para la regla de entrega. |
Delivery |
Define la condición RequestUri para la regla de entrega. |
Delivery |
Define la acción del encabezado de respuesta para la regla de entrega. |
Delivery |
Define la acción de invalidación de configuración de ruta para la regla de entrega. Solo se aplica a los perfiles Estándar/Premium de Frontdoor. |
Delivery |
Define la condición ServerPort para la regla de entrega. |
Delivery |
Define la condición SocketAddress para la regla de entrega. |
Delivery |
Define la condición SslProtocol para la regla de entrega. |
Delivery |
Define la condición UrlFileExtension para la regla de entrega. |
Delivery |
Define la condición UrlFileName para la regla de entrega. |
Delivery |
Define la condición UrlPath para la regla de entrega. |
Deployment |
|
Destination |
Protocolo que se va a usar para el redireccionamiento. El valor predeterminado es MatchRequest. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Forwarding |
Protocolo que usará esta regla al reenviar el tráfico a los back-end. |
Header |
Acción que se va a realizar |
Header |
Define los parámetros de la acción de encabezado de solicitud. |
Host |
Define los parámetros para las condiciones de coincidencia de HostName. |
Host |
Describe el operador que se va a hacer coincidir. |
Http |
Define los parámetros para las condiciones de coincidencia de HttpVersion. |
Http |
Describe el operador que se va a hacer coincidir. |
Is |
Define los parámetros para las condiciones de coincidencia de IsDevice. |
Is |
Valor de coincidencia para la condición de la regla de entrega |
Is |
Describe el operador que se va a hacer coincidir. |
Match |
Si esta regla es una coincidencia, el motor de reglas seguirá ejecutando las reglas restantes o deténgase. Si no está presente, el valor predeterminado es Continuar. |
Origin |
Define los parámetros para la configuración de invalidación del grupo de origen. |
Origin |
Define la acción de invalidación del grupo de origen para la regla de entrega. |
Origin |
Define los parámetros para la acción de invalidación del grupo de origen. |
param |
Indica el propósito del parámetro. |
Post |
Define los parámetros para las condiciones de coincidencia de PostArgs. |
Post |
Describe el operador que se va a hacer coincidir. |
query |
Comportamiento de almacenamiento en caché de las solicitudes |
Query |
Define los parámetros para las condiciones de coincidencia de QueryString. |
Query |
Describe el operador que se va a hacer coincidir. |
Redirect |
El tipo de redireccionamiento que usará la regla al redirigir el tráfico. |
Remote |
Define los parámetros para las condiciones de coincidencia de RemoteAddress. |
Remote |
Describe el operador que se va a hacer coincidir. |
Request |
Define los parámetros para las condiciones de coincidencia de RequestBody. |
Request |
Describe el operador que se va a hacer coincidir. |
Request |
Define los parámetros para las condiciones de coincidencia de RequestHeader. |
Request |
Describe el operador que se va a hacer coincidir. |
Request |
Define los parámetros para las condiciones de coincidencia requestMethod. |
Request |
Valor de coincidencia para la condición de la regla de entrega |
Request |
Describe el operador que se va a hacer coincidir. |
Request |
Define los parámetros para las condiciones de coincidencia de RequestScheme. |
Request |
Valor de coincidencia para la condición de la regla de entrega |
Request |
Define los parámetros para las condiciones de coincidencia de RequestUri. |
Request |
Describe el operador que se va a hacer coincidir. |
Resource |
Referencia a otro recurso. |
Route |
Define los parámetros de la acción de invalidación de configuración de ruta. |
Rule |
Asignación de nombres de reglas descriptivos a cualquier información relacionada con reglas o secretos. |
rule |
Comportamiento de almacenamiento en caché de las solicitudes |
rule |
Indica si la compresión de contenido está habilitada. Si la compresión está habilitada, el contenido se servirá como comprimido si el usuario solicita una versión comprimida. El contenido no se comprimirá en AzureFrontDoor cuando el contenido solicitado sea inferior a 1 byte o superior a 1 MB. |
rule |
Define cómo Frontdoor almacena en caché las solicitudes que incluyen cadenas de consulta. Puede omitir cualquier cadena de consulta al almacenar en caché, omitir cadenas de consulta específicas, almacenar en caché todas las solicitudes con una dirección URL única o almacenar en caché cadenas de consulta específicas. |
Rule |
Objeto JSON de dominio necesario para la creación o actualización del dominio. |
Server |
Define los parámetros para las condiciones de coincidencia de ServerPort. |
Server |
Describe el operador que se va a hacer coincidir. |
Socket |
Define los parámetros para las condiciones de coincidencia de SocketAddress. |
Socket |
Describe el operador que se va a hacer coincidir. |
Ssl |
El protocolo de una conexión TLS establecida. |
Ssl |
Define los parámetros para las condiciones de coincidencia de SslProtocol. |
Ssl |
Describe el operador que se va a hacer coincidir. |
system |
Metadatos relativos a la creación y última modificación del recurso. |
transform |
Describe qué transformaciones se aplican antes de que coincidan. |
Url |
Define los parámetros para las condiciones de coincidencia de UrlFileExtension. |
Url |
Describe el operador que se va a hacer coincidir. |
Url |
Define los parámetros para las condiciones de coincidencia de UrlFilename. |
Url |
Describe el operador que se va a hacer coincidir. |
Url |
Define los parámetros para las condiciones de coincidencia de UrlPath. |
Url |
Describe el operador que se va a hacer coincidir. |
Url |
Define la acción de redirección url para la regla de entrega. |
Url |
Define los parámetros de la acción de redirección de direcciones URL. |
Url |
Define la acción de reescritura de url para la regla de entrega. |
Url |
Define los parámetros de la acción de reescritura url. |
Url |
Define la acción de firma de dirección URL para la regla de entrega. |
Url |
Define los parámetros de la acción Firma de dirección URL. |
Url |
Define cómo identificar un parámetro para un propósito específico, por ejemplo, expira. |
AfdProvisioningState
Estado de aprovisionamiento
Valor | Description |
---|---|
Creating | |
Deleting | |
Failed | |
Succeeded | |
Updating |
algorithm
Algoritmo que se va a usar para la firma de direcciones URL
Valor | Description |
---|---|
SHA256 |
cacheBehavior
Comportamiento de almacenamiento en caché de las solicitudes
Valor | Description |
---|---|
BypassCache | |
Override | |
SetIfMissing |
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 |
---|---|---|
cacheBehavior |
Comportamiento de almacenamiento en caché de las solicitudes |
|
cacheDuration |
string |
Duración durante la que se debe almacenar en caché el contenido. El formato permitido es [d.]hh:mm:ss |
isCompressionEnabled |
Indica si la compresión de contenido está habilitada. Si la compresión está habilitada, el contenido se servirá como comprimido si el usuario solicita una versión comprimida. El contenido no se comprimirá en AzureFrontDoor cuando el contenido solicitado sea inferior a 1 byte o superior a 1 MB. |
|
queryParameters |
string |
parámetros de consulta para incluir o excluir (separados por comas). |
queryStringCachingBehavior |
Define cómo Frontdoor almacena en caché las solicitudes que incluyen cadenas de consulta. Puede omitir cualquier cadena de consulta al almacenar en caché, omitir cadenas de consulta específicas, almacenar en caché todas las solicitudes con una dirección URL única o almacenar en caché cadenas de consulta específicas. |
CacheExpirationActionParameters
Define los parámetros para la acción de expiración de caché.
Nombre | Tipo | Description |
---|---|---|
cacheBehavior |
Comportamiento de almacenamiento en caché de las solicitudes |
|
cacheDuration |
string |
Duración durante la que se debe almacenar en caché el contenido. El formato permitido es [d.]hh:mm:ss |
cacheType |
Nivel en el que se debe almacenar en caché el contenido. |
|
typeName |
string:
Delivery |
CacheKeyQueryStringActionParameters
Define los parámetros de la acción de cadena de consulta de clave de caché.
Nombre | Tipo | Description |
---|---|---|
queryParameters |
string |
parámetros de consulta para incluir o excluir (separados por comas). |
queryStringBehavior |
Comportamiento de almacenamiento en caché de las solicitudes |
|
typeName |
string:
Delivery |
CacheType
Nivel en el que se debe almacenar en caché el contenido.
Valor | Description |
---|---|
All |
ClientPortMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de ClientPort.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
string[] |
Valor de coincidencia para la condición de la regla de entrega |
|
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
ClientPortOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
CookiesMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de cookies.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
string[] |
Valor de coincidencia para la condición de la regla de entrega |
|
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
selector |
string |
Nombre de las cookies que se van a coincidir |
|
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
CookiesOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
createdByType
Tipo de identidad que creó el recurso.
Valor | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
DeliveryRuleCacheExpirationAction
Define la acción de expiración de caché para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Cache |
Nombre de la acción de la regla de entrega. |
parameters |
Define los parámetros de la acción. |
DeliveryRuleCacheKeyQueryStringAction
Define la acción de cadena de consulta de clave caché para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Cache |
Nombre de la acción de la regla de entrega. |
parameters |
Define los parámetros de la acción. |
DeliveryRuleClientPortCondition
Define la condición ClientPort para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Client |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRuleCookiesCondition
Define la condición Cookies para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Cookies |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRuleHostNameCondition
Define la condición HostName para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Host |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRuleHttpVersionCondition
Define la condición HttpVersion para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Http |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRuleIsDeviceCondition
Define la condición IsDevice para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Is |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRulePostArgsCondition
Define la condición PostArgs para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Post |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRuleQueryStringCondition
Define la condición QueryString para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Query |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRuleRemoteAddressCondition
Define la condición RemoteAddress para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Remote |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRuleRequestBodyCondition
Define la condición RequestBody para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Request |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRuleRequestHeaderAction
Define la acción del encabezado de solicitud para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Modify |
Nombre de la acción de la regla de entrega. |
parameters |
Define los parámetros de la acción. |
DeliveryRuleRequestHeaderCondition
Define la condición RequestHeader para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Request |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRuleRequestMethodCondition
Define la condición RequestMethod para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Request |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRuleRequestSchemeCondition
Define la condición RequestScheme para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Request |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRuleRequestUriCondition
Define la condición RequestUri para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Request |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRuleResponseHeaderAction
Define la acción del encabezado de respuesta para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Modify |
Nombre de la acción de la regla de entrega. |
parameters |
Define los parámetros de la acción. |
DeliveryRuleRouteConfigurationOverrideAction
Define la acción de invalidación de configuración de ruta para la regla de entrega. Solo se aplica a los perfiles Estándar/Premium de Frontdoor.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Route |
Nombre de la acción de la regla de entrega. |
parameters |
Define los parámetros de la acción. |
DeliveryRuleServerPortCondition
Define la condición ServerPort para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Server |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRuleSocketAddrCondition
Define la condición SocketAddress para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Socket |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRuleSslProtocolCondition
Define la condición SslProtocol para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name | string: |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRuleUrlFileExtensionCondition
Define la condición UrlFileExtension para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Url |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRuleUrlFileNameCondition
Define la condición UrlFileName para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Url |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeliveryRuleUrlPathCondition
Define la condición UrlPath para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Url |
Nombre de la condición para la regla de entrega. |
parameters |
Define los parámetros de la condición. |
DeploymentStatus
Valor | Description |
---|---|
Failed | |
InProgress | |
NotStarted | |
Succeeded |
DestinationProtocol
Protocolo que se va a usar para el redireccionamiento. El valor predeterminado es MatchRequest.
Valor | Description |
---|---|
Http | |
Https | |
MatchRequest |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Detalles del error. |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
ForwardingProtocol
Protocolo que usará esta regla al reenviar el tráfico a los back-end.
Valor | Description |
---|---|
HttpOnly | |
HttpsOnly | |
MatchRequest |
HeaderAction
Acción que se va a realizar
Valor | Description |
---|---|
Append | |
Delete | |
Overwrite |
HeaderActionParameters
Define los parámetros de la acción de encabezado de solicitud.
Nombre | Tipo | Description |
---|---|---|
headerAction |
Acción que se va a realizar |
|
headerName |
string |
Nombre del encabezado que se va a modificar |
typeName |
string:
Delivery |
|
value |
string |
Valor de la acción especificada |
HostNameMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de HostName.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
string[] |
Valor de coincidencia para la condición de la regla de entrega |
|
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
HostNameOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
HttpVersionMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de HttpVersion.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
string[] |
Valor de coincidencia para la condición de la regla de entrega |
|
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
HttpVersionOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Equal |
IsDeviceMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de IsDevice.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
Valor de coincidencia para la condición de la regla de entrega |
||
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
IsDeviceMatchValue
Valor de coincidencia para la condición de la regla de entrega
Valor | Description |
---|---|
Desktop | |
Mobile |
IsDeviceOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Equal |
MatchProcessingBehavior
Si esta regla es una coincidencia, el motor de reglas seguirá ejecutando las reglas restantes o deténgase. Si no está presente, el valor predeterminado es Continuar.
Valor | Description |
---|---|
Continue | |
Stop |
OriginGroupOverride
Define los parámetros para la configuración de invalidación del grupo de origen.
Nombre | Tipo | Description |
---|---|---|
forwardingProtocol |
Protocolo que usará esta regla al reenviar el tráfico a los back-end. |
|
originGroup |
define originGroup que invalidaría DefaultOriginGroup en la ruta. |
OriginGroupOverrideAction
Define la acción de invalidación del grupo de origen para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name | string: |
Nombre de la acción de la regla de entrega. |
parameters |
Define los parámetros de la acción. |
OriginGroupOverrideActionParameters
Define los parámetros para la acción de invalidación del grupo de origen.
Nombre | Tipo | Description |
---|---|---|
originGroup |
define originGroup que invalidaría DefaultOriginGroup. |
|
typeName |
string:
Delivery |
paramIndicator
Indica el propósito del parámetro.
Valor | Description |
---|---|
Expires | |
KeyId | |
Signature |
PostArgsMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de PostArgs.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
string[] |
Valor de coincidencia para la condición de la regla de entrega |
|
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
selector |
string |
Nombre de PostArg que se va a coincidir |
|
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
PostArgsOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
queryStringBehavior
Comportamiento de almacenamiento en caché de las solicitudes
Valor | Description |
---|---|
Exclude | |
ExcludeAll | |
Include | |
IncludeAll |
QueryStringMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de QueryString.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
string[] |
Valor de coincidencia para la condición de la regla de entrega |
|
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
QueryStringOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
RedirectType
El tipo de redireccionamiento que usará la regla al redirigir el tráfico.
Valor | Description |
---|---|
Found | |
Moved | |
PermanentRedirect | |
TemporaryRedirect |
RemoteAddressMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de RemoteAddress.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
string[] |
Coincide con los valores con los que buscar coincidencias. El operador se aplicará a cada valor de aquí con semántica OR. Si alguno de ellos coincide con la variable con el operador especificado, esta condición de coincidencia se considera una coincidencia. |
|
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
RemoteAddressOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Any | |
GeoMatch | |
IPMatch |
RequestBodyMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de RequestBody.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
string[] |
Valor de coincidencia para la condición de la regla de entrega |
|
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
RequestBodyOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
RequestHeaderMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de RequestHeader.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
string[] |
Valor de coincidencia para la condición de la regla de entrega |
|
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
selector |
string |
Nombre del encabezado que se va a buscar |
|
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
RequestHeaderOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
RequestMethodMatchConditionParameters
Define los parámetros para las condiciones de coincidencia requestMethod.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
Valor de coincidencia para la condición de la regla de entrega |
||
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
RequestMethodMatchValue
Valor de coincidencia para la condición de la regla de entrega
Valor | Description |
---|---|
DELETE | |
GET | |
HEAD | |
OPTIONS | |
POST | |
PUT | |
TRACE |
RequestMethodOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Equal |
RequestSchemeMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de RequestScheme.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
Valor de coincidencia para la condición de la regla de entrega |
||
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
enum:
Equal |
Describe el operador que se va a hacer coincidir. |
|
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
RequestSchemeMatchValue
Valor de coincidencia para la condición de la regla de entrega
Valor | Description |
---|---|
HTTP | |
HTTPS |
RequestUriMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de RequestUri.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
string[] |
Valor de coincidencia para la condición de la regla de entrega |
|
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
RequestUriOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
ResourceReference
Referencia a otro recurso.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso. |
RouteConfigurationOverrideActionParameters
Define los parámetros de la acción de invalidación de configuración de ruta.
Nombre | Tipo | Description |
---|---|---|
cacheConfiguration |
Configuración de almacenamiento en caché asociada a esta regla. Para deshabilitar el almacenamiento en caché, no proporcione un objeto cacheConfiguration. |
|
originGroupOverride |
Referencia a la configuración de invalidación del grupo de origen. Deje vacío para usar el grupo de origen predeterminado en la ruta. |
|
typeName |
string:
Delivery |
Rule
Asignación de nombres de reglas descriptivos a cualquier información relacionada con reglas o secretos.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
id |
string (arm-id) |
Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
|
name |
string |
Nombre del recurso |
|
properties.actions | DeliveryRuleAction[]: |
Lista de acciones que se ejecutan cuando se cumplen todas las condiciones de una regla. |
|
properties.conditions |
DeliveryRuleCondition[]:
|
Lista de condiciones que deben coincidir para que se ejecuten las acciones |
|
properties.deploymentStatus | |||
properties.matchProcessingBehavior | Continue |
Si esta regla es una coincidencia, el motor de reglas seguirá ejecutando las reglas restantes o deténgase. Si no está presente, el valor predeterminado es Continuar. |
|
properties.order |
integer (int32) |
Orden en el que se aplican las reglas para el punto de conexión. Valores posibles {0,1,2,.........}. Una regla con un orden menor se aplicará antes de una regla con un orden mayor. La regla con el orden 0 es una regla especial. No requiere ninguna condición y acciones enumeradas en él siempre se aplicarán. |
|
properties.provisioningState |
Estado de aprovisionamiento |
||
properties.ruleSetName |
string |
Nombre del conjunto de reglas que contiene la regla. |
|
systemData |
Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy. |
||
type |
string |
Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
ruleCacheBehavior
Comportamiento de almacenamiento en caché de las solicitudes
Valor | Description |
---|---|
HonorOrigin | |
OverrideAlways | |
OverrideIfOriginMissing |
ruleIsCompressionEnabled
Indica si la compresión de contenido está habilitada. Si la compresión está habilitada, el contenido se servirá como comprimido si el usuario solicita una versión comprimida. El contenido no se comprimirá en AzureFrontDoor cuando el contenido solicitado sea inferior a 1 byte o superior a 1 MB.
Valor | Description |
---|---|
Disabled | |
Enabled |
ruleQueryStringCachingBehavior
Define cómo Frontdoor almacena en caché las solicitudes que incluyen cadenas de consulta. Puede omitir cualquier cadena de consulta al almacenar en caché, omitir cadenas de consulta específicas, almacenar en caché todas las solicitudes con una dirección URL única o almacenar en caché cadenas de consulta específicas.
Valor | Description |
---|---|
IgnoreQueryString | |
IgnoreSpecifiedQueryStrings | |
IncludeSpecifiedQueryStrings | |
UseQueryString |
RuleUpdateParameters
Objeto JSON de dominio necesario para la creación o actualización del dominio.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
properties.actions | DeliveryRuleAction[]: |
Lista de acciones que se ejecutan cuando se cumplen todas las condiciones de una regla. |
|
properties.conditions |
DeliveryRuleCondition[]:
|
Lista de condiciones que deben coincidir para que se ejecuten las acciones |
|
properties.matchProcessingBehavior | Continue |
Si esta regla es una coincidencia, el motor de reglas seguirá ejecutando las reglas restantes o deténgase. Si no está presente, el valor predeterminado es Continuar. |
|
properties.order |
integer (int32) |
Orden en el que se aplican las reglas para el punto de conexión. Valores posibles {0,1,2,.........}. Una regla con un orden menor se aplicará antes de una regla con un orden mayor. La regla con el orden 0 es una regla especial. No requiere ninguna condición y acciones enumeradas en él siempre se aplicarán. |
|
properties.ruleSetName |
string |
Nombre del conjunto de reglas que contiene la regla. |
ServerPortMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de ServerPort.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
string[] |
Valor de coincidencia para la condición de la regla de entrega |
|
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
ServerPortOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
SocketAddrMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de SocketAddress.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
string[] |
Valor de coincidencia para la condición de la regla de entrega |
|
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
SocketAddrOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Any | |
IPMatch |
SslProtocol
El protocolo de una conexión TLS establecida.
Valor | Description |
---|---|
TLSv1 | |
TLSv1.1 | |
TLSv1.2 |
SslProtocolMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de SslProtocol.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
Valor de coincidencia para la condición de la regla de entrega |
||
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
SslProtocolOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Equal |
systemData
Metadatos relativos a la creación y última modificación del recurso.
Nombre | Tipo | Description |
---|---|---|
createdAt |
string (date-time) |
Marca de tiempo de creación de recursos (UTC). |
createdBy |
string |
Identidad que creó el recurso. |
createdByType |
Tipo de identidad que creó el recurso. |
|
lastModifiedAt |
string (date-time) |
Marca de tiempo de la última modificación del recurso (UTC) |
lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |
transform
Describe qué transformaciones se aplican antes de que coincidan.
Valor | Description |
---|---|
Lowercase | |
RemoveNulls | |
Trim | |
Uppercase | |
UrlDecode | |
UrlEncode |
UrlFileExtensionMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de UrlFileExtension.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
string[] |
Valor de coincidencia para la condición de la regla de entrega |
|
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
UrlFileExtensionOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
UrlFileNameMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de UrlFilename.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
string[] |
Valor de coincidencia para la condición de la regla de entrega |
|
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
UrlFileNameOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx |
UrlPathMatchConditionParameters
Define los parámetros para las condiciones de coincidencia de UrlPath.
Nombre | Tipo | Valor predeterminado | Description |
---|---|---|---|
matchValues |
string[] |
Valor de coincidencia para la condición de la regla de entrega |
|
negateCondition |
boolean |
False |
Describe si se trata de una condición negada o no |
operator |
Describe el operador que se va a hacer coincidir. |
||
transforms |
Lista de transformaciones |
||
typeName |
string:
Delivery |
UrlPathOperator
Describe el operador que se va a hacer coincidir.
Valor | Description |
---|---|
Any | |
BeginsWith | |
Contains | |
EndsWith | |
Equal | |
GreaterThan | |
GreaterThanOrEqual | |
LessThan | |
LessThanOrEqual | |
RegEx | |
Wildcard |
UrlRedirectAction
Define la acción de redirección url para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Url |
Nombre de la acción de la regla de entrega. |
parameters |
Define los parámetros de la acción. |
UrlRedirectActionParameters
Define los parámetros de la acción de redirección de direcciones URL.
Nombre | Tipo | Description |
---|---|---|
customFragment |
string |
Fragmento que se va a agregar a la dirección URL de redireccionamiento. El fragmento es la parte de la dirección URL que viene después de #. No incluya #. |
customHostname |
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 estar en formato = . ? y & se agregarán automáticamente, por lo que no los incluyan. |
destinationProtocol |
Protocolo que se va a usar para el redireccionamiento. El valor predeterminado es MatchRequest. |
|
redirectType |
El tipo de redireccionamiento que usará la regla al redirigir el tráfico. |
|
typeName |
string:
Delivery |
UrlRewriteAction
Define la acción de reescritura de url para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Url |
Nombre de la acción de la regla de entrega. |
parameters |
Define los parámetros de la acción. |
UrlRewriteActionParameters
Define los parámetros de la acción de reescritura url.
Nombre | Tipo | Description |
---|---|---|
destination |
string |
Defina la dirección URL relativa a la que se reescribirán las solicitudes anteriores. |
preserveUnmatchedPath |
boolean |
Si se debe conservar la ruta de acceso no coincidentes. El valor predeterminado es true. |
sourcePattern |
string |
defina un patrón de URI de solicitud que identifique el tipo de solicitudes que se pueden reescribir. Si el valor está en blanco, todas las cadenas coinciden. |
typeName |
string:
Delivery |
UrlSigningAction
Define la acción de firma de dirección URL para la regla de entrega.
Nombre | Tipo | Description |
---|---|---|
name |
string:
Url |
Nombre de la acción de la regla de entrega. |
parameters |
Define los parámetros de la acción. |
UrlSigningActionParameters
Define los parámetros de la acción Firma de dirección URL.
Nombre | Tipo | Description |
---|---|---|
algorithm |
Algoritmo que se va a usar para la firma de direcciones URL |
|
parameterNameOverride |
Define qué parámetros de cadena de consulta se deben tener en cuenta para expirar, identificador de clave, etc. |
|
typeName |
string:
Delivery |
UrlSigningParamIdentifier
Define cómo identificar un parámetro para un propósito específico, por ejemplo, expira.
Nombre | Tipo | Description |
---|---|---|
paramIndicator |
Indica el propósito del parámetro. |
|
paramName |
string |
Nombre del parámetro |