Todos los productos
Search
Centro de documentos

CDN:Reescritura de parámetros

Última actualización: Sep 21, 2026

Si los parámetros de la URL de la solicitud original difieren de los que requiere su servidor de origen, utilice la función Parameter Rewrite para reescribir los parámetros en la URL de la solicitud de recuperación de origen. Esta función le permite agregar, eliminar, conservar, modificar o ignorar parámetros.

Formato de los parámetros de URL

  • Los parámetros de URL son uno o varios pares name/value que se agregan a una URL después del carácter ?, con el formato name=value. Varios parámetros se separan con un carácter &.

  • Una URL también puede contener el carácter # y el texto que lo sigue. El carácter # dirige al navegador a una ubicación específica dentro de una página web.

    Por ejemplo, en http://www.example.com/index.html#segment, la parte #segment apunta a la ubicación segment dentro de la página index.html. Una vez que el navegador carga la página, se desplaza automáticamente hasta esa ubicación.改写参数图

Prioridad de las operaciones

  • Parameter Rewrite le permite configurar varias operaciones de reescritura para los parámetros de consulta en la URL de una solicitud de recuperación de origen. El orden de prioridad es Add > Delete > Reserve Only > Modify. Cuando distintas operaciones apuntan al mismo parámetro, solo se aplica la de mayor prioridad.

  • Si Ignore Parameters está habilitada, Add es la única otra operación que surte efecto.

Conflictos con otras funciones

Parameter Rewrite puede entrar en conflicto con la regla enhance break de Rewrite Origin Fetch URL y con la función Ignore parameters. Si ocurre un conflicto, prevalece la última función configurada.

Impacto en la clave de caché

  • La función Parameter Rewrite se ejecuta en el POP de recuperación de origen. No afecta el enrutamiento interno de CDN ni reescribe la clave de caché.

  • La función Ignore parameters se ejecuta en el nodo perimetral. Afecta el enrutamiento interno de CDN y reescribe la clave de caché.

Importante

Si una configuración utiliza una condición de regla del motor de reglas, la prioridad de dicha condición determina el orden de ejecución y anula el orden de configuración de la función.

Procedimiento

  1. Inicie sesión en la consola de CDN.

  2. En el panel de navegación izquierdo, haga clic en Domain Names.

  3. En la página Domain Names, busque el nombre de dominio deseado y haga clic en Manage en la columna Actions.

  4. En el panel de navegación izquierdo del nombre de dominio, haga clic en Origin Fetch.

  5. Haga clic en la pestaña Parameter Rewrite.

  6. Active Feature Switch.

  7. Configure los parámetros que desea reescribir.

    Configure las operaciones de reescritura según sus necesidades. También puede agregar varios parámetros en el cuadro de texto de cada tipo de operación. Para obtener más información, consulte Configuration examples.

  8. Haga clic en OK para aplicar la configuración.

    También puede hacer clic en Modify en la página Parameter Rewrite para modificar las reglas existentes.

Ejemplos de configuración

  • Ejemplo 1: Ignorar todos los parámetros

    Parámetro

    Valor

    Ignore Parameters

    Enabled

    Add

    Ninguna

    Delete

    Ninguna

    Reserve Only

    Ninguna

    Modify

    Ninguna

    Rule Condition

    No utilizada

    Resultado

    Solicitud original: http://example.com/index.html?code1=1&code2=2&code3=3

    Solicitud de recuperación de origen reescrita: http://example.com/index.html

  • Ejemplo 2: Conservar un parámetro específico

    Parámetro

    Valor

    Ignore Parameters

    Disabled

    Add

    Ninguna

    Delete

    Ninguna

    Reserve Only

    code2

    Modify

    Ninguna

    Rule Condition

    No utilizada

    Resultado

    Solicitud original: http://example.com/index.html?code1=1&code2=2&code3=3

    Solicitud de recuperación de origen reescrita: http://example.com/index.html?code2=2

  • Ejemplo 3: Agregar, eliminar y modificar parámetros

    Parámetro

    Valor

    Ignore Parameters

    Disabled

    Add

    code4=4

    Delete

    code2

    Reserve Only

    Ninguna

    Modify

    code3=0

    Rule Condition

    No utilizada

    Resultado

    Solicitud original: http://example.com/index.html?code1=1&code2=2&code3=3

    Solicitud de recuperación de origen reescrita: http://example.com/index.html?code1=1&code3=0&code4=4