The Microsoft Azure SDK for .NET allows you to build applications that take advantage of scalable cloud computing resources.
This repository contains the open source subset of the .NET SDK. For documentation of the complete SDK, please see the Microsoft Azure .NET Developer Center.
-
Storage
Available in the separate Storage repository
- Tables
- Create/Delete Tables
- Query/Create/Read/Update/Delete Entities
- Blobs
- Create/Read/Update/Delete Blobs
- Files
- Create/Update/Delete Directories
- Create/Read/Update/Delete Files
- Queues
- Create/Delete Queues
- Insert/Peek Queue Messages
- Advanced Queue Operations
- Tables
-
Configuration Manager
-
Management Libraries
- Compute
- Virtual Machines
- Hosted Services
- Infrastructure
- Media Services Management
- Scheduler Client & Management
- Storage
- Network
- Web Sites
- Compute
-
Media Services
-
Management Libraries (Preview)
-
Service Bus Management
-
Monitoring Services
-
Store
-
SQL Database
Available in the separate Media Services repository
-
-
Mobile Services
Available in the separate Mobile Services repository
The complete Microsoft Azure SDK can be downloaded from the Microsoft Azure Downloads Page and ships with support for building deployment packages, integrating with tooling, rich command line tooling, and more.
For the best development experience, developers should use the official Microsoft NuGet packages for libraries. NuGet packages are regularly updated with new functionality and hotfixes.
- .NET Framework 4.5 and newer
- .NET Framework 4.0
- Storage Libraries are available for Windows 8 for Windows Store development as well as Windows Phone 8
As of 10/2013, SDK 2.2 supports targeting only .NET Framework 4.0 and newer.
Need support for previous versions of .NET such as 3.5? Version 2.1 of the Azure SDK for .NET supports this version and can still be used today.
- Microsoft Azure Subscription: To call Microsoft Azure services, you need to first create an account. Sign up for a free trial or use your MSDN subscriber benefits.
- Hosting: To host your .NET code in Azure, you additionally need to download the full Microsoft Azure SDK for .NET - which includes packaging, emulation, and deployment tools, or use Microsoft Azure Web Sites to deploy ASP.NET web applications.
Be sure to check out the Microsoft Azure Developer Forums on MSDN if you have trouble with the provided code or use StackOverflow.
Install:
- Visual Studio 2013 RTM with update 2 and Windows and Windows Phone SDKs
- Latest [Git client] (http://git-scm.com/download/win)
In the root folder of Azure Sdk you will find two solutions:
- WindowsAzureCommonLibraries.sln, contains projects for Azure Common libraries
- WindowsAzureManagementLibraries.sln, contains projects for Azure Management libraries
Any of them could be opened and built in the IDE of Visual Studio 2013.
Note: You will need to restore Nuget Packages locally before build. To do so go to "Tools\Nuget Package Manager\Manage Nuget Packages for Solution" menu item in VS IDE and press Restore button in the upper right corner of the window.
Open Visual Studio command prompt and navigate to your cloned git folder of Azure Sdk, then run:
msbuild libraries.msbuildWe gladly accept community contributions.
- Issues: Please report bugs using the Issues section of GitHub
- Forums: Interact with the development teams on StackOverflow or the Azure Forums
- Source Code Contributions: Please follow the contribution guidelines for Microsoft Azure open source that details information on onboarding as a contributor
For general suggestions about Azure please use our UserVoice forum.
To use Storage services (Blob, Table, Queue, File), the Storage Client Library provides rich APIs for interacting with the Storage service.
The Storage Client Library ships with the Microsoft Azure SDK for .NET and also on NuGet. You'll find the latest version and hotfixes on NuGet via the WindowsAzure.Storage package.
With the release of the 3.0.0 storage client library, you can find the latest storage library (and associated issues) in the separate repo azure-storage-net.
The latest version of the v2.1.x storage client library is available in the azure-sdk-for-net repo under the v2.1.0.4 tag.
The storage client libaries are delivered via NuGet officially by Microsoft, ready for use within your project. They are installed with the NuGet package manager which is built into Visual Studio 2013; for earlier releases of Visual Studio, NuGet is a quick and easy extension to install.
Install-Package WindowsAzure.Storage
Note: How-Tos focused around accomplishing specific tasks are available on the Azure .NET Developer Center.
First, include the classes you need (in this case we'll include the Storage and Table and further demonstrate creating a table):
using Microsoft.WindowsAzure.Storage;
using Microsoft.WindowsAzure.Storage.Table;To perform an operation on any resource you will first instantiate a client which allows performing actions on it. The resource is known as an entity. To do so for Table you also have to authenticate your request:
var storageAccount = CloudStorageAccount.Parse(
CloudConfigurationManager.GetSetting("StorageConnectionString"));
var tableClient = storageAccount.CreateCloudTableClient();Now, to create a table entity using the client:
CloudTable peopleTable = tableClient.GetTableReference("people");
peopleTable.Create();Automate, configure and command your deployments, infrastructure and accounts with the Microsoft Azure Management Libraries.
Preview: At this time some of the Microsoft Azure Management Libraries are still in the preview state as the teams gather feedback and prepare for the initial release. Please enjoy using the libraries and source in any capacity, but understand that there may be breaking changes with the 1.0 release.
To get the source code of the SDK via git just type:
git clone git://github.com/WindowsAzure/azure-sdk-for-net.git
cd azure-sdk-for-net\librariesOfficial binaries are distributed by Microsoft and available using the .NET package manager NuGet.
To get all of the management libraries setup in your project:
Install-Package Microsoft.WindowsAzure.Management.Libraries -IncludePrerelease
You can also install just the management library for a service of interest. To deploy a virtual machine to the cloud, the
Microsoft.WindowsAzure.Management.Computepackage can be used, for example.
This code would result with a list of the regions. The location object provided in the result provides properties to define which assets are supported by each region.
using (ManagementClient client = CloudContext.Clients.CreateManagementClient(Credentials))
{
var result = await client.Locations.ListAsync();
var locations = result.Locations;
foreach (var location in locations)
{
Console.WriteLine("Location: {0}", location.Name);
foreach (var feature in location.AvailableServices)
{
Console.WriteLine(feature);
}
}
}To create a storage account,The code below will create a storage account in the West US region.
var storageAccountName = "mystorageaccount";
using (StorageManagementClient client =
CloudContext.Clients.CreateStorageManagementClient(Credentials))
{
await client.StorageAccounts.CreateAsync(
new StorageAccountCreateParameters
{
ServiceName = storageAccountName,
Location = LocationNames.WestUS
});
}The code below will obtain the storage account keys to construct a connection string on the fly.
var storageAccountName = "mystorageaccount";
using (StorageManagementClient client =
CloudContext.Clients.CreateStorageManagementClient(Credentials))
{
var keys = await
client.StorageAccounts.GetKeysAsync(storageAccountName);
string connectionString = string.Format(
CultureInfo.InvariantCulture,
"DefaultEndpointsProtocol=https;AccountName={0};AccountKey={1}",
storageAccountName, keys.SecondaryKey);
return connectionString;
}The following code will create a new (empty) Cloud Service in the subscription.
var cloudServiceName = "MyCloudService";
using (ComputeManagementClient client =
CloudContext.Clients.CreateComputeManagementClient(Credentials))
{
await client.HostedServices.CreateAsync(
new HostedServiceCreateParameters
{
ServiceName = cloudServiceName,
Location = LocationNames.WestUS
});
}Once a storage account has been created, the Windows Storage SDK can be used to upload .CSPKG files into the storage account. Then, the cloud service could be deployed. The code below demonstrates this functionality.
var blobs = CloudStorageAccount.Parse(storageConnectionString).CreateCloudBlobClient();
var container = blobs.GetContainerReference("deployments");
await container.CreateIfNotExistsAsync();
await container.SetPermissionsAsync(
new BlobContainerPermissions()
{
PublicAccess = BlobContainerPublicAccessType.Container
});
var blob = container.GetBlockBlobReference("MyCloudService.cspkg");
await blob.UploadFromFileAsync("MyCloudService.cspkg", FileMode.Open);
var cloudServiceName = "MyCloudService";
using (ComputeManagementClient client =
CloudContext.Clients.CreateComputeManagementClient(Credentials))
{
await client.Deployments.CreateAsync(cloudServiceName,
DeploymentSlot.Production,
new DeploymentCreateParameters
{
Name = cloudServiceName + "Prod",
Label = cloudServiceName + "Prod",
PackageUri = blob.Uri,
Configuration = File.ReadAllText("MyCloudService.cscfg"),
StartDeployment = true
});
}