Skip to content

[R2] Adding infrequent access storage example #23224

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 10 commits into from
Jul 17, 2025
Merged

[R2] Adding infrequent access storage example #23224

Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
af45d50
Adding infrequent access storage example
Oxyjun Jun 25, 2025
6073ddf
Adding data retrieval row
Oxyjun Jun 25, 2025
2634992
Adding note on rounding up usage to next billing unit
Oxyjun Jun 25, 2025
7941b7f
Adding placeholder table for IA
Oxyjun Jul 3, 2025
4042b59
Updating examples, adding new examples
Oxyjun Jul 8, 2025
2de810e
Clarification + reordering rows to match pricing table
Oxyjun Jul 8, 2025
36a2365
Implementing feedback
Oxyjun Jul 15, 2025
56de263
Wording consistency update
Oxyjun Jul 15, 2025
4d7b2b5
Update src/content/docs/r2/pricing.mdx
Oxyjun Jul 16, 2025
0811e22
Apply suggestions from code review
Oxyjun Jul 17, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
59 changes: 37 additions & 22 deletions src/content/docs/r2/pricing.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,9 +32,19 @@ To learn about potential cost savings from using R2, refer to the [R2 pricing ca
| Data Retrieval (processing) | None | $0.01 / GB |
| Egress (data transfer to Internet) | Free [^1] | Free [^1] |

:::caution[Billable unit rounding]
Cloudflare rounds up your usage to the next billing unit.

For example:

- If you have performed one million and one operations, you will be billed for two million operations.
- If you have used 1.1 GB-month, you will be billed for 2 GB-month.
- If you have retrieved data (for infrequent access storage) for 1.1 GB, you will be billed for 2 GB.
:::

### Free tier

You can use the following amount of storage and operations each month for free. The free tier only applies to Standard storage.
You can use the following amount of storage and operations each month for free.

| | Free |
| ---------------------------------- | --------------------------- |
Expand All @@ -43,6 +53,10 @@ You can use the following amount of storage and operations each month for free.
| Class B Operations | 10 million requests / month |
| Egress (data transfer to Internet) | Free [^1] |

:::caution
The free tier only applies to Standard storage, and does not apply to Infrequent Access storage.
:::

### Storage usage

Storage is billed using gigabyte-month (GB-month) as the billing metric. A GB-month is calculated by averaging the _peak_ storage per day over a billing period (30 days).
Expand Down Expand Up @@ -106,41 +120,42 @@ To learn about potential cost savings from using R2, refer to the [R2 pricing ca

## R2 billing examples

### Data storage example 1
### Standard storage example

If a user writes 1,000 objects in R2 **Standard storage** for 1 month with an average size of 1 GB and reads each object 1,000 times during the month, the estimated cost for the month would be:

If a user writes 1,000 objects in R2 for 1 month with an average size of 1 GB and requests each 1,000 times per month, the estimated cost for the month would be:
| | Usage | Free Tier | Billable Quantity | Price |
| --------------------------- | ------------------------------------------------------------- | ------------ | ----------------- | ----------- |
| Storage | (1,000 objects) \* (1 GB per object) = 1,000 GB-months | 10 GB-months | 990 GB-months | $14.85 |
| Class A Operations | (1,000 objects) \* (1 write per object) = 1,000 writes | 1 million | 0 | $0.00 |
| Class B Operations | (1,000 objects) \* (1,000 reads per object) = 1 million reads | 10 million | 0 | $0.00 |
| Data retrieval (processing) | (1,000 objects) \* (1 GB per object) = 1,000 GB | NA | None | $0.00 |
| **TOTAL** | | | | **$14.85** |

| | Usage | Free Tier | Billable Quantity | Price |
| ------------------ | ------------------------------------------- | ------------ | ----------------- | ---------- |
| Class B Operations | (1,000 objects) \* (1,000 reads per object) | 10 million | 0 | $0.00 |
| Class A Operations | (1,000 objects) \* (1 write per object) | 1 million | 0 | $0.00 |
| Storage | (1,000 objects) \* (1 GB per object) | 10 GB-months | 990 GB-months | $14.85 |
| **TOTAL** | | | | **$14.85** |
| | | | | |
### Infrequent access example

### Data storage example 2
If a user writes 1,000 objects in R2 Infrequent Access storage with an average size of 1 GB, stores them for 5 days, and then deletes them (delete operations are free), and during those 5 days each object is read 1,000 times, the estimated cost for the month would be:

If a user writes 10 objects in R2 for 1 month with an average size of 1 GB and requests 1,000 times per month, the estimated cost for the month would be:
| | Usage | Free Tier | Billable Quantity | Price |
| --------------------------- | ------------------------------------------------------------- | ------------ | ----------------- | ----------- |
| Storage | (1,000 objects) \* (1 GB per object) = 1,000 GB-months | NA | 1,000 GB-months | $10.00 |
| Class A Operations | (1,000 objects) \* (1 write per object) = 1,000 writes | NA | 1,000 | $9.00 |
| Class B Operations | (1,000 objects) \* (1,000 reads per object) = 1 million reads | NA | 1 million | $0.90 |
| Data retrieval (processing) | (1,000 objects) \* (1 GB per object) = 1,000 GB | NA | 1,000 GB | $10.00 |
| **TOTAL** | | | | **$29.90** |

| | Usage | Free Tier | Billable Quantity | Price |
| ------------------ | ------------------------------------------- | ------------ | ----------------- | --------- |
| Class B Operations | (1,000 objects) \* (1,000 reads per object) | 10 million | 0 | $0.00 |
| Class A Operations | (1,000 objects) \* (1 write per object) | 1 million | 0 | $0.00 |
| Storage | (10 objects) \* (1 GB per object) | 10 GB-months | 0 | $0.00 |
| **TOTAL** | | | | **$0.00** |
| | | | | |
Note that the minimal storage duration for infrequent access storage is 30 days, which means the billable quantity is 1,000 GB-months, rather than 167 GB-months.

### Asset hosting

If a user writes 100,000 files with an average size of 100 KB object and reads 10,000,000 objects per day, the estimated cost in a month would be:

| | Usage | Free Tier | Billable Quantity | Price |
| ------------------ | --------------------------------------- | ------------ | ----------------- | ----------- |
| Class B Operations | (10,000,000 reads per day) \* (30 days) | 10 million | 290,000,000 | $104.40 |
| Class A Operations | (100,000 writes) | 1 million | 0 | $0.00 |
| Storage | (100,000 objects) \* (100KB per object) | 10 GB-months | 0 GB-months | $0.00 |
| Class A Operations | (100,000 writes) | 1 million | 0 | $0.00 |
| Class B Operations | (10,000,000 reads per day) \* (30 days) | 10 million | 290,000,000 | $104.40 |
| **TOTAL** | | | | **$104.40** |
| | | | | |

## Cloudflare billing policy

Expand Down