# Tu primera redirección

> Redirige en el borde todas las peticiones de un nombre retirado a tu dominio principal, conservando la ruta y la query.

En este ejemplo `old.example.com` se retira y cada petición tiene que ir a `https://example.com` con la misma ruta y la misma query: `old.example.com/a/b?x=1` → `https://example.com/a/b?x=1`.

1. **Comprueba que el nombre tiene proxy.** El borde solo responde a los nombres con un registro DNS con proxy (A, AAAA o CNAME con el proxy activado). Si todas las rutas redirigen, el contenido del registro nunca se usa, así que puede apuntar al mismo origen que la raíz.
2. **Añade la regla.**

**Panel**

   Abre el dominio y ve a **Reglas → Redirecciones** → **Añadir redirección**. Pon **Nombre** `old.example.com`, **Prefijo de ruta** `/`, **URL de destino** `https://example.com`, **Estado** `301 · Permanente`, deja activados **Conservar el resto de la ruta** y **Conservar la consulta** y pulsa **Aplicar**. Después guarda el cambio con un motivo.
**CLI**

   ```sh
   openwaf-cloud ctl zones set example.com \
     redirects:='[{"host":"old.example.com","target":"https://example.com"}]' \
     --reason "Retirar old.example.com"
   ```
   `redirects` sustituye la lista entera: incluye las reglas que ya tengas (`zones show example.com` las lista).
**API**

   ```sh
   curl -sS -X PATCH "https://dash.openwaf.dev/v1/orgs/$ORG/zones/example.com/edge" \
     -H "Authorization: Bearer $OPENWAF_TOKEN" \
     -H "X-Change-Reason: Retirar old.example.com" \
     -H "Content-Type: application/json" \
     -d '{"redirects": [{"host": "old.example.com", "target": "https://example.com"}]}'
   ```
**MCP**

   `update_settings` con `{"zone": "example.com", "settings": {"redirects": [{"host": "old.example.com", "target": "https://example.com"}]}, "reason": "…"}`. Simula y después confirma.

3. **Pruébala.**

   ```sh
   curl -sI https://old.example.com/a/b?x=1
   ```

   ```http
   HTTP/2 301
   location: https://example.com/a/b?x=1
   ```


Siguiente: [cómo casan las reglas de redirección](https://developers.openwaf.dev/es/rules/redirects/) y los [campos](https://developers.openwaf.dev/es/rules/redirect-reference/) que puedes usar.