Create an Azure Cosmos DB for Table account

APPLIES TO: Table

An Azure Cosmos DB for Table account contains all of your Azure Cosmos DB resources: tables and items. The account provides a unique endpoint for various tools and SDKs to connect to Azure Cosmos DB and perform everyday operations. For more information about the resources in Azure Cosmos DB, see Azure Cosmos DB resource model.

Prerequisites

• An Azure account with an active subscription. Create an account for free.

Create an account

Create a single Azure Cosmos DB account using the API for Table.

Azure CLI

1. Create shell variables for accountName, resourceGroupName, and location.

   # Variable for resource group name
   resourceGroupName="msdocs-cosmos"
   
   # Variable for location
   location="westus"
   
   # Variable for account name with a randomnly generated suffix
   let suffix=$RANDOM*$RANDOM
   accountName="msdocs-$suffix"
   

2. If you haven't already, sign in to the Azure CLI using the az login command.

3. Use the az group create command to create a new resource group in your subscription.

   az group create \
       --name $resourceGroupName \
       --location $location
   

4. Use the az cosmosdb create command to create a new Azure Cosmos DB for Table account with default settings.

   az cosmosdb create \
       --resource-group $resourceGroupName \
       --name $accountName \
       --capabilities EnableTable \
       --locations regionName=$location
   

PowerShell

1. Create shell variables for ACCOUNT_NAME, RESOURCE_GROUP_NAME, and LOCATION.

   # Variable for resource group name
   $RESOURCE_GROUP_NAME = "msdocs-cosmos"
   
   # Variable for location
   $LOCATION = "West US"
   
   # Variable for account name with a randomnly generated suffix
   $SUFFIX = Get-Random
   $ACCOUNT_NAME = "msdocs-$SUFFIX"
   

2. If you haven't already, sign in to Azure PowerShell using the Connect-AzAccount cmdlet.

3. Use the New-AzResourceGroup cmdlet to create a new resource group in your subscription.

   $parameters = @{
       Name = $RESOURCE_GROUP_NAME
       Location = $LOCATION
   }
   New-AzResourceGroup @parameters    
   

4. Use the New-AzCosmosDBAccount cmdlet to create a new Azure Cosmos DB for Table account with default settings.

   $parameters = @{
       ResourceGroupName = $RESOURCE_GROUP_NAME
       Name = $ACCOUNT_NAME
       ApiKind = "Table"
       Location = $LOCATION
   }
   New-AzCosmosDBAccount @parameters
   

Next steps

In this guide, you learned how to create an Azure Cosmos DB for Table account.

Quickstart: Azure Cosmos DB for Table for .NET