Compartir a través de


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
profileName
path True

string

minLength: 1
maxLength: 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.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

ruleName
path True

string

Nombre de la regla de entrega que es única dentro del punto de conexión.

ruleSetName
path True

string

Nombre del conjunto de reglas en el perfil.

subscriptionId
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

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

Rule

De acuerdo

202 Accepted

Rule

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

ErrorResponse

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
AfdProvisioningState

Estado de aprovisionamiento

algorithm

Algoritmo que se va a usar para la firma de direcciones URL

cacheBehavior

Comportamiento de almacenamiento en caché de las solicitudes

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.

CacheExpirationActionParameters

Define los parámetros para la acción de expiración de caché.

CacheKeyQueryStringActionParameters

Define los parámetros de la acción de cadena de consulta de clave de caché.

CacheType

Nivel en el que se debe almacenar en caché el contenido.

ClientPortMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de ClientPort.

ClientPortOperator

Describe el operador que se va a hacer coincidir.

CookiesMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de cookies.

CookiesOperator

Describe el operador que se va a hacer coincidir.

createdByType

Tipo de identidad que creó el recurso.

DeliveryRuleCacheExpirationAction

Define la acción de expiración de caché para la regla de entrega.

DeliveryRuleCacheKeyQueryStringAction

Define la acción de cadena de consulta de clave caché para la regla de entrega.

DeliveryRuleClientPortCondition

Define la condición ClientPort para la regla de entrega.

DeliveryRuleCookiesCondition

Define la condición Cookies para la regla de entrega.

DeliveryRuleHostNameCondition

Define la condición HostName para la regla de entrega.

DeliveryRuleHttpVersionCondition

Define la condición HttpVersion para la regla de entrega.

DeliveryRuleIsDeviceCondition

Define la condición IsDevice para la regla de entrega.

DeliveryRulePostArgsCondition

Define la condición PostArgs para la regla de entrega.

DeliveryRuleQueryStringCondition

Define la condición QueryString para la regla de entrega.

DeliveryRuleRemoteAddressCondition

Define la condición RemoteAddress para la regla de entrega.

DeliveryRuleRequestBodyCondition

Define la condición RequestBody para la regla de entrega.

DeliveryRuleRequestHeaderAction

Define la acción del encabezado de solicitud para la regla de entrega.

DeliveryRuleRequestHeaderCondition

Define la condición RequestHeader para la regla de entrega.

DeliveryRuleRequestMethodCondition

Define la condición RequestMethod para la regla de entrega.

DeliveryRuleRequestSchemeCondition

Define la condición RequestScheme para la regla de entrega.

DeliveryRuleRequestUriCondition

Define la condición RequestUri para la regla de entrega.

DeliveryRuleResponseHeaderAction

Define la acción del encabezado de respuesta para la regla de entrega.

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.

DeliveryRuleServerPortCondition

Define la condición ServerPort para la regla de entrega.

DeliveryRuleSocketAddrCondition

Define la condición SocketAddress para la regla de entrega.

DeliveryRuleSslProtocolCondition

Define la condición SslProtocol para la regla de entrega.

DeliveryRuleUrlFileExtensionCondition

Define la condición UrlFileExtension para la regla de entrega.

DeliveryRuleUrlFileNameCondition

Define la condición UrlFileName para la regla de entrega.

DeliveryRuleUrlPathCondition

Define la condición UrlPath para la regla de entrega.

DeploymentStatus
DestinationProtocol

Protocolo que se va a usar para el redireccionamiento. El valor predeterminado es MatchRequest.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

ForwardingProtocol

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

HeaderAction

Acción que se va a realizar

HeaderActionParameters

Define los parámetros de la acción de encabezado de solicitud.

HostNameMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de HostName.

HostNameOperator

Describe el operador que se va a hacer coincidir.

HttpVersionMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de HttpVersion.

HttpVersionOperator

Describe el operador que se va a hacer coincidir.

IsDeviceMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de IsDevice.

IsDeviceMatchValue

Valor de coincidencia para la condición de la regla de entrega

IsDeviceOperator

Describe el operador que se va a hacer coincidir.

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.

OriginGroupOverride

Define los parámetros para la configuración de invalidación del grupo de origen.

OriginGroupOverrideAction

Define la acción de invalidación del grupo de origen para la regla de entrega.

OriginGroupOverrideActionParameters

Define los parámetros para la acción de invalidación del grupo de origen.

paramIndicator

Indica el propósito del parámetro.

PostArgsMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de PostArgs.

PostArgsOperator

Describe el operador que se va a hacer coincidir.

queryStringBehavior

Comportamiento de almacenamiento en caché de las solicitudes

QueryStringMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de QueryString.

