jblackburn21/azure-libraries-for-netPublic

forked fromAzure/azure-libraries-for-net

NotificationsYou must be signed in to change notification settings
Fork0
Star0

Azure libraries for .Net

License

MIT license

0 stars 189 forks Branches Tags Activity

Star

Notifications

You must be signed in to change notification settings

Branches Tags

Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 411 Commits
Samples		Samples
Tests		Tests
notes		notes
src/ResourceManagement		src/ResourceManagement
tools		tools
.gitattributes		.gitattributes
.gitignore		.gitignore
.travis.yml		.travis.yml
AUTH.md		AUTH.md
CheckSourceFiles.ps1		CheckSourceFiles.ps1
Fluent.SDK.sln		Fluent.SDK.sln
Fluent.Samples.sln		Fluent.Samples.sln
Fluent.Tests.sln		Fluent.Tests.sln
LICENSE.txt		LICENSE.txt
NuGet.Config		NuGet.Config
README.md		README.md
appveyor.yml		appveyor.yml
build.proj		build.proj
test_on_linux.sh		test_on_linux.sh

Repository files navigation

Azure Management Libraries for .NET

This README is based on the released stable version (1.3). If you are looking for other releases, seeMore Information

The Azure Management Libraries for .NET is a higher-level, object-oriented API for managing Azure resources. Libraries are built on the lower-level, request-response styleauto generated clients and can run side-by-side withauto generated clients.

Feature Availability and Road Map as of Version 1.3

Service \| feature	Available as GA	Available as Preview	Coming soon
Compute	Virtual machines and VM extensions Virtual machine scale sets Managed disks	Azure container service + registry + instances Availability Zones	More Azure container registry features
Storage	Storage accounts	Encryption
SQL Database	Databases Firewalls Elastic pools		More features
Networking	Virtual networks Network interfaces IP addresses Routing table Network security groups Application gateways DNS Traffic managers	Load balancers Network peering Virtual Network Gateway Network watchers	VPN More application gateway features
More services	Resource Manager Key Vault Redis CDN Batch	Web apps Function Apps Service bus Graph RBAC Cosmos DB Search	Monitor Data Lake
Fundamentals	Authentication - core Async methods Managed Service Identity

Preview features are flagged in documentation comments in libraries. These features are subject to change. They can be modified in any way, or even removed, in the future.

Azure Authentication

TheAzure class is the simplest entry point for creating and interacting with Azure resources.

IAzureazure=Azure.Authenticate(credFile).WithDefaultSubscription();

Create a Cosmos DB with DocumentDB Programming Model

You can create a Cosmos DB account by using adefine() … create() method chain.

vardocumentDBAccount=azure.DocumentDBAccounts.Define(docDBName).WithRegion(Region.USEast).WithNewResourceGroup(rgName).WithKind(DatabaseAccountKind.GlobalDocumentDB).WithSessionConsistency().WithWriteReplication(Region.USWest).WithReadReplication(Region.USCentral).Create();

Create a Virtual Machine

You can create a virtual machine instance by using aDefine() … Create() method chain.

Console.WriteLine("Creating a Windows VM");varwindowsVM=azure.VirtualMachines.Define("myWindowsVM").WithRegion(Region.USEast).WithNewResourceGroup(rgName).WithNewPrimaryNetwork("10.0.0.0/28").WithPrimaryPrivateIPAddressDynamic().WithNewPrimaryPublicIPAddress("mywindowsvmdns").WithPopularWindowsImage(KnownWindowsVirtualMachineImage.WindowsServer2012R2Datacenter).WithAdminUsername("tirekicker").WithAdminPassword(password).WithSize(VirtualMachineSizeTypes.StandardD3V2).Create();Console.WriteLine("Created a Windows VM: "+windowsVM.Id);

Update a Virtual Machine

You can update a virtual machine instance by using anUpdate() … Apply() method chain.

windowsVM.Update().WithNewDataDisk(20,lun,CachingTypes.ReadWrite).Apply();

Create a Virtual Machine Scale Set

You can create a virtual machine scale set instance by using anotherDefine() … Create() method chain.

