Skip to content

Latest commit

 

History

History
109 lines (81 loc) · 4.47 KB

README.md

File metadata and controls

109 lines (81 loc) · 4.47 KB

Azure Storage Blobs Cryptography client library for .NET

Server Version: 2019-02-02

Azure Blob storage is Microsoft's object storage solution for the cloud. Blob storage is optimized for storing massive amounts of unstructured data. Unstructured data is data that does not adhere to a particular data model or definition, such as text or binary data.

Source code | Package (NuGet) | API reference documentation | REST API documentation | Product documentation

Getting started

Install the package

Install the Azure Storage Blobs Cryptography client library for .NET with NuGet:

dotnet add package Azure.Storage.Blobs.Cryptography --version 12.0.0-preview.4

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

TODO: Add Key Concepts

Examples

TODO: Add Examples

Troubleshooting

All Blob service operations will throw a RequestFailedException on failure with helpful ErrorCodes. Many of these errors are recoverable.

TODO: Update sample

string connectionString = "<connection_string>";

// Try to create a container named "sample-container" and avoid any potential race
// conditions that might arise by checking if the container exists before creating
BlobContainerClient container = new BlobContainerClient(connectionString, "sample-container");
try
{
    container.Create();
}
catch (RequestFailedException ex)
    when (ex.ErrorCode == BlobErrorCode.ContainerAlreadyExists)
{
    // Ignore any errors if the container already exists
}

Next steps

TODO: Link Samples

Contributing

See the Storage CONTRIBUTING.md for details on building, testing, and contributing to this library.

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.

Impressions