QueryStringOperator

Describe el operador que se va a hacer coincidir.

RedirectType

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

RemoteAddressMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de RemoteAddress.

RemoteAddressOperator

Describe el operador que se va a hacer coincidir.

RequestBodyMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de RequestBody.

RequestBodyOperator

Describe el operador que se va a hacer coincidir.

RequestHeaderMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de RequestHeader.

RequestHeaderOperator

Describe el operador que se va a hacer coincidir.

RequestMethodMatchConditionParameters

Define los parámetros para las condiciones de coincidencia requestMethod.

RequestMethodMatchValue

Valor de coincidencia para la condición de la regla de entrega

RequestMethodOperator

Describe el operador que se va a hacer coincidir.

RequestSchemeMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de RequestScheme.

RequestSchemeMatchValue

Valor de coincidencia para la condición de la regla de entrega

RequestUriMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de RequestUri.

RequestUriOperator

Describe el operador que se va a hacer coincidir.

ResourceReference

Referencia a otro recurso.

RouteConfigurationOverrideActionParameters

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.

ruleCacheBehavior

Comportamiento de almacenamiento en caché de las solicitudes

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.

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.

RuleUpdateParameters

Objeto JSON de dominio necesario para la creación o actualización del dominio.

ServerPortMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de ServerPort.

ServerPortOperator

Describe el operador que se va a hacer coincidir.

SocketAddrMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de SocketAddress.

SocketAddrOperator

Describe el operador que se va a hacer coincidir.

SslProtocol

El protocolo de una conexión TLS establecida.

SslProtocolMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de SslProtocol.

SslProtocolOperator

Describe el operador que se va a hacer coincidir.

systemData

Metadatos relativos a la creación y última modificación del recurso.

transform

Describe qué transformaciones se aplican antes de que coincidan.

UrlFileExtensionMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de UrlFileExtension.

UrlFileExtensionOperator

Describe el operador que se va a hacer coincidir.

UrlFileNameMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de UrlFilename.

UrlFileNameOperator

Describe el operador que se va a hacer coincidir.

UrlPathMatchConditionParameters

Define los parámetros para las condiciones de coincidencia de UrlPath.

UrlPathOperator

Describe el operador que se va a hacer coincidir.

UrlRedirectAction

Define la acción de redirección url para la regla de entrega.

UrlRedirectActionParameters

Define los parámetros de la acción de redirección de direcciones URL.

UrlRewriteAction

Define la acción de reescritura de url para la regla de entrega.

UrlRewriteActionParameters

Define los parámetros de la acción de reescritura url.

UrlSigningAction

Define la acción de firma de dirección URL para la regla de entrega.

UrlSigningActionParameters

Define los parámetros de la acción Firma de dirección URL.

UrlSigningParamIdentifier

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

ruleCacheBehavior

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

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.

queryParameters

string

parámetros de consulta para incluir o excluir (separados por comas).

queryStringCachingBehavior

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.

CacheExpirationActionParameters

Define los parámetros para la acción de expiración de caché.

Nombre Tipo Description
cacheBehavior

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

CacheType

Nivel en el que se debe almacenar en caché el contenido.

typeName string:

DeliveryRuleCacheExpirationActionParameters

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

queryStringBehavior

Comportamiento de almacenamiento en caché de las solicitudes

typeName string:

DeliveryRuleCacheKeyQueryStringBehaviorActionParameters

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

ClientPortOperator

Describe el operador que se va a hacer coincidir.

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleClientPortConditionParameters

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

CookiesOperator

Describe el operador que se va a hacer coincidir.

selector

string

Nombre de las cookies que se van a coincidir

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleCookiesConditionParameters

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:

CacheExpiration

Nombre de la acción de la regla de entrega.

parameters

CacheExpirationActionParameters

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:

CacheKeyQueryString

Nombre de la acción de la regla de entrega.

parameters

CacheKeyQueryStringActionParameters

Define los parámetros de la acción.

DeliveryRuleClientPortCondition

Define la condición ClientPort para la regla de entrega.

Nombre Tipo Description
name string:

ClientPort

Nombre de la condición para la regla de entrega.

parameters

ClientPortMatchConditionParameters

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

CookiesMatchConditionParameters

Define los parámetros de la condición.

DeliveryRuleHostNameCondition

Define la condición HostName para la regla de entrega.

Nombre Tipo Description
name string:

HostName

Nombre de la condición para la regla de entrega.

parameters

HostNameMatchConditionParameters

Define los parámetros de la condición.

DeliveryRuleHttpVersionCondition

Define la condición HttpVersion para la regla de entrega.

Nombre Tipo Description
name string:

HttpVersion

Nombre de la condición para la regla de entrega.

