Merge pull request #205184 from seesharprun/free-tier-script

Cosmos DB | Implement free tier script

Author: Court72

articles/cosmos-db/TOC.yml

@@ -177,32 +177,34 @@
        href: ./resource-graph-samples.md
      - name: Azure CLI
        items:
-         - name: Overview common API samples
-           href: common-cli-samples.md
-         - name: Add or fail over regions
-           href: scripts/cli/common/regions.md
-         - name: Perform account key operations
-           href: scripts/cli/common/keys.md
-         - name: Secure with IP firewall
-           href: scripts/cli/common/ipfirewall.md
-         - name: Secure new account with service endpoints
-           href: scripts/cli/common/service-endpoints.md
-         - name: Secure existing account with service endpoints
-           href: scripts/cli/common/service-endpoints-ignore-missing-vnet.md
+        - name: Overview common API samples
+          href: common-cli-samples.md
+        - name: Add or fail over regions
+          href: scripts/cli/common/regions.md
+        - name: Perform account key operations
+          href: scripts/cli/common/keys.md
+        - name: Secure with IP firewall
+          href: scripts/cli/common/ipfirewall.md
+        - name: Secure new account with service endpoints
+          href: scripts/cli/common/service-endpoints.md
+        - name: Secure existing account with service endpoints
+          href: scripts/cli/common/service-endpoints-ignore-missing-vnet.md
+        - name: Find existing free-tier accounts
+          href: scripts/cli/common/free-tier.md
      - name: Azure PowerShell
        items:
-         - name: Overview common API samples
-           href: common-powershell-samples.md
-         - name: Account keys or connection strings
-           href: scripts/powershell/common/keys-connection-strings.md
-         - name: Change failover priority or trigger failover
-           href: scripts/powershell/common/failover-priority-update.md
-         - name: Create an account with IP Firewall
-           href: scripts/powershell/common/firewall-create.md
-         - name: Update account
-           href: scripts/powershell/common/account-update.md
-         - name: Update an account's regions
-           href: scripts/powershell/common/update-region.md
+        - name: Overview common API samples
+          href: common-powershell-samples.md
+        - name: Account keys or connection strings
+          href: scripts/powershell/common/keys-connection-strings.md
+        - name: Change failover priority or trigger failover
+          href: scripts/powershell/common/failover-priority-update.md
+        - name: Create an account with IP Firewall
+          href: scripts/powershell/common/firewall-create.md
+        - name: Update account
+          href: scripts/powershell/common/account-update.md
+        - name: Update an account's regions
+          href: scripts/powershell/common/update-region.md
 - name: How to
   items:
     - name: Free tier

articles/cosmos-db/free-tier.md

@@ -1,48 +1,49 @@
 ---
 title: Azure Cosmos DB free tier 
 description: Use Azure Cosmos DB free tier to get started, develop, test your applications. With free tier, you'll get the first 1000 RU/s and 25 GB of storage in the account for free. 
-author: ThomasWeiss
-ms.author: thweiss
+author: seesharprun
+ms.author: sidandrews
 ms.service: cosmos-db
 ms.topic: how-to
-ms.date: 03/29/2022
+ms.date: 07/08/2022
 ---
 
