Skip to content

Commit 98b510a

Browse files
Oxyjunmarciocloudflareaninibread
authored and
thomasgauvin
committed
[R2] Adding infrequent access storage example (#23224)
* Adding infrequent access storage example * Adding data retrieval row * Adding note on rounding up usage to next billing unit * Adding placeholder table for IA * Updating examples, adding new examples * Clarification + reordering rows to match pricing table * Implementing feedback * Wording consistency update * Update src/content/docs/r2/pricing.mdx Co-authored-by: marciocloudflare <[email protected]> * Apply suggestions from code review Co-authored-by: Anni Wang <[email protected]> --------- Co-authored-by: marciocloudflare <[email protected]> Co-authored-by: Anni Wang <[email protected]>
1 parent a969574 commit 98b510a

File tree

1 file changed

+37
-22
lines changed

1 file changed

+37
-22
lines changed

‎src/content/docs/r2/pricing.mdx‎

Lines changed: 37 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -32,9 +32,19 @@ To learn about potential cost savings from using R2, refer to the [R2 pricing ca
3232
| Data Retrieval (processing) | None | $0.01 / GB |
3333
| Egress (data transfer to Internet) | Free [^1] | Free [^1] |
3434

35+
:::caution[Billable unit rounding]
36+
Cloudflare rounds up your usage to the next billing unit.
37+
38+
For example:
39+
40+
- If you have performed one million and one operations, you will be billed for two million operations.
41+
- If you have used 1.1 GB-month, you will be billed for 2 GB-month.
42+
- If you have retrieved data (for infrequent access storage) for 1.1 GB, you will be billed for 2 GB.
43+
:::
44+
3545
### Free tier
3646

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

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

56+
:::caution
57+
The free tier only applies to Standard storage, and does not apply to Infrequent Access storage.
58+
:::
59+
4660
### Storage usage
4761

4862
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).
@@ -106,41 +120,42 @@ To learn about potential cost savings from using R2, refer to the [R2 pricing ca
106120

107121
## R2 billing examples
108122

109-
### Data storage example 1
123+
### Standard storage example
124+
125+
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:
110126

111-
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:
127+
| | Usage | Free Tier | Billable Quantity | Price |
128+
| --------------------------- | ------------------------------------------------------------- | ------------ | ----------------- | ----------- |
129+
| Storage | (1,000 objects) \* (1 GB per object) = 1,000 GB-months | 10 GB-months | 990 GB-months | $14.85 |
130+
| Class A Operations | (1,000 objects) \* (1 write per object) = 1,000 writes | 1 million | 0 | $0.00 |
131+
| Class B Operations | (1,000 objects) \* (1,000 reads per object) = 1 million reads | 10 million | 0 | $0.00 |
132+
| Data retrieval (processing) | (1,000 objects) \* (1 GB per object) = 1,000 GB | NA | None | $0.00 |
133+
| **TOTAL** | | | | **$14.85** |
112134

113-
| | Usage | Free Tier | Billable Quantity | Price |
114-
| ------------------ | ------------------------------------------- | ------------ | ----------------- | ---------- |
115-
| Class B Operations | (1,000 objects) \* (1,000 reads per object) | 10 million | 0 | $0.00 |
116-
| Class A Operations | (1,000 objects) \* (1 write per object) | 1 million | 0 | $0.00 |
117-
| Storage | (1,000 objects) \* (1 GB per object) | 10 GB-months | 990 GB-months | $14.85 |
118-
| **TOTAL** | | | | **$14.85** |
119-
| | | | | |
135+
### Infrequent access example
120136

121-
### Data storage example 2
137+
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:
122138

123-
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:
139+
| | Usage | Free Tier | Billable Quantity | Price |
140+
| --------------------------- | ------------------------------------------------------------- | ------------ | ----------------- | ----------- |
141+
| Storage | (1,000 objects) \* (1 GB per object) = 1,000 GB-months | NA | 1,000 GB-months | $10.00 |
142+
| Class A Operations | (1,000 objects) \* (1 write per object) = 1,000 writes | NA | 1,000 | $9.00 |
143+
| Class B Operations | (1,000 objects) \* (1,000 reads per object) = 1 million reads | NA | 1 million | $0.90 |
144+
| Data retrieval (processing) | (1,000 objects) \* (1 GB per object) = 1,000 GB | NA | 1,000 GB | $10.00 |
145+
| **TOTAL** | | | | **$29.90** |
124146

125-
| | Usage | Free Tier | Billable Quantity | Price |
126-
| ------------------ | ------------------------------------------- | ------------ | ----------------- | --------- |
127-
| Class B Operations | (1,000 objects) \* (1,000 reads per object) | 10 million | 0 | $0.00 |
128-
| Class A Operations | (1,000 objects) \* (1 write per object) | 1 million | 0 | $0.00 |
129-
| Storage | (10 objects) \* (1 GB per object) | 10 GB-months | 0 | $0.00 |
130-
| **TOTAL** | | | | **$0.00** |
131-
| | | | | |
147+
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.
132148

133149
### Asset hosting
134150

135151
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:
136152

137153
| | Usage | Free Tier | Billable Quantity | Price |
138154
| ------------------ | --------------------------------------- | ------------ | ----------------- | ----------- |
139-
| Class B Operations | (10,000,000 reads per day) \* (30 days) | 10 million | 290,000,000 | $104.40 |
140-
| Class A Operations | (100,000 writes) | 1 million | 0 | $0.00 |
141155
| Storage | (100,000 objects) \* (100KB per object) | 10 GB-months | 0 GB-months | $0.00 |
156+
| Class A Operations | (100,000 writes) | 1 million | 0 | $0.00 |
157+
| Class B Operations | (10,000,000 reads per day) \* (30 days) | 10 million | 290,000,000 | $104.40 |
142158
| **TOTAL** | | | | **$104.40** |
143-
| | | | | |
144159

145160
## Cloudflare billing policy
146161

0 commit comments

Comments
 (0)