parameters

HttpVersionMatchConditionParameters

Define los parámetros de la condición.

DeliveryRuleIsDeviceCondition

Define la condición IsDevice para la regla de entrega.

Nombre Tipo Description
name string:

IsDevice

Nombre de la condición para la regla de entrega.

parameters

IsDeviceMatchConditionParameters

Define los parámetros de la condición.

DeliveryRulePostArgsCondition

Define la condición PostArgs para la regla de entrega.

Nombre Tipo Description
name string:

PostArgs

Nombre de la condición para la regla de entrega.

parameters

PostArgsMatchConditionParameters

Define los parámetros de la condición.

DeliveryRuleQueryStringCondition

Define la condición QueryString para la regla de entrega.

Nombre Tipo Description
name string:

QueryString

Nombre de la condición para la regla de entrega.

parameters

QueryStringMatchConditionParameters

Define los parámetros de la condición.

DeliveryRuleRemoteAddressCondition

Define la condición RemoteAddress para la regla de entrega.

Nombre Tipo Description
name string:

RemoteAddress

Nombre de la condición para la regla de entrega.

parameters

RemoteAddressMatchConditionParameters

Define los parámetros de la condición.

DeliveryRuleRequestBodyCondition

Define la condición RequestBody para la regla de entrega.

Nombre Tipo Description
name string:

RequestBody

Nombre de la condición para la regla de entrega.

parameters

RequestBodyMatchConditionParameters

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:

ModifyRequestHeader

Nombre de la acción de la regla de entrega.

parameters

HeaderActionParameters

Define los parámetros de la acción.

DeliveryRuleRequestHeaderCondition

Define la condición RequestHeader para la regla de entrega.

Nombre Tipo Description
name string:

RequestHeader

Nombre de la condición para la regla de entrega.

parameters

RequestHeaderMatchConditionParameters

Define los parámetros de la condición.

DeliveryRuleRequestMethodCondition

Define la condición RequestMethod para la regla de entrega.

Nombre Tipo Description
name string:

RequestMethod

Nombre de la condición para la regla de entrega.

parameters

RequestMethodMatchConditionParameters

Define los parámetros de la condición.

DeliveryRuleRequestSchemeCondition

Define la condición RequestScheme para la regla de entrega.

Nombre Tipo Description
name string:

RequestScheme

Nombre de la condición para la regla de entrega.

parameters

RequestSchemeMatchConditionParameters

Define los parámetros de la condición.

DeliveryRuleRequestUriCondition

Define la condición RequestUri para la regla de entrega.

Nombre Tipo Description
name string:

RequestUri

Nombre de la condición para la regla de entrega.

parameters

RequestUriMatchConditionParameters

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:

ModifyResponseHeader

Nombre de la acción de la regla de entrega.

parameters

HeaderActionParameters

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:

RouteConfigurationOverride

Nombre de la acción de la regla de entrega.

parameters

RouteConfigurationOverrideActionParameters

Define los parámetros de la acción.

DeliveryRuleServerPortCondition

Define la condición ServerPort para la regla de entrega.

Nombre Tipo Description
name string:

ServerPort

Nombre de la condición para la regla de entrega.

parameters

ServerPortMatchConditionParameters

Define los parámetros de la condición.

DeliveryRuleSocketAddrCondition

Define la condición SocketAddress para la regla de entrega.

Nombre Tipo Description
name string:

SocketAddr

Nombre de la condición para la regla de entrega.

parameters

SocketAddrMatchConditionParameters

Define los parámetros de la condición.

DeliveryRuleSslProtocolCondition

Define la condición SslProtocol para la regla de entrega.

Nombre Tipo Description
name string:

SslProtocol

Nombre de la condición para la regla de entrega.

parameters

SslProtocolMatchConditionParameters

Define los parámetros de la condición.

DeliveryRuleUrlFileExtensionCondition

Define la condición UrlFileExtension para la regla de entrega.

Nombre Tipo Description
name string:

UrlFileExtension

Nombre de la condición para la regla de entrega.

parameters

UrlFileExtensionMatchConditionParameters

Define los parámetros de la condición.

DeliveryRuleUrlFileNameCondition

Define la condición UrlFileName para la regla de entrega.

Nombre Tipo Description
name string:

UrlFileName

Nombre de la condición para la regla de entrega.

parameters

UrlFileNameMatchConditionParameters

Define los parámetros de la condición.

DeliveryRuleUrlPathCondition

Define la condición UrlPath para la regla de entrega.

Nombre Tipo Description
name string:

UrlPath

Nombre de la condición para la regla de entrega.

parameters

UrlPathMatchConditionParameters

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

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

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

HeaderAction

