[Rules] Update Origin Rules

Author: pedrosousa

src/content/docs/rules/origin-rules/create-api.mdx

@@ -29,7 +29,7 @@ Make sure your API token has the [required permissions](#required-api-token-perm
 
 ## Example requests
 
-<Details header="Example: Add a rule that overrides the HTTP `Host` header">
+<Details header="Example: Add a rule that overrides the HTTP `Host` header and the resolved DNS record">
 
 <Render file="origin-rules-api-change-host-header" />
 

src/content/docs/rules/origin-rules/examples/change-http-host-header.mdx

@@ -1,25 +1,33 @@
 ---
 pcx_content_type: example
-summary: Create an origin rule to change the HTTP `Host` header.
+summary: Create an origin rule to change the HTTP `Host` header and DNS record.
 products:
   - Origin Rules
-title: Change the HTTP Host header
-description: Create an origin rule to change the HTTP `Host` header.
+title: Change the HTTP Host header and DNS record
+description: Create an origin rule to change the HTTP `Host` header and the resolved DNS record.
 ---
 
 import { Render, Tabs, TabItem, Example } from "~/components";
 
-The following origin rule overrides the HTTP `Host` header to `eu_server.example.net` for all requests containing `/eu/` in their URI path.
+The following origin rule overrides the HTTP `Host` header to `eu_server.example.net` for all requests containing `/eu/` in their URI path. It also overrides the DNS record to the same hostname.
+
+The `Host` header override only updates the header value; the DNS record override will handle the rerouting of incoming requests.
 
 <Tabs syncKey="dashPlusAPI">
 <TabItem label="Dashboard" no-code="true">
 
 <Example>
 
-Text in Expression Editor:
+Expression when using the Expression Builder:
+
+| Field    | Operator | Value  |
+| -------- | -------- | ------ |
+| URI Path | contains | `/eu/` |
+
+Expression when using the Expression Editor:
 
 ```txt
-http.request.uri.path contains "/eu/"
+(http.request.uri.path contains "/eu/")
 ```
 
 Value after **Host Header** > **Rewrite to**:
@@ -28,6 +36,12 @@ Value after **Host Header** > **Rewrite to**:
 eu_server.example.net
 ```
 
+Value after **DNS Record** > **Override to**:
+
+```txt
+eu_server.example.net
+```
+
 </Example>
 
 </TabItem>

src/content/docs/rules/origin-rules/features.mdx

@@ -20,7 +20,9 @@ A common use case for this functionality is when your content is hosted on a thi
 
 :::note[Notes]
 
-- An origin rule performing a Host header override will also update the Server Name Indication (SNI) value of the original request to the same value. To set an SNI value different from the Host header value, add an [SNI override](#server-name-indication-sni) in the same origin rule or create a separate origin rule for this purpose.
+- In most situations, when you rewrite the HTTP `Host` header you also need to configure a [DNS record override](#dns-record). The `Host` header override only updates the header value; the DNS record override will handle the rerouting of the request.
+
+- An origin rule performing a `Host` header override will also update the Server Name Indication (SNI) value of the original request to the same value. To set an SNI value different from the `Host` header value, add an [SNI override](#server-name-indication-sni) in the same origin rule or create a separate origin rule for this purpose.
 
 - If you have configured load balancing through Cloudflare and you wish to override the HTTP `Host` header per origin or for a given monitor, refer to [Override HTTP Host headers](/load-balancing/additional-options/override-http-host-headers/) in the Load Balancing documentation for more information.
 
@@ -30,10 +32,9 @@ A common use case for this functionality is when your content is hosted on a thi
 
 Allows you to override the Server Name Indication (SNI) [^1] value of a request. For more information, refer to [What is SNI (Server Name Indication)?](https://www.cloudflare.com/learning/ssl/what-is-sni/) in the Learning Center.
 
-The new SNI value must be a valid hostname on the same Cloudflare account (possibly on a different zone).
-
 :::note[Notes]
 
+- The new SNI value must be a valid hostname on the same Cloudflare account (possibly on a different zone).
 - Currently, you can only use a static value when overriding SNI.
 - An SNI override will take precedence over [SNI rewrites of custom origins](/cloudflare-for-platforms/cloudflare-for-saas/start/advanced-settings/custom-origin/#sni-rewrites) when using Cloudflare for SaaS.
 
@@ -47,9 +48,13 @@ Allows you to override the resolved hostname of incoming requests. This function
 
 A common use case is when you are serving an application from the URI (for example, `mydomain.com/app`). In this case, the `app` may be hosted on a different server or by a third party. A DNS record override allows you to redirect requests to this endpoint to the server for that third-party application.
 
-You must specify a valid hostname in a DNS record override that is a hostname on the same Cloudflare account (possibly on a different zone).
+:::note
+
+- You must specify a valid hostname in a DNS record override that is a hostname on the same Cloudflare account (possibly on a different zone). You can [configure a DNS record](/dns/manage-dns-records/how-to/create-dns-records#create-dns-records) (a `CNAME`, `A`, or `AAAA` record) with a hostname pointing to a third-party hostname/IP address, either proxied by Cloudflare or not.
 
-You can [configure a DNS record](/dns/manage-dns-records/how-to/create-dns-records#create-dns-records) (a `CNAME`, `A`, or `AAAA` record) with a hostname pointing to a third-party hostname/IP address, either proxied by Cloudflare or not.
+- In most situations, when you configure a DNS record override you also need to configure a [`Host` header override](#dns-record). The DNS record override handles the rerouting of the request; the `Host` header override updates the `Host` HTTP header value in the request. Defining a `Host` header override will also update the Server Name Indication (SNI) value of the original request to the same value. To set an SNI value different from the `Host` header value, add an [SNI override](#server-name-indication-sni) in the same origin rule or create a separate origin rule for this purpose.
+
+:::
 
 The following example DNS records configure a `resolve.example.com` hostname pointing to an external hostname and IP address using a `CNAME` record and an `A` record, respectively:
 

src/content/docs/rules/origin-rules/parameters.mdx

@@ -17,7 +17,6 @@ Create [different overrides](/rules/origin-rules/features/) by including differe
 | DNS record override / Destination port override | [`origin` object](#dns-record-override-and-destination-port-override-parameters) |
 
 :::note
-
 The same origin rule can have different types of overrides. Refer to [Configuring several overrides in the same rule](#configuring-several-overrides-in-the-same-rule) for a syntax example.
 :::
 

src/content/partials/rules/origin-rules-api-change-host-header.mdx

@@ -4,7 +4,7 @@
 
 import { APIRequest } from "~/components";
 
-The following example sets the rules of an existing phase ruleset (`$RULESET_ID`) to a single origin rule — overriding the HTTP `Host` header — using the [Update a zone ruleset](/api/resources/rulesets/methods/update/) operation. The response will contain the complete definition of the ruleset you updated.
+The following example sets the rules of an existing phase ruleset (`$RULESET_ID`) to a single origin rule — overriding the HTTP `Host` header and the resolved DNS record — using the [Update a zone ruleset](/api/resources/rulesets/methods/update/) operation. The response will contain the complete definition of the ruleset you updated.
 
 <APIRequest
 	path="/zones/{zone_id}/rulesets/{ruleset_id}"
@@ -17,6 +17,9 @@ The following example sets the rules of an existing phase ruleset (`$RULESET_ID`
 				action: "route",
 				action_parameters: {
 					host_header: "eu_server.example.net",
+					origin: {
+						host: "eu_server.example.net",
+					},
 				},
 			},
 		],
@@ -37,7 +40,10 @@ The following example sets the rules of an existing phase ruleset (`$RULESET_ID`
 				"version": "1",
 				"action": "route",
 				"action_parameters": {
-					"host_header": "eu_server.example.net"
+					"host_header": "eu_server.example.net",
+					"origin": {
+						"host": "eu_server.example.net"
+					}
 				},
 				"expression": "http.request.uri.path contains \"/eu/\"",
 				"description": "My first origin rule",