varvirtualMachineScaleSet=azure.VirtualMachineScaleSets.Define(vmssName).WithRegion(Region.USEast).WithExistingResourceGroup(rgName).WithSku(VirtualMachineScaleSetSkuTypes.StandardD3v2).WithExistingPrimaryNetworkSubnet(network,"Front-end").WithExistingPrimaryInternetFacingLoadBalancer(loadBalancer1).WithPrimaryInternetFacingLoadBalancerBackends(backendPoolName1,backendPoolName2).WithPrimaryInternetFacingLoadBalancerInboundNatPools(natPool50XXto22,natPool60XXto23).WithoutPrimaryInternalLoadBalancer().WithPopularLinuxImage(KnownLinuxVirtualMachineImage.UbuntuServer16_04_Lts).WithRootUsername(userName).WithSsh(sshKey).WithNewDataDisk(100).WithNewDataDisk(100,1,CachingTypes.ReadWrite).WithNewDataDisk(100,2,CachingTypes.ReadWrite,StorageAccountTypes.StandardLRS).WithCapacity(3).Create();

Create a Network Security Group

You can create a network security group instance by using anotherDefine() … Create() method chain.

varfrontEndNSG=azure.NetworkSecurityGroups.Define(frontEndNSGName).WithRegion(Region.USEast).WithNewResourceGroup(rgName).DefineRule("ALLOW-SSH").AllowInbound().FromAnyAddress().FromAnyPort().ToAnyAddress().ToPort(22).WithProtocol(SecurityRuleProtocol.Tcp).WithPriority(100).WithDescription("Allow SSH").Attach().DefineRule("ALLOW-HTTP").AllowInbound().FromAnyAddress().FromAnyPort().ToAnyAddress().ToPort(80).WithProtocol(SecurityRuleProtocol.Tcp).WithPriority(101).WithDescription("Allow HTTP").Attach().Create();

Create an Application Gateway

You can create a application gateway instance by using anotherdefine() … create() method chain.

varapplicationGateway=azure.ApplicationGateways.Define("myFirstAppGateway").WithRegion(Region.USEast).WithExistingResourceGroup(resourceGroup)// Request routing rule for HTTP from public 80 to public 8080.DefineRequestRoutingRule("HTTP-80-to-8080").FromPublicFrontend().FromFrontendHttpPort(80).ToBackendHttpPort(8080).ToBackendIPAddress("11.1.1.1").ToBackendIPAddress("11.1.1.2").ToBackendIPAddress("11.1.1.3").ToBackendIPAddress("11.1.1.4").Attach().WithExistingPublicIPAddress(publicIpAddress).Create();

Create a Web App

You can create a Web App instance by using anotherdefine() … create() method chain.

varwebApp=azure.WebApps.Define(appName).WithRegion(Region.USWest).WithNewResourceGroup(rgName).WithNewFreeAppServicePlan().Create();

Create a SQL Database

You can create a SQL server instance by using anotherdefine() … create() method chain.

varsqlServer=azure.SqlServers.Define(sqlServerName).WithRegion(Region.USEast).WithNewResourceGroup(rgName).WithAdministratorLogin(administratorLogin).WithAdministratorPassword(administratorPassword).WithNewFirewallRule(firewallRuleIpAddress).WithNewFirewallRule(firewallRuleStartIpAddress,firewallRuleEndIpAddress).Create();

Then, you can create a SQL database instance by using anotherdefine() … create() method chain.

vardatabase=sqlServer.Databases.Define(databaseName).Create();

Sample Code

You can find plenty of sample code that illustrates management scenarios (95+ end-to-end scenarios) for Azure Virtual Machines, Virtual Machine Scale Sets, Managed Disks, Active Directory Azure Container Service and Registry, Storage, Networking, Resource Manager, SQL Database, Cosmos DB, App Service (Web Apps on Windows and Linux), Functions, Service Bus, Key Vault, Redis, CDN and Batch …

