Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
| 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 |
| Current supported framework | Microsoft .NET Framework 4.5 |
Warning
On August 31, 2024, Microsoft retired the Azure Cosmos DB .NET SDK v2.x. The SDK and all applications that use the SDK continue to function. Microsoft no longer provides maintenance or support for this SDK. We recommend migrating to the latest version of the .NET SDK v3 SDK.
Note
If you use .NET Framework, see the latest version 3.x of the .NET SDK, which targets .NET Standard.
Release history
The Azure Cosmos DB .NET SDK source repo maintains the release history. For a detailed list of feature releases and bugs fixed in each release, see the SDK changelog documentation.
Recommended version
Different sub-versions of .NET SDKs are available under the 2.x.x version. Microsoft retired version 2.x of this SDK on August 31, 2024. Update your SDK to version 3. Version 3 of the Azure Cosmos DB .NET SDK includes updated features and improved performance. Follow the instructions to migrate to Azure Cosmos DB .NET SDK version 3.
FAQ
How will I be notified of the retiring SDK?
Microsoft provides 12 months' advance notice before the end of support for the retiring SDK to help you smoothly transition to a supported SDK. You receive notifications through these communication channels: the Azure portal, Azure updates, and direct communication to assigned service administrators.
Can I author applications by using a to-be-retired Azure Cosmos DB SDK during the 12-month period?
Yes, you can use the to-be-retired Azure Cosmos DB SDK to author, deploy, and modify applications during the 12-month notice period. We recommend that you migrate to a newer supported version of the Azure Cosmos DB SDK during the 12-month notice period, as appropriate.
After the retirement date, what happens to applications that use the unsupported Azure Cosmos DB SDK?
After the retirement date, Azure Cosmos DB no longer makes bug fixes, adds new features, or provides support for the retired SDK versions. If you choose not to upgrade, Azure Cosmos DB continues to serve requests sent from the retired versions of the SDK.
Which SDK versions will have the latest features and updates?
New features and updates are added only to the latest minor version of the latest supported major SDK version. We recommend that you always use the latest version to take advantage of new features, performance improvements, and bug fixes. If you're using an old, non-retired version of the SDK, your requests to Azure Cosmos DB still function, but you don't have access to any new capabilities.
What should I do if I can't update my application before a cutoff date?
We recommend that you upgrade to the latest SDK as early as possible. After an SDK is tagged for retirement, you have 12 months to update your application. If you're not able to update by the retirement date, Azure Cosmos DB continues to serve requests sent from the retired versions of the SDK, so your running applications continue to function. But Azure Cosmos DB no longer makes bug fixes, adds new features, or provides support for the retired SDK versions.
If you have a support plan and require technical support, contact us by filing a support ticket.
How can I request features be added to an SDK or connector?
New features aren't always added to every SDK or connector immediately. If there's a feature that isn't supported that you'd like added, add feedback to our community forum.