-# Azure Cosmos DB free tier 
+# Azure Cosmos DB free tier
+
 [!INCLUDE[appliesto-all-apis](includes/appliesto-all-apis.md)]
 
 Azure Cosmos DB free tier makes it easy to get started, develop, test your applications, or even run small production workloads for free. When free tier is enabled on an account, you'll get the first 1000 RU/s and 25 GB of storage in the account for free. The throughput and storage consumed beyond these limits are billed at regular price. Free tier is available for all API accounts with provisioned throughput, autoscale throughput, single, or multiple write regions.
 
 Free tier lasts indefinitely for the lifetime of the account and it comes with all the [benefits and features](introduction.md#key-benefits) of a regular Azure Cosmos DB account. These benefits include unlimited storage and throughput (RU/s), SLAs, high availability, turnkey global distribution in all Azure regions, and more.
 
-You can have up to one free tier Azure Cosmos DB account per an Azure subscription and you must opt-in when creating the account. If you do not see the option to apply the free tier discount, this means another account in the subscription has already been enabled with free tier. If you create an account with free tier and then delete it, you can apply free tier for a new account. When creating a new account, it’s recommended to enable the free tier discount if it’s available.
+You can have up to one free tier Azure Cosmos DB account per an Azure subscription and you must opt in when creating the account. If you don't see the option to apply the free tier discount, another account in the subscription has already been enabled with free tier. If you create an account with free tier and then delete it, you can apply free tier for a new account. When creating a new account, it’s recommended to enable the free tier discount if it’s available.
 
 > [!NOTE]
 > Free tier is currently not available for serverless accounts.
 
 ## Free tier with shared throughput database
 
-In shared throughput model, when you provision throughput on a database, the throughput is shared across all the containers in the database. When using the free tier, you can provision a shared database with up to 1000 RU/s for free. All containers in the database will share the throughput. 
+In shared throughput model, when you provision throughput on a database, the throughput is shared across all the containers in the database. When using the free tier, you can provision a shared database with up to 1000 RU/s for free. All containers in the database will share the throughput.
 
-Just like the regular account, in the free tier account, a shared throughput database can have a max of 25 containers. 
-Any additional databases with shared throughput or containers with dedicated throughput beyond 1000 RU/s are billed at the regular pricing.
+Just like the regular account, in the free tier account, a shared throughput database can have a max of 25 containers.
+Any other databases with shared throughput or containers with dedicated throughput beyond 1000 RU/s are billed at the regular pricing.
 
 ## Free tier with Azure discount
 
-The Azure Cosmos DB free tier is compatible with the [Azure free account](optimize-dev-test.md#azure-free-account). To opt-in, create an Azure Cosmos DB free tier account in your Azure free account subscription. For the first 12 months, you will get a combined discount of 1400 RU/s (1000 RU/s from Azure Cosmos DB free tier and 400 RU/s from Azure free account) and 50 GB of storage (25 GB from Azure Cosmos DB free tier and 25 GB from Azure free account). After the 12 months expires, you will continue to get 1000 RU/s and 25 GB from the Azure Cosmos DB free tier, for the lifetime of the Azure Cosmos DB account. For an example of how the charges are stacked, see [Billing examples with free tier accounts](understand-your-bill.md#azure-free-tier).
+The Azure Cosmos DB free tier is compatible with the [Azure free account](optimize-dev-test.md#azure-free-account). To opt in, create an Azure Cosmos DB free tier account in your Azure free account subscription. For the first 12 months, you'll get a combined discount of 1400 RU/s (1000 RU/s from Azure Cosmos DB free tier and 400 RU/s from Azure free account) and 50 GB of storage (25 GB from Azure Cosmos DB free tier and 25 GB from Azure free account). After the 12 months expire, you'll continue to get 1000 RU/s and 25 GB from the Azure Cosmos DB free tier, for the lifetime of the Azure Cosmos DB account. For an example of how the charges are stacked, see [Billing examples with free tier accounts](understand-your-bill.md#azure-free-tier).
 
 > [!NOTE]
 > Azure Cosmos DB free tier is different from the Azure free account. The Azure free account offers Azure credits and resources for free for a limited time. When using Azure Cosmos DB as a part of this free account, you get 25-GB storage and 400 RU/s of provisioned throughput for 12 months.
 
 ## Best practices to keep your account free
 
-When using Azure Cosmos DB free tier, to keep your account completely free of charge, your account should not have any additional RU/s or storage consumption other than the one offered by the free tier.
+To keep your account free of charge, your account shouldn't have any more RU/s or storage consumption other than the one offered by the Azure Cosmos DB free tier.
 
 For example, the following are some options that don’t result in any monthly charge:
 
 * One database with a max of 1000 RU/s provisioned throughput.
 * Two containers one with a max of 400 RU/s and other with a max of 600 RU/s provisioned throughput.
-* Account with 2 regions with a single region that has one container with a max of 500 RU/s provisioned throughput.
+* Account with two regions with a single region that has one container with a max of 500 RU/s provisioned throughput.
 
 ## Create an account with free tier
 
@@ -54,7 +55,7 @@ When creating the account using the Azure portal, set the **Apply Free Tier Disc
 
 ### ARM template
 
-To create a free tier account by using an ARM template, set the property `"enableFreeTier": true`. For the complete template, see deploy an [ARM template with free tier](manage-with-templates.md#free-tier) example.
+To create a free tier account by using an ARM template, set the property `"enableFreeTier": true`. For the complete template, see [deploy an ARM template with free tier](manage-with-templates.md#free-tier) example.
 
 ### CLI
 
@@ -82,6 +83,10 @@ New-AzCosmosDBAccount -ResourceGroupName "MyResourcegroup" `
     -DefaultConsistencyLevel "Session" `
 ```
 
+### Unable to create a free-tier account
+
+If the option to create a free-tier account is disabled or if you receive an error saying you can't create a free-tier account, another account in the subscription has already been enabled with free tier. To find the existing free-tier account and the resource group it is in, use this Azure CLI script, [Find Existing Free-Tier Account](scripts/cli/common/free-tier.md).
+
 ## Next steps
 
 After you create a free tier account, you can start building apps with Azure Cosmos DB with the following articles:

articles/cosmos-db/scripts/cli/common/free-tier.md

@@ -0,0 +1,53 @@
+---
+title: Find an existing Azure Cosmos DB free-tier account in a subscription
+description: Find an existing Azure Cosmos DB free-tier account in a subscription
+author: seesharprun
+ms.author: sidandrews
+ms.reviewer: mjbrown
+ms.service: cosmos-db
+ms.topic: sample
+ms.date: 07/08/2022
+---
+
+# Find an existing Azure Cosmos DB free-tier account in a subscription using Azure CLI
+
+[!INCLUDE[appliesto-all-apis](../../../includes/appliesto-all-apis.md)]
+
+The script in this article demonstrates how to locate an Azure Cosmos DB free-tier account within a subscription.
+
+Each Azure subscription can have up to one Azure Cosmos DB free-tier account. If you're trying to create a free-tier account, the option may be disabled in the Azure portal, or you get an error when attempting to create a free-tier account. If either of these issues occur, use this script to locate the name of the existing free-tier account, and the resource group it belongs to.
+
+[!INCLUDE [quickstarts-free-trial-note](../../../../../includes/quickstarts-free-trial-note.md)]
+
+[!INCLUDE [azure-cli-prepare-your-environment.md](../../../../../includes/azure-cli-prepare-your-environment.md)]
+
+- This article requires version 2.9.1 or later of the Azure CLI. If using Azure Cloud Shell, the latest version is already installed.
+
+## Sample script
+
+[!INCLUDE [cli-launch-cloud-shell-sign-in.md](../../../../../includes/cli-launch-cloud-shell-sign-in.md)]
+
+### Run the script
+
+:::code language="azurecli" source="~/azure_cli_scripts/cosmosdb/common/find-free-tier-account.sh" id="FullScript":::
+
+## Sample reference
+
+This script uses the following commands. Each command in the table links to command specific documentation.
+
+| Command | Notes |
+|---|---|
+| [az group list](/cli/azure/group#az-group-list) | Lists all resource groups in an Azure subscription. |
+| [az cosmosdb list](/cli/azure/cosmosdb#az-cosmosdb-list) | Lists all Azure Cosmos DB account in a resource group. |
+
+## Next steps
+
+For more information on the Azure Cosmos DB CLI, see [Azure Cosmos DB CLI documentation](/cli/azure/cosmosdb).
+
+For Azure CLI samples for specific APIs, see:
+
+- [CLI Samples for Cassandra](../../../cassandra/cli-samples.md)
+- [CLI Samples for Gremlin](../../../graph/cli-samples.md)
+- [CLI Samples for MongoDB API](../../../mongodb/cli-samples.md)
+- [CLI Samples for SQL](../../../sql/cli-samples.md)
+- [CLI Samples for Table](../../../table/cli-samples.md)