| title | description | author | ms.service | ms.subservice | ms.devlang | ms.topic | ms.date | ms.author | ms.reviewer | ms.custom |
|---|---|---|---|---|---|---|---|---|---|---|
Azure Cosmos DB: SQL .NET API, SDK & resources |
Learn all about the SQL .NET API and SDK including release dates, retirement dates, and changes made between each version of the Azure Cosmos DB .NET SDK. |
seesharprun |
cosmos-db |
nosql |
csharp |
reference |
03/05/2024 |
sidandrews |
mjbrown |
devx-track-dotnet |
[!INCLUDENoSQL]
[!INCLUDESDK selector]
| Links | |
|---|---|
| Release notes | Release notes |
| SDK download | NuGet |
| API documentation | .NET API reference documentation |
| Samples | .NET code samples |
| Get started | Get started with the Azure Cosmos DB .NET SDK |
| Web app tutorial | Web application development with Azure Cosmos DB |
| Current supported framework | Microsoft .NET Framework 4.5 |
Warning
On August 31, 2024 the Azure Cosmos DB .NET SDK v2.x will be retired; the SDK and all applications using the SDK will continue to function; Azure Cosmos DB will simply cease to provide further maintenance and support for this SDK. We recommend migrating to the latest version of the .NET SDK v3 SDK.
Note
If you are using .NET Framework, please see the latest version 3.x of the .NET SDK, which targets .NET Standard.
Release history is maintained in the Azure Cosmos DB .NET SDK source repo. For a detailed list of feature releases and bugs fixed in each release, see the SDK changelog documentation
Different sub versions of .NET SDKs are available under the 2.x.x version. Version 2.x of this SDK will be retired on 31 August 2024 and you’ll need to update your SDK to version 3 by that date. Version 3 of the Azure Cosmos DB .NET SDK includes updated features and improved performance. We recommend following the instructions to migrate to Azure Cosmos DB .NET SDK version 3.
[!INCLUDE cosmos-db-sdk-faq]
To learn more about Azure Cosmos DB, see Microsoft Azure Cosmos DB service page.