Data API for Azure Cosmos DB for MongoDB vCore (Preview)

The Data API for Azure Cosmos DB for MongoDB vCore is an https interface that allows developers to access and interact with their MongoDB vCore data without needing a database driver. It simplifies data operations by enabling control plane and aggregation operations through HTTP requests. This API is ideal for web applications, providing secure and scalable access to MongoDB vCore databases.

You can enable or disable this feature using the Azure CLI or an ARM template. Portal support will be added soon.

1. Get connection string:

   • Obtain the connection string of your vCore cluster from the Azure portal.

2. Retrieve authentication token:

   • Run the following commands in Windows PowerShell:

     az login
     az account get-access-token --resource-type arm
     

3. Send PATCH request:

   • Use the connection string from the Azure portal and send a PATCH request with:
     • Authentication Token: Use the token retrieved from PowerShell.
     • Body:

       {
         "properties": {
           "dataApi": {
             "mode": "Enabled"
           }
         }
       }
       

4. Verify result:

   • Ensure the response payload includes "dataApi": {"mode": "Enabled"}.
   • If you encounter the error "Data API isn't supported on this cluster," note that only newly provisioned clusters support Data API.

Method: PATCH
Endpoint: https://chinanorth3.management.chinacloudapi.cn/subscriptions/<subscriptionId>/resourceGroups/<resourceGroup>/providers/Microsoft.DocumentDB/mongoClusters/<ClusterName>?api-version=2024-10-01-preview

{
  "properties": {
    "dataApi": {
      "mode": "Enabled"
    }
  }
}

To obtain the connection string for your MongoDB vCore cluster, follow these steps:

1. Navigate to the MongoDB vCore cluster that you created.
2. Go to Settings and select Connection Strings.
3. Copy the Data API endpoint provided.

Let's explore the supported operations, how to use the Data API.

Use this command to perform an aggregation operation on a collection.

curl {cluster-name}.data.global.mongocluster.cosmos.azure.com:443/data/v1/action/aggregate -H "Content-Type: application/ejson" -H "Accept:application/ejson" -d '{"database": "newDB", "collection": "newCollection", "pipeline": [{"$limit": 500}]}'

List all databases in the specified MongoDB vCore cluster.

curl {cluster-name}.data.global.mongocluster.cosmos.azure.com:443/data/v1/action/listDatabases -H "Content-Type: application/ejson" -H "Accept:application/ejson" -d '{}'

List all collections within a specific database.

curl {cluster-name}.data.global.mongocluster.cosmos.azure.com:443/data/v1/action/listCollections -H "Content-Type: application/ejson" -H "Accept:application/ejson" -d '{"database": "newDB"}'

Retrieve the schema details of a specific database.

Here's the formatted version for your .md file:

curl {cluster-name}.data.global.mongocluster.cosmos.azure.com:443/data/v1/action/getSchema -H "Content-Type: application/ejson" -H "Accept:application/ejson" -d '{"database": "newDB"}'

• Data API works on newly created MongoDB vCore cluster.
• Data API doesn't support access using reusable access token.
• Only support aggregate and few other list control plane actions.