Skip to content

Commit a953b5e

Browse files
Style guide adjustments
1 parent 8caa198 commit a953b5e

File tree

2 files changed

+19
-17
lines changed

2 files changed

+19
-17
lines changed

src/content/docs/byoip/service-bindings/index.mdx

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -9,32 +9,34 @@ sidebar:
99
description: In IP address management, service binding refers to the association of IPs to specific Cloudflare services. Review the available options and the API endpoints to set up service bindings.
1010
---
1111

12-
Service Bindings are effectively mappings that control whether traffic destined for a given IP address is routed to Magic Transit, the CDN pipeline (Layer 7 HTTP-based), or Spectrum (Layer 4 or Layer 7 HTTP with custom ports) pipeline.
12+
Service Bindings are mappings that control whether traffic destined for a given IP address is routed to Magic Transit, the CDN pipeline (Layer 7 HTTP-based), or Spectrum pipeline (Layer 4 or Layer 7 HTTP with custom ports).
1313

1414
:::note
1515
Service binding operations are currently only available via API. You can find all endpoints and their specifications in the [Cloudflare API documentation](/api/operations/ip-address-management-service-bindings-list-service-bindings).
1616
:::
1717

1818
## Scope
1919

20-
Customers using BYOIP with Magic Transit can leverage the Service Binding API endpoint to selectively route traffic through the CDN (Layer 7 HTTP-based) or Spectrum (Layer 4 and Layer 7 HTTP with custom ports) pipelines on a per-IP address basis.
20+
Customers using BYOIP with Magic Transit can leverage the [service binding API endpoints](/api/operations/ip-address-management-service-bindings-list-service-bindings) to selectively route traffic through the CDN (Layer 7 HTTP-based) or Spectrum (Layer 4 and Layer 7 HTTP with custom ports) pipelines on a per-IP address basis.
2121

2222
You can upgrade individual IPs within a Magic Transit prefix to either a CDN IP or a Spectrum IP. For example, if you have `203.0.113.0/24`, you can upgrade `203.0.113.1` to CDN and `203.0.113.2` to Spectrum.
2323

24-
Magic Transit customers must ensure their contract is entitled to use CDN and/or Spectrum services commensurate.
24+
:::caution
25+
Magic Transit customers must ensure that their contract allows them to use CDN and/or Spectrum services to the desired extent.
26+
:::
2527

2628
### CDN (Cache)
2729

28-
When a Service Binding of type CDN is applied, once the change has propagated across Cloudflare's global network (four to six hours), any HTTP requests are directed into the CDN pipeline (for Layer 7 processing).
30+
When a service binding of type `CDN` is applied, once the change has propagated across Cloudflare's global network (four to six hours), any HTTP requests are directed into the CDN pipeline for Layer 7 processing.
2931

30-
Refer to Use BYOIP with Magic Transit and CDN to learn how to set this up.
32+
Refer to [Use BYOIP with Magic Transit and CDN](/byoip/service-bindings/magic-transit-with-cdn/) for detailed guidance.
3133

3234
### Spectrum
3335

34-
When a Service Binding of type Spectrum is applied, once the change has propagated across Cloudflare's global network (four to six hours), any TCP/UDP/HTTP requests are directed into the Spectrum pipeline for Layer 4 or Layer 7 processing.
36+
When a service binding of type `Spectrum` is applied, once the change has propagated across Cloudflare's global network (four to six hours), any TCP/UDP/HTTP requests are directed into the Spectrum pipeline for Layer 4 or Layer 7 processing.
3537

3638
## Limitations
3739

3840
- You must keep Magic Transit as a common base service, spanning all addresses in your prefix.
39-
- When adding a Service Binding for a given IP address, it must be either a CDN Service Binding or a Spectrum Service Binding. It is not possible (or necessary) to bind both services.
40-
- Once a Service Binding is created (or deleted), it will take four to six hours to propagate across Cloudflare's Global Network. Services for the IP address(es) in scope will likely be disrupted during this window.
41+
- When adding a service binding for a given IP address, it must be either a CDN service binding or a Spectrum service binding. It is not possible (or necessary) to bind both services.
42+
- Once a service binding is created (or deleted), it will take four to six hours to propagate across Cloudflare's Global Network. Services for the IP addresses in scope will likely be disrupted during this window.

