Skip to content

Commit c54275c

Browse files
committed
improved language
1 parent da23c75 commit c54275c

File tree

3 files changed

+13
-27
lines changed

3 files changed

+13
-27
lines changed

src/content/docs/pipelines/build-with-pipelines/sources/http.mdx

Lines changed: 0 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -44,18 +44,6 @@ Send data to your pipeline's HTTP endpoint:
4444
curl "https://0e00c5ff09b34d018152af98d06f5a1xvc.pipelines.cloudflare.com/" -d '[{ ...JSON_DATA... }]'
4545
```
4646
47-
## Accepted data formats
48-
Pipelines accept arrays of valid JSON objects. You can send multiple objects in a single request, provided the total data volume is within the [documented limits](/pipelines/platform/limits). Sending data in a different format will result in an error.
49-
50-
For example, you can send data to your pipeline using a curl command like this:
51-
```sh
52-
curl -X POST https://<PIPELINE-ID>.pipelines.cloudflare.com \
53-
-H "Content-Type: application/json" \
54-
-d '[{"foo":"bar"}, {"foo":"bar"}, {"foo":"bar"}]'
55-
56-
{"success":true,"result":{"committed":3}}
57-
```
58-
5947
## Authentication
6048
You can secure your HTTP ingestion endpoint using Cloudflare API tokens. By default, authentication is turned off. To configure authentication, use the `--require-http-auth` flag while creating or updating a pipeline.
6149

src/content/docs/pipelines/build-with-pipelines/sources/index.mdx

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,11 +7,13 @@ sidebar:
77
hideIndex: false
88
---
99

10-
Pipelines supports the following sources:
10+
Pipelines let you ingest data from the following sources:
1111
* [HTTP Clients](/pipelines/build-with-pipelines/sources/http), with optional authentication and CORS settings
1212
* [Cloudflare Workers](/workers/), using the [Pipelines Workers API](/pipelines/build-with-pipelines/sources/workers-apis)
1313

14-
Multiple sources can be active on a single pipeline simultaneously. For example, you can create a pipeline which accepts data from Workers and via HTTP. There is no limit to the number of source clients. Multiple workers can be configured to send data to the same pipeline.
14+
Multiple sources can be active on a single pipeline simultaneously. For example, you can create a pipeline which accepts data from Workers and via HTTP. There is no limit to the number of source clients. Multiple Workers can be configured to send data to the same pipeline.
15+
16+
Each pipeline can ingest up to 100 MB/s of data, or accept up to 100,000 requests per second, across all sources.
1517

1618
## Configuring allowed sources
1719
By default, ingestion via HTTP and from Workers is turned on. You can configure the allowed sources by using the `--source` flag while creating or updating a pipeline.
@@ -21,6 +23,5 @@ For example, to create a pipeline which only accepts data via a Worker, you can
2123
$ npx wrangler pipelines create [PIPELINE-NAME] --r2-bucket [R2-BUCKET-NAME] --source worker
2224
```
2325

24-
:::note
25-
HTTP ingestion URLs are tied to your pipeline ID. Turning HTTP off, and then turning it back on, will not change the URL.
26-
:::
26+
## Accepted data formats
27+
Pipelines accept arrays of valid JSON objects. You can send multiple objects in a single request, provided the total data volume is within the [documented limits](/pipelines/platform/limits). Sending data in a different format will result in an error.

src/content/docs/pipelines/build-with-pipelines/sources/workers-apis.mdx

Lines changed: 7 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ head:
1111

1212
import { Render, PackageManagers, WranglerConfig } from "~/components";
1313

14-
Pipelines exposes an API directly to your [Workers](/workers) scripts via the [bindings](/workers/runtime-apis/bindings/#what-is-a-binding) concept. Bindings allow you to securely send data to a Pipeline without having to manage API keys or clients. Sending data via a Worker is enabled by default.
14+
Pipelines exposes an API directly to your [Workers](/workers) scripts via the [bindings](/workers/runtime-apis/bindings/#what-is-a-binding) concept. Bindings allow you to securely send data to a pipeline without having to manage API keys or clients. Sending data via a Worker is enabled by default.
1515

1616
## Send data from a Worker
1717
### Setup a binding
@@ -27,15 +27,15 @@ compatibility_date = "2025-04-01"
2727

2828
[[pipelines]]
2929
pipeline = "<MY-PIPELINE-NAME>" # The name of your Pipeline
30-
binding = "MY_PIPELINE" # The binding name, accessed using env.MY_PIPELINE
30+
binding = "PIPELINE" # The binding name, accessed using env.MY_PIPELINE
3131
```
3232

3333
</WranglerConfig>
3434

3535
You can bind multiple pipelines to a Worker.
3636

3737
### Send data
38-
The pipelines binding exposes a `send()` method. For example, to log inbound HTTP requests to your Worker:
38+
The Pipelines binding exposes a `send()` method. For example, to log inbound HTTP requests to your Worker:
3939

4040
```ts
4141
export default {
@@ -51,12 +51,9 @@ export default {
5151
} satisfies ExportedHandler<Env>;
5252
```
5353

54-
## Accepted data formats
55-
Pipelines accept arrays of valid JSON objects. You can send multiple objects in a single request, provided the total data volume is within the [documented limits](/pipelines/platform/limits). Sending data in a different format will result in an error.
56-
5754
## Workers API
5855
### `Pipeline`
59-
A binding which allows a Worker to send messages to a Pipeline.
56+
A binding which allows a Worker to send messages to a pipeline.
6057

6158
```ts
6259
interface Pipeline<PipelineRecord> {
@@ -66,9 +63,9 @@ interface Pipeline<PipelineRecord> {
6663

6764
* `send(records)`: `Promise<void>`
6865

69-
* Sends a record to the Pipeline. The body must be an array of objects which are JSON serializable.
70-
* When the promise resolves, the message is confirmed to be stored by the pipeline.
66+
* Sends records to the pipeline. The body must be an array of objects which are JSON serializable.
67+
* When the promise resolves, the records are confirmed to be ingested.
7168

7269
:::note
73-
When running your Worker locally, Pipelines are partially simulated. Worker code which sends data to a pipeline will execute successfully. However, the full pipeline, including batching & writing to R2, will not be executed locally.
70+
When running your Worker locally, pipelines are partially simulated. Worker code which sends data to a pipeline will execute successfully. However, the full pipeline, including batching & writing to R2, will not be executed locally.
7471
:::

0 commit comments

Comments
 (0)