Azure.Storage.Common 12.20.0-beta.1

Prefix Reserved
This is a prerelease version of Azure.Storage.Common.
There is a newer version of this package available.
See the version list below for details.
dotnet add package Azure.Storage.Common --version 12.20.0-beta.1                
NuGet\Install-Package Azure.Storage.Common -Version 12.20.0-beta.1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Azure.Storage.Common" Version="12.20.0-beta.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Azure.Storage.Common --version 12.20.0-beta.1                
#r "nuget: Azure.Storage.Common, 12.20.0-beta.1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Azure.Storage.Common as a Cake Addin
#addin nuget:?package=Azure.Storage.Common&version=12.20.0-beta.1&prerelease

// Install Azure.Storage.Common as a Cake Tool
#tool nuget:?package=Azure.Storage.Common&version=12.20.0-beta.1&prerelease                

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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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 (11)

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.20.0 12,534 7/16/2024
12.20.0-beta.1 7,952 6/11/2024
12.19.0 3,830,749 5/14/2024
12.19.0-beta.2 21,257 4/16/2024
12.19.0-beta.1 189,499 12/5/2023
12.18.1 21,202,029 11/14/2023
12.18.0 1,002,932 11/6/2023
12.18.0-beta.1 43,851 10/16/2023
12.17.0 8,501,066 9/12/2023
12.17.0-beta.1 41,831 8/8/2023
12.16.0 9,921,233 7/11/2023
12.16.0-beta.1 63,145 5/30/2023
12.15.0 21,246,197 4/11/2023
12.15.0-beta.1 9,963 3/28/2023
12.14.1 5,248,582 3/24/2023
12.14.0 6,838,121 2/22/2023
12.14.0-beta.1 24,748 2/8/2023
12.13.0 28,514,459 10/12/2022
12.13.0-beta.1 55,940 8/23/2022
12.12.0 40,060,315 7/8/2022
12.12.0-beta.1 18,986 6/15/2022
12.11.0 16,454,216 5/2/2022
12.11.0-beta.1 16,501 4/12/2022
12.10.0 7,230,725 3/10/2022
12.10.0-beta.3 80,257 2/7/2022
12.10.0-beta.2 222,678 11/30/2021
12.10.0-beta.1 31,556 11/3/2021
12.9.0 36,748,853 9/8/2021
12.9.0-beta.2 44,279 7/23/2021
12.9.0-beta.1 5,385 7/23/2021
12.8.0 12,834,320 6/9/2021
12.8.0-beta.4 177,118 5/12/2021
12.8.0-beta.3 22,600 4/9/2021
12.8.0-beta.2 79,120 3/10/2021
12.8.0-beta.1 102,962 2/10/2021
12.7.3 2,257,967 5/21/2021
12.7.2 3,662,307 4/2/2021
12.7.1 4,412,614 3/29/2021
12.7.0 17,264,283 1/12/2021
12.7.0-beta.1 61,043 12/7/2020
12.6.0 9,903,260 11/10/2020
12.6.0-preview.1 107,899 10/1/2020
12.5.2 12,957,646 8/31/2020
12.5.1 1,136,913 8/18/2020
12.5.0-preview.6 40,185 7/28/2020
12.5.0-preview.5 38,224 7/3/2020
12.5.0-preview.4 8,929 6/19/2020
12.5.0-preview.1 6,551 6/8/2020
12.4.3 7,748,006 6/5/2020
12.4.2 448,609 6/2/2020
12.4.1 2,064,016 5/6/2020
12.4.0 1,595,872 4/6/2020
12.3.0 2,153,581 3/12/2020
12.2.0 1,929,495 2/11/2020
12.1.1 1,234,959 1/10/2020
12.1.0 747,021 12/4/2019
12.0.0 1,502,455 10/31/2019
12.0.0-preview.4 13,506 10/10/2019
12.0.0-preview.3 6,000 9/10/2019
12.0.0-preview.2 3,833 8/6/2019
12.0.0-preview.1 2,817 7/3/2019
1.0.0-preview.1 4,763 5/7/2019