src/content/docs/byoip/service-bindings/magic-transit-with-cdn.mdx

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -11,15 +11,15 @@ import { Details, Example, TabItem, Tabs, GlossaryTooltip } from "~/components";
1111

1212
[Magic Transit](/magic-transit/) customers using [BYOIP](/byoip/) can also benefit from the performance, reliability, and security that Cloudflare offers for HTTP-based applications.
1313

14-
This documentation covers using the Cloudflare API to configure Service Bindings within Cloudflare's IP Address Management framework. Service Bindings allow BYOIP customers to selectively route traffic on a per-IP address basis to the CDN pipeline (Caching, WAF, etc).
14+
This documentation covers using the Cloudflare API to configure service bindings within Cloudflare's IP Address Management framework. Service bindings allow BYOIP customers to selectively route traffic on a per-IP address basis to the CDN pipeline (which includes [Cache](/cache/), [WAF](/waf/), and more).
1515

16-
It is also possible to define Service Bindings to route traffic to the Spectrum pipeline selectively; however, that will be covered elsewhere.
16+
It is also possible to define service bindings to route traffic to the Spectrum pipeline selectively. However, this is not in the scope of this guide.
1717

18-
It is important to note that traffic routed to the CDN pipeline is protected at Layers 3 and 4 by the inherent DDoS Protection capabilities native to the CDN pipeline.
18+
It is important to note that traffic routed to the CDN pipeline is protected at Layers 3 and 4 by the inherent DDoS protection capabilities native to the CDN pipeline.
1919

2020
## Before you begin
2121

22-
Efficiency is paramount when planning how you will implement Service Bindings. Implementing Service Bindings through an aggregated CIDR block is strongly recommended.
22+
Efficiency is paramount when planning how you will implement service bindings. Implementing service bindings through an aggregated CIDR block is strongly recommended.
2323

2424
<Details header="Example" >
2525

@@ -36,11 +36,11 @@ Efficiency is paramount when planning how you will implement Service Bindings. I
3636
`203.0.113.22`
3737
`203.0.113.23`
3838

39-
**Best practice:** Add one discrete CDN Service Binding for `203.0.113.16` with a `/29` netmask.
39+
**Best practice:** Add one discrete CDN service binding for `203.0.113.16` with a `/29` netmask.
4040

4141
</Details>
4242

43-
Once a Service Binding is created (or deleted), it will take four to six hours to propagate across Cloudflare's Global Network. Services for the IP address(es) in scope will likely be disrupted during this window.
43+
Once a service binding is created (or deleted), it will take four to six hours to propagate across Cloudflare's global network. Services for the IP addresses in scope will likely be disrupted during this window.
4444

4545

4646
## 1. Get account information
@@ -74,10 +74,10 @@ curl https://api.cloudflare.com/client/v4/accounts/{account_id}/addressing/prefi
7474
## 2. Create service binding
7575

7676
:::caution[Caution]
77-
Once a Service Binding is created (or deleted), it will take four to six hours to propagate across Cloudflare's Global Network. Services for the IP address(es) in scope will likely be disrupted during this window.
77+
Once a service binding is created (or deleted), it will take four to six hours to propagate across Cloudflare's global network. Services for the IP addresses in scope will likely be disrupted during this window.
7878
:::
7979

80-
1. Make a `POST` request to the [Create Service Binding](/api/operations/ip-address-management-service-bindings-create-service-binding/) endpoint, indicating the IP address you want to bind to the CDN. Specify the **corresponding network mask** as needed.
80+
1. Make a `POST` request to the [Create service binding](/api/operations/ip-address-management-service-bindings-create-service-binding/) endpoint, indicating the IP address you want to bind to the CDN. Specify the **corresponding network mask** as needed.
8181

8282
<Example>
8383

@@ -116,7 +116,7 @@ In the response body, the initial provisioning state should be `provisioning`.
116116
```
117117
</Example>
118118

119-
You can periodically check the Service Binding status using the [List Service Bindings](/api/operations/ip-address-management-service-bindings-list-service-bindings) endpoint.
119+
You can periodically check the service binding status using the [List Service Bindings](/api/operations/ip-address-management-service-bindings-list-service-bindings) endpoint.
120120

121121
## 3. Create address maps
122122

0 commit comments

Comments
 (0)