High performance storage in Azure DocumentDB (preview)

Sign in to the Azure portal (https://portal.azure.cn).

From the Azure portal menu or the Home page, select Create a resource.

On the New page, search for and select Azure DocumentDB.

On the Create Azure DocumentDB cluster page and within the Basics section, select the Configure option within the Cluster tier section.

On the Configure page, choose the cluster tier and storage size as required. Select the storage type as Premium SSD v2 (preview) to enable high-performance storage, then select Save to apply the changes.

Fill in the remaining details and then select Review + create.

Review the settings you provide, and then select Create. It takes a few minutes to create the cluster. Wait for the resource deployment is complete.

Finally, select Go to resource to navigate to the Azure DocumentDB cluster in the portal.

Open a new terminal.

Sign in to Azure CLI.

Create a new Bicep file to define your role definition. Name the file main.bicep.

Add this template to the file's content. Replace the <cluster-name>, <location>, <username>, and <password> placeholders with appropriate values.

resource cluster 'Microsoft.DocumentDB/mongoClusters@2025-08-01-preview' = {
  name: '<cluster-name>'
  location: '<location>'
  properties: {
    administrator: {
      userName: '<username>'
      password: '<password>'
    }
    serverVersion: '8.0'
    storage: {
      sizeGb: 32
      type: 'PremiumSSDv2'
    }
    compute: {
      tier: 'M30'
    }
    sharding: {
      shardCount: 1
    }
    highAvailability: {
      targetMode: 'Disabled'
    }
  }
}

Deploy the Bicep template using az deployment group create. Specify the name of the Bicep template and replace the <resource-group> placeholder with the name of your target Azure resource group.

az deployment group create \
    --resource-group "<resource-group>" \
    --template-file main.bicep

Wait for the deployment to complete. Review the output from the deployment.

Open a new terminal.

Sign in to Azure CLI.

Check your target Azure subscription.

az account show

Define your cluster in a new Terraform file. Name the file cluster.tf.

Add this resource configuration to the file's content. Replace the <cluster-name>, <resource-group>, and <location> placeholders with appropriate values.

variable "admin_username" {
  type        = string
  description = "Administrator username for the cluster."
  sensitive   = true
}

variable "admin_password" {
  type        = string
  description = "Administrator password for the cluster."
  sensitive   = true
}

terraform {
  required_providers {
    azurerm = {
      source  = "hashicorp/azurerm"
      version = "~> 4.0"
    }
  }
}

provider "azurerm" {
  features {}
}

data "azurerm_resource_group" "existing" {
  name = "<resource-group>"
}

resource "azurerm_mongo_cluster" "cluster" {
  name                   = "<cluster-name>"
  resource_group_name    = data.azurerm_resource_group.existing.name
  location               = "<location>"
  administrator_username = var.admin_username
  administrator_password = var.admin_password
  shard_count            = "1"
  compute_tier           = "M30"
  high_availability_mode = "Disabled"
  storage_size_in_gb     = "32"
  storage_type           = "PremiumSSDv2"
  version                = "8.0"
}

Initialize the Terraform deployment.

terraform init --upgrade

Create an execution plan and save it to a file named cluster.tfplan. Provide values when prompted for the admin_username and admin_password variables.

ARM_SUBSCRIPTION_ID=$(az account show --query id --output tsv) terraform plan --out "cluster.tfplan"

Apply the execution plan to deploy the cluster to Azure.

ARM_SUBSCRIPTION_ID=$(az account show --query id --output tsv) terraform apply "cluster.tfplan"

Wait for the deployment to complete. Review the output from the deployment.

Open a new terminal.

Sign in to Azure CLI.

Create a new JSON file named cluster.json.

Add this document to the file's content. Replace the <location>, <username>, and <password> placeholders with appropriate values.

{
  "location": "<location>",
  "properties": {
    "administrator": {
      "userName": "<username>",
      "password": "<password>"
    },
    "serverVersion": "8.0",
    "storage": {
      "sizeGb": 32,
      "type": "PremiumSSDv2"
    },
    "compute": {
      "tier": "M30"
    },
    "sharding": {
      "shardCount": 1
    },
    "highAvailability": {
      "targetMode": "Disabled"
    }
  }
}

Use the az rest Azure CLI command to create a new cluster with the configuration specified in the JSON file. Specify the name of the JSON file as the body of the request and replace the following placeholders:

az rest \
    --method "GET" \
    --url "https://management.chinacloudapi.cn/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.DocumentDB/mongoClusters/<cluster-name>/users?api-version=2025-08-01-preview" \
    --body @cluster.json

Wait for the deployment to complete. Review the output from the deployment.