Update reserved-capacity.md

Author: Rodrigossz

articles/cosmos-db/reserved-capacity.md

@@ -16,16 +16,16 @@ Azure Cosmos DB reserved capacity helps you save money by committing to a reserv
 
 ## Overview
 
-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. 
+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 use on an hourly basis. For example: Purchase 10,000 RU/s reserved capacity if that is your consistent hourly usage pattern. 
 
-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.
+In this example, any provisioned throughput above 10,000 RU/s is billed with 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 is wasted.
 
 Please note that:
  * There is no limit to the number of reservations.
- * You don't need to purchase all the reservations in the same day. You can buy more reservations at any moment
- * You can combine different reservations in the same purchase.
+ * It's possible to buy more reservations at any moment.
+ * It's possible to buy different reservations in the same purchase.
 
-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.
+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 applies 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.
 
 When your reservation expires, your Azure Cosmos DB instances continue to run and are billed at the regular pay-as-you-go rates.
 You can buy Azure Cosmos DB reserved capacity from the [Azure portal](https://portal.azure.com). Pay for the reservation [upfront or with monthly payments](../cost-management-billing/reservations/prepare-buy-reservation.md). 
@@ -44,7 +44,7 @@ As soon as you buy a reservation, the throughput charges that match the reservat
 
 ### Autoscale provisioned throughput
 
-Reserved capacity is consumed by autoscale database operations at a rate of 100 RU/s x 1.5 x N regions. For the usable net RU/s per region of a reservation, the formula is inverted. Examples:
+Autoscale database operations consume reserved capacity at a rate of 100 RU/s x 1.5 x N regions. For the usable net RU/s per region of a reservation, the formula is inverted. Examples:
 
 | Scenario | Autoscale Rate | Regions |Formula | Net RU/s per region|
 |----------|---------|----------|---------|---------|
@@ -56,7 +56,7 @@ Reserved capacity is consumed by autoscale database operations at a rate of 100
 
 ### Standard provisioned throughput
 
-Reserved capacity is consumed by standard database operations at a rate of 100 RU/s x N regions. For the usable net RU/s per region of a reservation, the formula is inverted. Examples:
+Standard database operations consume reserved capacity at a rate of 100 RU/s x N regions. For the usable net RU/s per region of a reservation, the formula is inverted. Examples:
 
 | Scenario |  Regions |Formula | Net RU/s per region|
 |----------|----------|---------|---------|
@@ -70,7 +70,7 @@ Reserved capacity is consumed by standard database operations at a rate of 100 R
 
 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.
 
-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.
+We offer both fixed and progressive discounts options. Note that you can mix and match different reservations options and sizes in the same purchase.
 
 ### Fixed discounts reservations
 
@@ -81,7 +81,7 @@ This option, using multiples of the 100 RU/s, allows you to reserve any capacity
 | 100 RU/s |  20% | 30% |
 | 100 Multi-master RU/s |  20% | 30% |
 
-Note that for more than 999,900 RU/s reservations, you can reduce costs with progressive discounts.
+For more than 999,900 RU/s reservations, you can reduce costs with progressive discounts.
 
 ### Progressive discounts reservations
 
@@ -112,26 +112,26 @@ This option, using multiples of our bigger reservation sizes, allows you to rese
 | 30,000,000 RU/s | 43.4% | 58.3% |
 | 30,000,000 Multi-master RU/s | 48.4% | 63.3% |
 
-Note that 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.
+You can maximize savings with the biggest reservation for your scenario. Example: You need 2 million RU/s, one year term. If you purchase two units of the 1,000,000 RU/s reservation, your discount is 27.0%. If you purchase one unit of the 2,000,000 RU/s reservation, you have exactly the same reserved capacity, but a 28.5% discount.
 
-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.
+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.
 
 ## Sample scenario 1
 
 Imagine this hypothetical scenario: A company is working on a new application but isn't sure about the throughput requirements, they purchased RU/s on 3 different days.
 
 * On day 1 they purchased reserved capacity for their DEV/Test environment:
-  * Total of 800 RU/s, or 8 units of the 100 RU/s reservation. 
+  * Total of 800 RU/s: eight units of the 100 RU/s option, with a 20% discount. 
   * Scoped to the dev test resource group.
-  * One year term, since the project will be ready in 9 months.
+  * One year term, since the project lasts for nine months.
   * Paid upfront, since it's a small value.
-* On day 30 they purchased reserved capacity for their QA environment:
-  * 750,000 RU/s for load tests.
+* On day 30 they purchased reserved capacity for their tests environment:
+  * 750,000 RU/s: 7,500 units of the 100 RU/s option, with a 20% discount.
   * Scoped to the subscription, so that dev/test environment is also beneficiated.
-  * One year term, since the project will be ready in 9 months.
+  * One year term.
   * Paid monthly.
 * On day 180 they purchased reserved capacity for the production environment:
-  * 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.
+  * 3,500,000 RU/s: One unit of the 3,000,000 RU/s option, with a 43.2% discount. And 5,000 units of the 100 RU/s option, with a 20% discount.
   * Scoped to the production subscription.
   * Three-years term, to maximize the discounts.
   * Paid Monthly.
@@ -141,7 +141,7 @@ Imagine this hypothetical scenario: A company is working on a new application bu
 Imagine this hypothetical scenario: A company needs a 10,950,000 three-years reservation. In the same purchase they got:
 
  * One unit of the 10,000,000 RU/s reservation, paid monthly.
- * 9000 units of the 100 RU/s reservation, paid monthly.
+ * 9,000 units of the 100 RU/s reservation, paid monthly.
  * 500 units of the 100 RU/s reservation, paid upfront.
 
 ## Determine the required throughput before purchase
@@ -168,14 +168,14 @@ Here's an example recommendation:
 
 :::image type="content" source="./media/reserved-capacity/reserved-capacity-recommendation.png" alt-text="Reserved Capacity recommendations":::
 
-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.
+This recommendation to purchase a 30,000 RU/s reservation indicates that, among three year reservations, a 30,000 RU/s reservation size maximizes your savings. In this case, the recommendation is calculated based on the past 30 days of Azure Cosmos DB usage. If this recommendation, based on the past 30 days of Azure Cosmos DB usage, isn't representative of future use, then choose another recommendation period.
 
 For a 30,000 RU/s reservation, in standard provisioned throughput, you should buy 300 units of the 100 RU/s option.
 
 
 ## Buy Azure Cosmos DB reserved capacity
 
-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.
+1. Divide the reservation size you want by 100 to calculate the number of units of the 100 RU/s option you need. The maximum quantity is 9,999 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.
 
 2. Sign in to the [Azure portal](https://portal.azure.com).
 
@@ -189,16 +189,16 @@ For a 30,000 RU/s reservation, in standard provisioned throughput, you should bu
    |Field  |Description  |
    |---------|---------|
    |Scope   |  	Option that controls how many subscriptions can use the billing benefit associated with the reservation. It also controls how the reservation is applied to specific subscriptions. <br/><br/>  If you select **Shared**, the reservation discount is applied to Azure Cosmos DB instances that run in any subscription within your billing context. The billing context is based on how you signed up for Azure. For enterprise customers, the shared scope is the enrollment and includes all subscriptions within the enrollment. For pay-as-you-go customers, the shared scope is all individual subscriptions with pay-as-you-go rates created by the account administrator. </br></br>If you select **Management group**, the reservation discount is applied to Azure Cosmos DB instances that run in any of the subscriptions that are a part of both the management group and billing scope. <br/><br/>  If you select **Single subscription**, the reservation discount is applied to Azure Cosmos DB instances in the selected subscription. <br/><br/> If you select **Single resource group**, the reservation discount is applied to Azure Cosmos DB instances in the selected subscription and the selected resource group within that subscription. <br/><br/> You can change the reservation scope after you buy the reserved capacity.  |
-   |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.    |
+   |Subscription  |   Subscription 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.    |
    | Resource Group | Resource group to which the reserved capacity discount is applied. |
    |Term  |   One year or three years.   |
-   |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.|
-   | 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. |
+   |Throughput Type   |  Throughput is provisioned as request units. You can buy a reservation for the provisioned throughput for both setups - single region writes and 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.|
+   | 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 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. |
 
 
-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. 
+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. 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 options to the cart. 
 
-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: You need 500,000 RU/s with auto-renew for your production environemnt within a specific scope, 82,000 RU/s for your Q&A resource group, and 10,000 RU/s for the development subscprition. You can see in the image below how your reservations shopping cart will look like.
+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: You need 500,000 RU/s with auto-renew for your production environemnt within a specific scope, 82,000 RU/s for your tests resource group, and 10,000 RU/s for the development subscprition. You can see in the image how a reservations shopping cart looks like for this scenario.
 
    :::image type="content" source="./media/reserved-capacity/reserved-capacity-summary.png" alt-text="Reserved capacity summary":::
 
@@ -210,7 +210,7 @@ You can cancel, exchange, or refund reservations with certain limitations. For m
 
 ## Exceeding reserved capacity
 
-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).
+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 are 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).
 
 ## Limitations