Acción que se va a realizar

headerName

string

Nombre del encabezado que se va a modificar

typeName string:

DeliveryRuleHeaderActionParameters

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

HostNameOperator

Describe el operador que se va a hacer coincidir.

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleHostNameConditionParameters

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

HttpVersionOperator

Describe el operador que se va a hacer coincidir.

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleHttpVersionConditionParameters

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

IsDeviceMatchValue[]

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

IsDeviceOperator

Describe el operador que se va a hacer coincidir.

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleIsDeviceConditionParameters

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

ForwardingProtocol

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

originGroup

ResourceReference

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:

OriginGroupOverride

Nombre de la acción de la regla de entrega.

parameters

OriginGroupOverrideActionParameters

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

ResourceReference

define originGroup que invalidaría DefaultOriginGroup.

typeName string:

DeliveryRuleOriginGroupOverrideActionParameters

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

PostArgsOperator

Describe el operador que se va a hacer coincidir.

selector

string

Nombre de PostArg que se va a coincidir

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRulePostArgsConditionParameters

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

QueryStringOperator

Describe el operador que se va a hacer coincidir.

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleQueryStringConditionParameters

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

RemoteAddressOperator

Describe el operador que se va a hacer coincidir.

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleRemoteAddressConditionParameters

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

RequestBodyOperator

Describe el operador que se va a hacer coincidir.

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleRequestBodyConditionParameters

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

RequestHeaderOperator

Describe el operador que se va a hacer coincidir.

selector

string

Nombre del encabezado que se va a buscar

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleRequestHeaderConditionParameters

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

RequestMethodMatchValue[]

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

RequestMethodOperator

Describe el operador que se va a hacer coincidir.

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleRequestMethodConditionParameters

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

RequestSchemeMatchValue[]

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

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleRequestSchemeConditionParameters

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

RequestUriOperator

Describe el operador que se va a hacer coincidir.

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleRequestUriConditionParameters

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

CacheConfiguration

Configuración de almacenamiento en caché asociada a esta regla. Para deshabilitar el almacenamiento en caché, no proporcione un objeto cacheConfiguration.

originGroupOverride

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:

DeliveryRuleRouteConfigurationOverrideActionParameters

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

DeploymentStatus

properties.matchProcessingBehavior

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

AfdProvisioningState

Estado de aprovisionamiento

properties.ruleSetName

string

Nombre del conjunto de reglas que contiene la regla.

systemData

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

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

ServerPortOperator

Describe el operador que se va a hacer coincidir.

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleServerPortConditionParameters

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

SocketAddrOperator

Describe el operador que se va a hacer coincidir.

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleSocketAddrConditionParameters

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

SslProtocol[]

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

SslProtocolOperator

Describe el operador que se va a hacer coincidir.

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleSslProtocolConditionParameters

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

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

createdByType

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

UrlFileExtensionOperator

Describe el operador que se va a hacer coincidir.

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleUrlFileExtensionMatchConditionParameters

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

UrlFileNameOperator

Describe el operador que se va a hacer coincidir.

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleUrlFilenameConditionParameters

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

UrlPathOperator

Describe el operador que se va a hacer coincidir.

transforms

transform[]

Lista de transformaciones

typeName string:

DeliveryRuleUrlPathMatchConditionParameters

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:

UrlRedirect

Nombre de la acción de la regla de entrega.

parameters

UrlRedirectActionParameters

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

DestinationProtocol

Protocolo que se va a usar para el redireccionamiento. El valor predeterminado es MatchRequest.

redirectType

RedirectType

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

typeName string:

DeliveryRuleUrlRedirectActionParameters

UrlRewriteAction

Define la acción de reescritura de url para la regla de entrega.

Nombre Tipo Description
name string:

UrlRewrite

Nombre de la acción de la regla de entrega.

parameters

UrlRewriteActionParameters

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:

DeliveryRuleUrlRewriteActionParameters

UrlSigningAction

Define la acción de firma de dirección URL para la regla de entrega.

Nombre Tipo Description
name string:

UrlSigning

Nombre de la acción de la regla de entrega.

parameters

UrlSigningActionParameters

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

algorithm

Algoritmo que se va a usar para la firma de direcciones URL

parameterNameOverride

UrlSigningParamIdentifier[]

Define qué parámetros de cadena de consulta se deben tener en cuenta para expirar, identificador de clave, etc.

typeName string:

DeliveryRuleUrlSigningActionParameters

UrlSigningParamIdentifier

Define cómo identificar un parámetro para un propósito específico, por ejemplo, expira.

Nombre Tipo Description
paramIndicator

paramIndicator

Indica el propósito del parámetro.

paramName

string

Nombre del parámetro