Service	Management Scenario
Virtual Machines	Manage virtual machines Manage virtual machines asynchronously Manage availability set List virtual machine images Manage virtual machines using VM extensions List virtual machine extension images Create virtual machines from generalized image or specialized VHD Create virtual machine using custom image from virtual machine Create virtual machine using custom image from VHD Create virtual machine by importing a specialized operating system disk VHD Create virtual machine using specialized VHD from snapshot Convert virtual machines to use managed disks Manage virtual machine with unmanaged disks Manage Azure resources from a virtual machine with managed service identity (MSI) Manage virtual machines in availability zones Manage virtual machine scale sets in availability zones
Virtual Machines - parallel execution	Create multiple virtual machines in parallel Create multiple virtual machines with network in parallel Create multiple virtual machines across regions in parallel
Virtual Machine Scale Sets	Manage virtual machine scale sets (behind an Internet facing load balancer) Manage virtual machine scale sets (behind an Internet facing load balancer) asynchronously Manage virtual machine scale sets with unmanaged disks
Active Directory	Manage service principals using Java Manage users and groups and manage their roles Manage passwords
Container Service Container Registry and Container Instances	Manage container registry Manage container service Manage Azure Container Instances with new Azure File Share Manage Azure Container Instances with an existing Azure File Share Create Container Group with multiple instances and container images Create Container Group using images from a private registry
Storage	Manage storage accounts Manage storage accounts asynchronously
Networking	Manage virtual network Manage virtual network asynchronously Manage network interface Manage network security group Manage IP address Manage Internet facing load balancers Manage internal load balancers Create simple Internet facing load balancer Use net watcher Manage network peering between two virtual networks Use network watcher to check connectivity between virtual machines in peered networks Manage virtual network with site-to-site VPN connection Manage virtual network to virtual network VPN connection
Networking - DNS	Host and manage domains
Traffic Manager	Manage traffic manager profiles
Application Gateway	Manage application gateways Manage application gateways with backend pools
SQL Database	Manage SQL databases Manage SQL databases in elastic pools Manage firewalls for SQL databases Manage SQL databases across regions
Redis Cache	Manage Redis Cache
App Service - Web Apps onWindows	Manage Web apps Manage Web apps with custom domains Configure deployment sources for Web apps Configure deployment sources for Web apps asynchronously Manage staging and production slots for Web apps Scale Web apps Manage storage connections for Web apps Manage data connections (such as SQL database and Redis cache) for Web apps Manage authentication for Web apps
App Service - Web Apps onLinux	Manage Web apps Manage Web apps with custom domains Configure deployment sources for Web apps Scale Web apps Manage storage connections for Web apps Manage data connections (such as SQL database and Redis cache) for Web apps
Functions	Manage functions Manage functions with custom domains Configure deployment sources for functions Manage authentication for functions
Cosmos DB	Create a DocumentDB and configure it for high availability Create a DocumentDB and configure it with eventual consistency Create a DocumentDB, configure it for high availability and create a firewall to limit access from an approved set of IP addresses Create a DocumentDB and get MongoDB connection string
Service Bus	Manage queues with basic features Manage publish-subscribe with basic features Manage queues and publish-subcribe with cliams based authorization Manage publish-subscribe with advanced features - sessions, dead-lettering, de-duplication and auto-deletion of idle entries Manage queues with advanced features - sessions, dead-lettering, de-duplication and auto-deletion of idle entries
Resource Groups	Manage resource groups Manage resources Deploy resources with ARM templates Deploy resources with ARM templates (with progress) Deploy a virtual machine with managed disks using an ARM template
Key Vault	Manage key vaults
CDN	Manage CDNs
Batch	Manage batch accounts
Search	Manage Azure search

Download

1.3 release builds are available on NuGet:

