Updated toc, format corrections and added quickstart

Author: gicheng

articles/cosmos-db/sql/TOC.yml

@@ -24,6 +24,9 @@
     - name: Create resources - JSON template
       displayName: ARM, Resource Manager, Template, JSON
       href: quick-create-template.md
+    - name: Create resources - Terraform template
+      displayName: ARM, Resource Manager, Template, Terraform
+      href: quick-create-terraform.md
 - name: Tutorials
   items:
     - name: Create and manage data
@@ -137,6 +140,8 @@
           displayName: ARM
         - name: Bicep syntax templates
           href: bicep-samples.md
+        - name: Terraform syntax templates
+          href: terraform-samples.md
     - name: Azure Resource Graph queries
       href: ../resource-graph-samples.md
 - name: Concepts
@@ -1038,6 +1043,9 @@
         - name: Using Resource Manager templates
           href: manage-with-templates.md
           displayName: ARM
+        - name: Using Terraform 
+          href: manage-with-terraform.md
+          displayName: Terraform
         - name: Move between regions
           href: ../how-to-move-regions.md
         - name: Prevent changes or deletion

articles/cosmos-db/sql/manage-with-terraform.md

@@ -25,7 +25,7 @@ This article shows terraform samples for Core (SQL) API accounts.
 > * When you add or remove locations to an Azure Cosmos account, you can't simultaneously modify other properties. These operations must be done separately.
 > * To provision throughput at the database level and share across all containers, apply the throughput values to the database options property.
 
