{"id":8637,"date":"2024-09-10T09:00:41","date_gmt":"2024-09-10T16:00:41","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/cosmosdb\/?p=8637"},"modified":"2024-09-10T13:36:09","modified_gmt":"2024-09-10T20:36:09","slug":"introducing-the-data-api-preview-in-vcore-based-azure-cosmos-db-for-mongodb","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/cosmosdb\/introducing-the-data-api-preview-in-vcore-based-azure-cosmos-db-for-mongodb\/","title":{"rendered":"Introducing the Data API Preview in vCore-based Azure Cosmos DB for MongoDB"},"content":{"rendered":"

\"Introducing<\/a><\/p>\n

We’re excited to announce the preview of the Data API for vCore-based Azure Cosmos DB for MongoDB. The Data API provides a flexible and powerful way to interact with your database through HTTP-based API calls.<\/p>\n

What is the Data API <\/strong><\/h2>\n

The Data API for vCore-based Azure Cosmos DB for MongoDB<\/a> allows you work with your MongoDB data through simple HTTP requests, eliminating the need for traditional drivers or \u00a0complex queries. It offers an easy way to perform basic operations like creating, reading, updating, and deleting data directly from your applications. This simplifies connecting your MongoDB data to web apps, mobile apps, or tools like Power BI, all through a familiar and user-friendly API.<\/p>\n

Example<\/strong><\/h3>\n

To read active products from a products collection:<\/p>\n

curl --user \"username:password\" https:\/\/c.dataapi-validation.mongocluster.cosmos.azure.com:10331\/data\/v1\/action\/aggregate -H \"Content-Type: application\/ejson\" -H \"Accept: application\/ejson\" -d \"{\\\"database\\\": \\\"myDatabase\\\",\\\"collection\\\": \\\"products\\\",\\\"pipeline\\\": [{\\\"$match\\\":{ \\\"status\\\": \\\"active\\\" }}]}\"<\/code><\/p>\n

This retrieves all documents from the products collection where status is active, using a straightforward HTTP request.<\/p>\n

Why the Data API Matters<\/strong><\/h2>\n

The Data API simplifies interactions with Azure Cosmos DB for MongoDB by providing a direct HTTP-based method to access and manipulate data. This feature is crucial for developers who prefer RESTful APIs over traditional database drivers. vCore-based Azure Cosmos DB for MongoDB’s Data API can be authenticated with the same MongoDB users used to access the database through the MongoDB drivers. \u00a0The same roles and permissions are applicable to both the Data API HTTPS endpoint and the MongoDB TCP endpoint.<\/span><\/span><\/p>\n

Supporting you no matter which version you choose<\/strong><\/h2>\n

Azure Cosmos DB for MongoDB is committed to supporting a wide range of MongoDB versions to meet your needs. Our single codebase approach ensures seamless, near-instant upgrades across versions.<\/p>\n