Skip to content

Commit 6875b60

Browse files
authored
Update reserved-capacity.md
1 parent 8fd1b47 commit 6875b60

File tree

1 file changed

+19
-24
lines changed

1 file changed

+19
-24
lines changed

articles/cosmos-db/reserved-capacity.md

Lines changed: 19 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -20,11 +20,11 @@ You can buy Azure Cosmos DB reserved capacity from the [Azure portal](https://po
2020

2121
The size of the reserved capacity purchase should be based on the total amount of throughput that the existing or soon-to-be-deployed Azure Cosmos DB resources will use on an hourly basis. For example: Purchase 10,000 RU/s reserved capacity if that's your consistent hourly usage pattern.
2222

23-
In this example, any provisioned throughput above 10,000 RU/s will be billed using your Pay-as-you-go rate. If provisioned throughput is below 10,000 RU/s in an hour, then the extra reserved capacity for that hour will be wasted.
23+
In this example, any provisioned throughput above 10,000 RU/s will be billed using your Pay-as-you-go rate. If the provisioned throughput is below 10,000 RU/s in an hour, then the extra reserved capacity for that hour will be wasted.
2424

2525
Please note that:
2626
* There is no limit to the number of reservations.
27-
* You don't need to purchase all reservations in the same day. You can buy more reservations at any moment
27+
* You don't need to purchase all the reservations in the same day. You can buy more reservations at any moment
2828
* You can combine different reservations in the same purchase.
2929

3030
After you buy a reservation, it's applied immediately to any existing Azure Cosmos DB resources that match the terms of the reservation. If you don’t have any existing Azure Cosmos DB resources, the reservation will apply when you deploy a new Azure Cosmos DB instance that matches the terms of the reservation. In both cases, the period of the reservation starts immediately after a successful purchase.
@@ -69,14 +69,9 @@ Reserved capacity is consumed by standard database operations at a rate of 100 R
6969

7070
## Discounts
7171

72-
Azure Cosmos DB reserved capacity can significantly reduce your Azure Cosmos DB costs, up to 63% on regular prices, with a one-year or three-year upfront commitment. Reserved capacity provides a billing discount and doesn't affect the runtime state of your Azure Cosmos DB resources, including performance and availability.
72+
Azure Cosmos DB reserved capacity can significantly reduce your Azure Cosmos DB costs, up to 63% on regular prices, with a one-year or three-year upfront commitment. Reserved capacity provides a billing discount and doesn't affect the state of your Azure Cosmos DB resources, including performance and availability.
7373

74-
Reserved capacity has two different discount modes:
75-
76-
* Fixed discounts when you buy less than one million RU/s, using multiples of the 100 RU/s SKU. You can buy from 1 to 9999 units of this SKU.
77-
* Progressive discounts when you one million RU/s or more, using multiple units of the 1 to 30 millions SKUs. You can buy from 1 to 9999 units of these SKU.
78-
79-
Please note that you can mix and match any reservations options and sizes in the same purchase.
74+
We offer both fixed and progressive discounts options. Please note that you can mix and match different reservations options and sizes in the same purchase.
8075

8176
### Fixed discounts reservations
8277

@@ -116,17 +111,17 @@ This option, using multiples of our bigger reservation sizes, allows you to rese
116111
| 30,000,000 RU/s | 43.4% | 58.3% |
117112
| 30,000,000 Multi-master RU/s | 48.4% | 63.3% |
118113

119-
You can maximize savings with the biggest reservation for your scenario. Example: You need 2 million RU/s, one year term. If you purchase 2 units of the 1,000,000 RU/s SKU, your discount will be 27.0%. If you purchase 1 unit of the 2,000,000 RU/s SKU, you will have exactly the same reserved capacity, but a 28.5% discount.
114+
You can maximize savings with the biggest reservation for your scenario. Example: You need 2 million RU/s, one year term. If you purchase 2 units of the 1,000,000 RU/s reservation, your discount will be 27.0%. If you purchase 1 unit of the 2,000,000 RU/s reservation, you will have exactly the same reserved capacity, but a 28.5% discount.
120115

121116
Please [create a support request](https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/newsupportrequest) to purchase any quantity of the reservations bigger than 1,000,000 RU/s.
122117

123118
## Sample Scenario 1
124119

125-
Imagine this hypothetical scenario: A company is working ón a new application but isn't sure about the throughput requirements.
120+
Imagine this hypothetical scenario: A company is working on a new application but isn't sure about the throughput requirements.
126121

127122
* On day 1 they purchased reserved capacity for their DEV/Test environment:
128-
* Total of 800 RU/s, or 8 units of the 100 RU/s SKU.
129-
* Scoped to the dev test resoure group.
123+
* Total of 800 RU/s, or 8 units of the 100 RU/s reservation.
124+
* Scoped to the dev test resource group.
130125
* One year term, since the project will be ready in 9 months.
131126
* Paid upfront, since it's a small value.
132127
* On day 30 they purchased reserved capacity for their QA environment:
@@ -135,7 +130,7 @@ Imagine this hypothetical scenario: A company is working ón a new application b
135130
* One year term, since the project will be ready in 9 months.
136131
* Paid monthly.
137132
* On day 180 they purchased reserved capacity for the production environment:
138-
* 3,500,000 RU/s, as suggested by their load test. That's 1 unit of the 3 million RU/s and 500 units of the 100 RU/s SKU.
133+
* 3,500,000 RU/s, as suggested by their load test. That's 1 unit of the 3 million RU/s and 500 units of the 100 RU/s reservation.
139134
* Scoped to the production subscription.
140135
* Three-years term, to maximize the discounts.
141136
* Paid Monthly.
@@ -144,13 +139,13 @@ Imagine this hypothetical scenario: A company is working ón a new application b
144139

145140
Imagine this hypothetical scenario: A company needs a 10,950,000 three-years reservation. In the same purchase they got:
146141

147-
* One unit of the 10,000,000 RU/s SKU, paid monthly.
148-
* 9000 units of the 100 RU/s SKU, paid monthly.
149-
* 500 units of the 100 RU/s SKU, paid upfront.
142+
* One unit of the 10,000,000 RU/s reservation, paid monthly.
143+
* 9000 units of the 100 RU/s reservation, paid monthly.
144+
* 500 units of the 100 RU/s reservation, paid upfront.
150145

151146
## Determine the required throughput before purchase
152147

153-
We calculate purchase recommendations based on your hourly usage pattern. Usage over last 7, 30 and 60 days is analyzed, and reserved capacity purchase that maximizes your savings is recommended. You can view recommended reservation sizes in the Azure portal using the following steps:
148+
We calculate purchase recommendations based on your hourly usage pattern. Usage over the last 7, 30, and 60 days is analyzed, and reserved capacity purchase that maximizes your savings is recommended. You can view recommended reservation sizes in the Azure portal using the following steps:
154149

155150
1. Sign in to the [Azure portal](https://portal.azure.com).
156151

@@ -162,7 +157,7 @@ We calculate purchase recommendations based on your hourly usage pattern. Usage
162157

163158
You can filter recommendations by the following attributes:
164159

165-
- **Term** (1 year or 3 years)
160+
- **Term** (One year or Three years)
166161
- **Billing frequency** (Monthly or Upfront)
167162
- **Throughput Type** (RU/s vs multi-region write RU/s)
168163

@@ -172,14 +167,14 @@ Here's an example recommendation:
172167

173168
:::image type="content" source="./media/reserved-capacity/reserved-capacity-recommendation.png" alt-text="Reserved Capacity recommendations":::
174169

175-
This recommendation to purchase a 30,000 RU/s reservation indicates that, among 3 year reservations, a 30,000 RU/s reservation size will maximize savings. In this case, the recommendation is calculated based on the past 30 days of Azure Cosmos DB usage. If this customer expects that the past 30 days of Azure Cosmos DB usage is representative of future use, they would maximize savings by purchasing a 30,000 RU/s reservation.
170+
This recommendation to purchase a 30,000 RU/s reservation indicates that, among three year reservations, a 30,000 RU/s reservation size will maximize savings. In this case, the recommendation is calculated based on the past 30 days of Azure Cosmos DB usage. If this customer expects that the past 30 days of Azure Cosmos DB usage is representative of future use, they will maximize savings by purchasing a 30,000 RU/s reservation.
176171

177172
For a 30,000 RU/s reservation, in standard provisioned throughput, you should buy 300 units of the 100 RU/s option.
178173

179174

180175
## Buy Azure Cosmos DB reserved capacity
181176

182-
1. Devide the reservation size you want by 100 to calculate the number of units of the 100 RU/s SKU you need. The maximum quantity is 9999 units, or 999,900 RU/s. For one million RU/s or more, [create a support request](https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/newsupportrequest) for up to 63% discounts.
177+
1. Divide the reservation size you want by 100 to calculate the number of units of the 100 RU/s SKU you need. The maximum quantity is 9999 units, or 999,900 RU/s. For one million RU/s or more, [create a support request](https://portal.azure.com/#blade/Microsoft_Azure_Support/HelpAndSupportBlade/newsupportrequest) for up to 63% discounts.
183178

184179
2. Sign in to the [Azure portal](https://portal.azure.com).
185180

@@ -196,11 +191,11 @@ For a 30,000 RU/s reservation, in standard provisioned throughput, you should bu
196191
|Subscription | Subscription that's used to pay for the Azure Cosmos DB reserved capacity. The payment method on the selected subscription is used in charging the costs. The subscription must be one of the following types: <br/><br/> Enterprise Agreement (offer numbers: MS-AZR-0017P or MS-AZR-0148P): For an Enterprise subscription, the charges are deducted from the enrollment's Azure Prepayment (previously called monetary commitment) balance or charged as overage. <br/><br/> Individual subscription with pay-as-you-go rates (offer numbers: MS-AZR-0003P or MS-AZR-0023P): For an individual subscription with pay-as-you-go rates, the charges are billed to the credit card or invoice payment method on the subscription. |
197192
| Resource Group | Resource group to which the reserved capacity discount is applied. |
198193
|Term | One year or three years. |
199-
|Throughput Type | Throughput is provisioned as request units. You can buy a reservation for the provisioned throughput for both setups - single region writes as well as multiple region writes. The throughput type has two values to choose from: 100 RU/s per hour and 100 multi-region writes RU/s per hour.|
194+
|Throughput Type | Throughput is provisioned as request units. You can buy a reservation for the provisioned throughput for both setups - single region writes as well as multi-master writes. The throughput type has two values to choose from: 100 RU/s per hour and 100 multi-region writes RU/s per hour.|
200195
| Reserved Capacity Units| The amount of throughput that you want to reserve. You can calculate this value by determining the throughput needed for all your Azure Cosmos DB resources (for example, databases or containers) per region. You then multiply it by the number of regions that you'll associate with your Azure Cosmos DB database. For example: If you have five regions with 1 million RU/sec in every region, select 5 million RU/s for the reservation capacity purchase. |
201196

202197

203-
6. Click on the **Add to cart** blue button on the lower righ corner, and then on **View Cart** when you are done. The quantities are defined next. Please note that you can add different options to the cart. Example: If you need 1,100,000 RU/s, you should add both the 1,000,000 RU/s and the 100 RU/s SKUs to the cart.
198+
6. Click on the **Add to cart** blue button on the lower right corner, and then on **View Cart** when you are done. The quantities are defined next. Please note that you can add different options to the cart. Example: If you need 1,100,000 RU/s, you should add both the 1,000,000 RU/s and the 100 RU/s SKUs to the cart.
204199

205200
7. In the **Purchase reservations** pane, review the billing frequency, the quantity, the discount, and the price of the reservation. This reservation price applies to Azure Cosmos DB resources with throughput provisioned across all regions. Example: If you need 1,100,000 RU/s for one region, you should set the 1,000,000 RU/s option quantity to 1 and the 100 RU/s option quantity to 1000. But if you need 1,100,000 RU/s in each region, and you have 2 regions, then the total should be 2,200,000 RU/s. And for 2,2 million RU/s, the best option is one unit of the two million RU/s option and 2000 units of the 100 RU/s option.
206201

@@ -214,7 +209,7 @@ You can cancel, exchange, or refund reservations with certain limitations. For m
214209

215210
## Exceeding reserved capacity
216211

217-
When you reserve capacity for your Azure Cosmos DB resources, you are reserving [provisioned throughput](set-throughput.md). If the provisioned throughput is exceeded, requests beyond that provisioning will be billed using pay-as-you go rates. For more information on reservations, see the [Azure reservations](../cost-management-billing/reservations/save-compute-costs-reservations.md) article. For more information on provisioned throughput, see [provisioned throughput types](how-to-choose-offer.md#overview-of-provisioned-throughput-types).
212+
When you reserve capacity for your Azure Cosmos DB resources, you are reserving [provisioned throughput](set-throughput.md). If the provisioned throughput is exceeded, requests beyond that provisioning amount will be billed using pay-as-you go rates. For more information on reservations, see the [Azure reservations](../cost-management-billing/reservations/save-compute-costs-reservations.md) article. For more information on provisioned throughput, see [provisioned throughput types](how-to-choose-offer.md#overview-of-provisioned-throughput-types).
218213

219214
## Limitations
220215

0 commit comments

Comments
 (0)