-To create any of the Azure Cosmos DB resources below, copy the example into a new terraform file (main.tf) or alternatively, have 2 separate files for resources and variables. Be sure to include the azurerm provider either in the main terraform file or split out to a separate providers file. All examples can be found on the [terraform samples repository](https://github.com/Azure/terraform).
+To create any of the Azure Cosmos DB resources below, copy the example into a new terraform file (main.tf) or alternatively, have 2 separate files for resources (main.tf) and variables (variables.tf). Be sure to include the azurerm provider either in the main terraform file or split out to a separate providers file. All examples can be found on the [terraform samples repository](https://github.com/Azure/terraform).
 
 :::code language="terraform" source="~/terraform_samples/quickstart/101-cosmos-db-autoscale/providers.tf":::
 
@@ -75,7 +75,7 @@ Create an Azure Cosmos account in two regions with options for consistency and f
 
 ## Azure Cosmos DB container with server-side functionality
 
-Create an Azure Cosmos account, database and container with with a stored procedure, trigger, and user-defined function.
+Create an Azure Cosmos account, database and container with a stored procedure, trigger, and user-defined function.
 
 ### main.tf
 
@@ -89,7 +89,7 @@ Create an Azure Cosmos account, database and container with with a stored proced
 
 ## Azure Cosmos DB account with Azure AD and RBAC
 
-Create an Azure Cosmos account, a natively maintained Role Definition, and a natively maintained Role Assignment for an AAD identity.
+Create an Azure Cosmos account, a natively maintained Role Definition, and a natively maintained Role Assignment for an Azure Active Directory identity.
 
 ### main.tf
 

articles/cosmos-db/sql/quick-create-terraform.md

@@ -0,0 +1,106 @@
+---
+title: Quickstart - Create an Azure Cosmos DB and a container using Terraform
+description: Quickstart showing how to an Azure Cosmos database and a container using Terraform
+author: ginsiucheng
+ms.author: gicheng
+tags: azure-resource-manager, terraform
+ms.service: cosmos-db
+ms.subservice: cosmosdb-sql
+ms.topic: quickstart
+ms.date: 09/22/2022
+
+#Customer intent: As a database admin who is new to Azure, I want to use Azure Cosmos DB to store and manage my data.
+---
+
+# Quickstart: Create an Azure Cosmos DB and a container using Terraform
+
+[!INCLUDE[appliesto-sql-api](../includes/appliesto-sql-api.md)]
+
+Azure Cosmos DB is Microsoft’s fast NoSQL database with open APIs for any scale. You can use Azure Cosmos DB to quickly create and query key/value databases, document databases, and graph databases. Without a credit card or an Azure subscription, you can set up a free [Try Azure Cosmos DB account](https://aka.ms/trycosmosdb). This quickstart focuses on the process of deployments via Terraform to create an Azure Cosmos database and a container within that database. You can later store data in this container.
+
+## Prerequisites
+
+An Azure subscription or free Azure Cosmos DB trial account 
+
+- [!INCLUDE [quickstarts-free-trial-note](../../../includes/quickstarts-free-trial-note.md)]
+
+Terraform should be installed on your local computer. Installation instructions can b
+
+## Review the Terraform File
+
+The Terraform files used in this quickstart can be found on the [terraform samples repository](https://github.com/Azure/terraform). Please create the below 3 files: providers.tf, main.tf and variables.tf. Variables can be set in command line or alternatively with a terraforms.tfvars file.
+
+### Provider Terraform File
+
+:::code language="terraform" source="~/terraform_samples/quickstart/101-cosmos-db-autoscale/providers.tf":::
+
+### Main Terraform File
+
+:::code language="terraform" source="~/terraform_samples/quickstart/101-cosmos-db-manualscale/main.tf":::
+
+### Variables Terraform File
+
+:::code language="terraform" source="~/terraform_samples/quickstart/101-cosmos-db-manualscale/variables.tf":::
+
+
+Three Cosmos DB resources are defined in the main terraform file.
+
+- [Microsoft.DocumentDB/databaseAccounts](/azure/templates/microsoft.documentdb/databaseaccounts): Create an Azure Cosmos account.
+
+- [Microsoft.DocumentDB/databaseAccounts/sqlDatabases](/azure/templates/microsoft.documentdb/databaseaccounts/sqldatabases): Create an Azure Cosmos database.
+
+- [Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers](/azure/templates/microsoft.documentdb/databaseaccounts/sqldatabases/containers): Create an Azure Cosmos container.
+
+## Deploy via terraform 
+
+1. Save the terraform files as main.tf, variables.tf and providers.tf to your local computer.
+2. Login to your terminal via Azure CLI or Powershell
+3. Deploy via Terraform commands
+    - terraform init 
+    - terraform plan
+    - terraform apply
+
+## Validate the deployment
+
+Use the Azure portal, Azure CLI, or Azure PowerShell to list the deployed resources in the resource group.
+
+### [CLI](#tab/CLI)
+
+```azurecli-interactive
+az resource list --resource-group exampleRG
+```
+
+### [PowerShell](#tab/PowerShell)
+
+```azurepowershell-interactive
+Get-AzResource -ResourceGroupName exampleRG
+```
+
+## Clean up resources
+
+If you plan to continue working with subsequent quickstarts and tutorials, you might want to leave these resources in place.
+When no longer needed, use the Azure portal, Azure CLI, or Azure PowerShell to delete the resource group and its resources.
+
+# [CLI](#tab/CLI)
+
+```azurecli-interactive
+az group delete --name exampleRG
+```
+
+# [PowerShell](#tab/PowerShell)
+
+```azurepowershell-interactive
+Remove-AzResourceGroup -Name exampleRG
+```
+
+## Next steps
+
+In this quickstart, you created an Azure Cosmos account, a database and a container via terraform and validated the deployment. To learn more about Azure Cosmos DB and Terraform, continue on to the articles below.
+
+- Read an [Overview of Azure Cosmos DB](../introduction.md).
+- Learn more about [Terraform](https://www.terraform.io/intro).
+- Learn more about [Azure Terraform Provider](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs).
+- [Manage Cosmos DB with Terraform](manage-with-terraform.md)
+- Trying to do capacity planning for a migration to Azure Cosmos DB? You can use information about your existing database cluster for capacity planning.
+    - If all you know is the number of vCores and servers in your existing database cluster, read about [estimating request units using vCores or vCPUs](../convert-vcore-to-request-unit.md).
+    - If you know typical request rates for your current database workload, read about [estimating request units using Azure Cosmos DB capacity planner](estimate-ru-with-capacity-planner.md).