Azure Management Library	Package name	Stable (1.3 release)
Azure Management Client (wrapper package)	`Microsoft.Azure.Management.Fluent`
App Service (Web Apps and Functions)	`Microsoft.Azure.Management.AppService.Fluent`
Batch	`Microsoft.Azure.Management.Batch.Fluent`
CDN	`Microsoft.Azure.Management.Cdn.Fluent`
Virtual Machines, Virtual Machine Scale Sets, Azure Container Services	`Microsoft.Azure.Management.Compute.Fluent`
Container Instance	`Microsoft.Azure.Management.ContainerInstance.Fluent`
Container Registry	`Microsoft.Azure.Management.ContainerRegistry.Fluent`
Cosmos DB	`Microsoft.Azure.Management.CosmosDB.Fluent`
DNS	`Microsoft.Azure.Management.Dns.Fluent`
Graph RBAC	`Microsoft.Azure.Management.Graph.RBAC.Fluent`
Key Vault	`Microsoft.Azure.Management.KeyVault.Fluent`
Networking	`Microsoft.Azure.Management.Network.Fluent`
Redis Cache	`Microsoft.Azure.Management.Redis.Fluent`
Resource Manager	`Microsoft.Azure.Management.ResourceManager.Fluent`
Search	`Microsoft.Azure.Management.Search.Fluent`
Service Bus	`Microsoft.Azure.Management.ServiceBus.Fluent`
SQL Database	`Microsoft.Azure.Management.Sql.Fluent`
Storage	`Microsoft.Azure.Management.Storage.Fluent`
Traffic Manager	`Microsoft.Azure.Management.TrafficManager.Fluent`

Pre-requisites

.NET Core
Azure Service Principal - seehow to create authentication info.

Help

If you are migrating your code to 1.3, you can use these notes forpreparing your code for 1.3 from 1.2.

If you encounter any bugs with these libraries, please file issues viaIssues or checkoutStackOverflow for Azure Management Libraries for .NET.

To enable Http message tracing in your code please checkthis article.

Contribute Code

If you would like to become an active contributor to this project please follow the instructions provided inMicrosoft Azure Projects Contribution Guidelines.

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request

More Information

https://azure.microsoft.com/en-us/develop/net/
If you don't have a Microsoft Azure subscription you can get a FREE trial accounthere.

Previous Releases and Corresponding Repo Branches

Version	SHA1	Remarks
1.3	1.3	Tagged release for 1.3 version of Azure management libraries
1.2	1.2	Tagged release for 1.2 version of Azure management libraries
1.1	1.1	Tagged release for 1.1 version of Azure management libraries
1.0	1.0	Tagged release for 1.0 version of Azure management libraries
1.0.0-beta5	1.0.0-beta5	Tagged release for 1.0.0-beta5 version of Azure management libraries
1.0.0-beta4	1.0.0-beta4	Tagged release for 1.0.0-beta4 version of Azure management libraries
1.0.0-beta3	1.0.0-beta3	Tagged release for 1.0.0-beta3 version of Azure management libraries
AutoRest	AutoRest	Main branch for AutoRest generated raw clients

This project has adopted theMicrosoft Open Source Code of Conduct. For more information see theCode of Conduct FAQ or contactopencode@microsoft.com with any additional questions or comments.

About

Azure libraries for .Net

Releases

1tags

Packages

No packages published

Languages

C#100.0%

Movatterモバイル変換

Navigation Menu

Search code, repositories, users, issues, pull requests...

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

License

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

Azure Management Libraries for .NET

Feature Availability and Road Map as of Version 1.3

Azure Authentication

Create a Cosmos DB with DocumentDB Programming Model

Create a Virtual Machine

Update a Virtual Machine

Create a Virtual Machine Scale Set

Create a Network Security Group

Create an Application Gateway

Create a Web App

Create a SQL Database

Sample Code

Download

Pre-requisites

Help

Contribute Code

More Information

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages

Languages

Movatterモバイル変換

License

jblackburn21/azure-libraries-for-net

Folders and files

Latest commit

History

Repository files navigation

Azure Management Libraries for .NET

Feature Availability and Road Map as of Version 1.3

Azure Authentication

Create a Cosmos DB with DocumentDB Programming Model

Create a Virtual Machine

Update a Virtual Machine

Create a Virtual Machine Scale Set

Create a Network Security Group

Create an Application Gateway

Create a Web App

Create a SQL Database

Sample Code

Download

Pre-requisites

Help

Contribute Code

More Information

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages0

Languages

Packages