Azure.Storage.Common
12.21.1
Prefix Reserved
See the version list below for details.
dotnet add package Azure.Storage.Common --version 12.21.1
NuGet\Install-Package Azure.Storage.Common -Version 12.21.1
<PackageReference Include="Azure.Storage.Common" Version="12.21.1" />
paket add Azure.Storage.Common --version 12.21.1
#r "nuget: Azure.Storage.Common, 12.21.1"
// Install Azure.Storage.Common as a Cake Addin #addin nuget:?package=Azure.Storage.Common&version=12.21.1 // Install Azure.Storage.Common as a Cake Tool #tool nuget:?package=Azure.Storage.Common&version=12.21.1
Azure Storage Common client library for .NET
Server Version: 2021-02-12, 2020-12-06, 2020-10-02, 2020-08-04, 2020-06-12, 2020-04-08, 2020-02-10, 2019-12-12, 2019-07-07, and 2020-02-02
Azure Storage is a Microsoft-managed service providing cloud storage that is highly available, secure, durable, scalable, and redundant. Azure Storage includes Azure Blobs (objects), Azure Data Lake Storage Gen2, Azure Files, and Azure Queues.
The Azure.Storage.Common library provides infrastructure shared by the other Azure Storage client libraries.
Source code | Package (NuGet) | API reference documentation | REST API documentation | Product documentation
Getting started
Install the package
Install the Azure Storage client library for .NET you'd like to use with
NuGet and the Azure.Storage.Common client library will be included:
dotnet add package Azure.Storage.Blobs
dotnet add package Azure.Storage.Queues
dotnet add package Azure.Storage.Files.Shares
Prerequisites
You need an Azure subscription and a Storage Account to use this package.
To create a new Storage Account, you can use the Azure Portal, Azure PowerShell, or the Azure CLI. Here's an example using the Azure CLI:
az storage account create --name MyStorageAccount --resource-group MyResourceGroup --location westus --sku Standard_LRS
Key concepts
The Azure Storage Common client library contains shared infrastructure like authentication credentials and RequestFailedException.
Thread safety
We guarantee that all client instance methods are thread-safe and independent of each other (guideline). This ensures that the recommendation of reusing client instances is always safe, even across threads.
Additional concepts
Client options | Accessing the response | Long-running operations | Handling failures | Diagnostics | Mocking | Client lifetime
Examples
Please see the examples for Blobs, Queues, and Files.
Troubleshooting
All Azure Storage services will throw a RequestFailedException
with helpful ErrorCodes.
Next steps
Get started with our Common samples and then continue on with our Blobs, Queues, and Files samples.
Contributing
See the Storage CONTRIBUTING.md for details on building, testing, and contributing to these libraries.
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit cla.microsoft.com.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net5.0 was computed. net5.0-windows was computed. net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
| .NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
| .NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
| .NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
| MonoAndroid | monoandroid was computed. |
| MonoMac | monomac was computed. |
| MonoTouch | monotouch was computed. |
| Tizen | tizen40 was computed. tizen60 was computed. |
| Xamarin.iOS | xamarinios was computed. |
| Xamarin.Mac | xamarinmac was computed. |
| Xamarin.TVOS | xamarintvos was computed. |
| Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- Azure.Core (>= 1.44.1)
- System.IO.Hashing (>= 6.0.0)
-
net6.0
- Azure.Core (>= 1.44.1)
- System.IO.Hashing (>= 6.0.0)
NuGet packages (49)
Showing the top 5 NuGet packages that depend on Azure.Storage.Common:
| Package | Downloads |
|---|---|
|
Azure.Storage.Blobs
This client library enables working with the Microsoft Azure Storage Blob service for storing binary and text data. For this release see notes - https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/storage/Azure.Storage.Blobs/README.md and https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/storage/Azure.Storage.Blobs/CHANGELOG.md in addition to the breaking changes https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/storage/Azure.Storage.Blobs/BreakingChanges.txt Microsoft Azure Storage quickstarts and tutorials - https://docs.microsoft.com/en-us/azure/storage/ Microsoft Azure Storage REST API Reference - https://docs.microsoft.com/en-us/rest/api/storageservices/ REST API Reference for Blob Service - https://docs.microsoft.com/en-us/rest/api/storageservices/blob-service-rest-api |
|
|
Azure.Storage.Queues
This client library enables working with the Microsoft Azure Storage Queue service for storing messages that may be accessed by a client. For this release see notes - https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/storage/Azure.Storage.Queues/README.md and https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/storage/Azure.Storage.Queues/CHANGELOG.md in addition to the breaking changes https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/storage/Azure.Storage.Queues/BreakingChanges.txt Microsoft Azure Storage quickstarts and tutorials - https://docs.microsoft.com/en-us/azure/storage/ Microsoft Azure Storage REST API Reference - https://docs.microsoft.com/en-us/rest/api/storageservices/ REST API Reference for Queue Service - https://docs.microsoft.com/en-us/rest/api/storageservices/queue-service-rest-api |
|
|
Azure.Storage.Files.Shares
This client library enables working with the Microsoft Azure Storage File Shares service for storing binary and text data. For this release see notes - https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/storage/Azure.Storage.Files.Shares/README.md and https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/storage/Azure.Storage.Files.Shares/CHANGELOG.md in addition to the breaking changes https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/storage/Azure.Storage.Files.Shares/BreakingChanges.txt Microsoft Azure Storage quickstarts and tutorials - https://docs.microsoft.com/en-us/azure/storage/ Microsoft Azure Storage REST API Reference - https://docs.microsoft.com/en-us/rest/api/storageservices/ REST API Reference for File Service - https://docs.microsoft.com/en-us/rest/api/storageservices/file-service-rest-api |
|
|
Snowflake.Data
Snowflake Connector for .NET |
|
|
Azure.Storage.Files.DataLake
This client library enables working with the Microsoft Azure Storage Data Lake File service for storing binary and text data. For this release see notes - https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/storage/Azure.Storage.Files.DataLake/README.md and https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/storage/Azure.Storage.Files.DataLake/CHANGELOG.md in addition to the breaking changes https://github.com/Azure/azure-sdk-for-net/blob/main/sdk/storage/Azure.Storage.Files.DataLake/BreakingChanges.txt Microsoft Azure Storage quickstarts and tutorials - https://docs.microsoft.com/en-us/azure/storage/blobs/data-lake-storage-introduction Microsoft Azure Storage REST API Reference - https://docs.microsoft.com/en-us/rest/api/storageservices/ REST API Reference for Data Lake - https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/filesystem |
GitHub repositories (12)
Showing the top 5 popular GitHub repositories that depend on Azure.Storage.Common:
| Repository | Stars |
|---|---|
|
Azure/azure-sdk-for-net
This repository is for active development of the Azure SDK for .NET. For consumers of the SDK we recommend visiting our public developer docs at https://learn.microsoft.com/dotnet/azure/ or our versioned developer docs at https://azure.github.io/azure-sdk-for-net.
|
|
|
mspnp/cloud-design-patterns
Sample implementations for cloud design patterns found in the Azure Architecture Center.
|
|
|
SparkDevNetwork/Rock
An open source CMS, Relationship Management System (RMS) and Church Management System (ChMS) all rolled into one.
|
|
|
microsoft/AMBROSIA
Robust Distributed Programming Made Easy and Efficient
|
|
|
microsoft/Bing-Maps-Fleet-Tracker
The Bing Maps Fleet Tracker is a tracking solution for small to medium sized teams. Easily track vehicles and mobile devices. Previously known as "Project Hurghada".
|
| Version | Downloads | Last updated |
|---|---|---|
| 12.22.0 | 379,507 | 11/12/2024 |
| 12.22.0-beta.2 | 10,622 | 10/10/2024 |
| 12.22.0-beta.1 | 3,270 | 10/8/2024 |
| 12.21.1 | 2,127,705 | 10/11/2024 |
| 12.21.0 | 2,259,412 | 9/19/2024 |
| 12.21.0-beta.1 | 24,140 | 8/7/2024 |
| 12.20.1 | 6,380,959 | 7/25/2024 |
| 12.20.0 | 2,423,313 | 7/16/2024 |
| 12.20.0-beta.1 | 29,350 | 6/11/2024 |
| 12.19.0 | 10,192,618 | 5/14/2024 |
| 12.19.0-beta.2 | 37,079 | 4/16/2024 |
| 12.19.0-beta.1 | 280,573 | 12/5/2023 |
| 12.18.1 | 31,809,359 | 11/14/2023 |
| 12.18.0 | 1,258,539 | 11/6/2023 |
| 12.18.0-beta.1 | 54,764 | 10/16/2023 |
| 12.17.0 | 11,597,651 | 9/12/2023 |
| 12.17.0-beta.1 | 56,555 | 8/8/2023 |
| 12.16.0 | 12,454,663 | 7/11/2023 |
| 12.16.0-beta.1 | 69,919 | 5/30/2023 |
| 12.15.0 | 27,793,925 | 4/11/2023 |
| 12.15.0-beta.1 | 10,643 | 3/28/2023 |
| 12.14.1 | 6,306,109 | 3/24/2023 |
| 12.14.0 | 7,794,004 | 2/22/2023 |
| 12.14.0-beta.1 | 26,651 | 2/8/2023 |
| 12.13.0 | 31,557,543 | 10/12/2022 |
| 12.13.0-beta.1 | 58,855 | 8/23/2022 |
| 12.12.0 | 46,487,310 | 7/8/2022 |
| 12.12.0-beta.1 | 19,307 | 6/15/2022 |
| 12.11.0 | 17,575,812 | 5/2/2022 |
| 12.11.0-beta.1 | 16,841 | 4/12/2022 |
| 12.10.0 | 7,537,099 | 3/10/2022 |
| 12.10.0-beta.3 | 81,256 | 2/7/2022 |
| 12.10.0-beta.2 | 232,340 | 11/30/2021 |
| 12.10.0-beta.1 | 32,897 | 11/3/2021 |
| 12.9.0 | 38,608,795 | 9/8/2021 |
| 12.9.0-beta.2 | 45,383 | 7/23/2021 |
| 12.9.0-beta.1 | 5,476 | 7/23/2021 |
| 12.8.0 | 13,307,810 | 6/9/2021 |
| 12.8.0-beta.4 | 181,893 | 5/12/2021 |
| 12.8.0-beta.3 | 22,905 | 4/9/2021 |
| 12.8.0-beta.2 | 79,919 | 3/10/2021 |
| 12.8.0-beta.1 | 105,137 | 2/10/2021 |
| 12.7.3 | 2,329,878 | 5/21/2021 |
| 12.7.2 | 3,767,243 | 4/2/2021 |
| 12.7.1 | 4,548,758 | 3/29/2021 |
| 12.7.0 | 18,046,148 | 1/12/2021 |
| 12.7.0-beta.1 | 63,008 | 12/7/2020 |
| 12.6.0 | 10,340,540 | 11/10/2020 |
| 12.6.0-preview.1 | 110,047 | 10/1/2020 |
| 12.5.2 | 13,592,033 | 8/31/2020 |
| 12.5.1 | 1,161,015 | 8/18/2020 |
| 12.5.0-preview.6 | 40,667 | 7/28/2020 |
| 12.5.0-preview.5 | 39,693 | 7/3/2020 |
| 12.5.0-preview.4 | 9,103 | 6/19/2020 |
| 12.5.0-preview.1 | 6,656 | 6/8/2020 |
| 12.4.3 | 7,949,646 | 6/5/2020 |
| 12.4.2 | 474,398 | 6/2/2020 |
| 12.4.1 | 2,095,402 | 5/6/2020 |
| 12.4.0 | 1,623,762 | 4/6/2020 |
| 12.3.0 | 2,217,733 | 3/12/2020 |
| 12.2.0 | 2,125,014 | 2/11/2020 |
| 12.1.1 | 1,276,997 | 1/10/2020 |
| 12.1.0 | 788,126 | 12/4/2019 |
| 12.0.0 | 1,568,714 | 10/31/2019 |
| 12.0.0-preview.4 | 14,882 | 10/10/2019 |
| 12.0.0-preview.3 | 6,068 | 9/10/2019 |
| 12.0.0-preview.2 | 3,892 | 8/6/2019 |
| 12.0.0-preview.1 | 2,889 | 7/3/2019 |
| 1.0.0-preview.1 | 4,848 | 5/7/2019 |