Skip to content

Concepts

A logical bucket is a catalog resource. Object bytes live on the configured S3-compatible provider (r2_prefix must be disjoint from the platform prefix). The Worker sees Cloudflare R2 methods through the binding. The same bytes can also be read and written with the provider's S3 API — that is the storage protocol, not the Cloudflare control plane.

Global placement is not provided. Objects sit at the one endpoint / bucket you configured.

put / get / head / delete / list, range, conditionals (etag / time), checksums, multipart, custom metadata, and HTTP metadata match the R2 Workers API.

Compatibility

TopicCloudflareopen-compute
Worker APIR2 Workers APISame: put / get / head / delete / list, range, conditionals, checksums, multipart, metadata
Object bytesCloudflare R2 storageConfigured S3-compatible provider
Global placementAvailableNot provided
Jurisdictional restrictionsAvailableNot provided
Public bucket hostnameCloudflare-hostedNot provided
Platform backupsObject-store PITRCover local SQLite authority, not object-store PITR