SAMPLE.md

Code snippets and samples

If you are looking for general documentation on how to use the management libraries, please visit here

Azure Authentication

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

AzureProfile profile = new AzureProfile(AzureEnvironment.AZURE);
TokenCredential credential = new DefaultAzureCredentialBuilder()
    .authorityHost(profile.getEnvironment().getActiveDirectoryEndpoint())
    .build();
AzureResourceManager azure = AzureResourceManager
    .authenticate(credential, profile)
    .withDefaultSubscription();

To learn more about authentication in the Azure Management Libraries for Java, see https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/resourcemanager/docs/AUTH.md.

Virtual Machines

Create a Virtual Machine

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

System.out.println("Creating a Linux VM");

VirtualMachine linuxVM = azure.virtualMachines().define("myLinuxVM")
	.withRegion(Region.US_EAST)
	.withNewResourceGroup(rgName)
	.withNewPrimaryNetwork("10.0.0.0/28")
	.withPrimaryPrivateIPAddressDynamic()
	.withNewPrimaryPublicIPAddress("mylinuxvmdns")
	.withPopularLinuxImage(KnownLinuxVirtualMachineImage.UBUNTU_SERVER_16_04_LTS)
	.withRootUsername("tirekicker")
	.withSsh(sshKey)
	.withSize(VirtualMachineSizeTypes.STANDARD_D3_V2)
	.create();

System.out.println("Created a Linux VM: " + linuxVM.id());

Update a Virtual Machine

You can update a virtual machine instance by using an update() … apply() method chain.

linuxVM.update()
	.withNewDataDisk(20, lun, CachingTypes.READ_WRITE)
	.apply();

Create a Virtual Machine Scale Set

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

 VirtualMachineScaleSet virtualMachineScaleSet = azure.virtualMachineScaleSets().define(vmssName)
     .withRegion(Region.US_EAST)
     .withExistingResourceGroup(rgName)
     .withSku(VirtualMachineScaleSetSkuTypes.STANDARD_D3_V2)
     .withExistingPrimaryNetworkSubnet(network, "Front-end")
     .withPrimaryInternetFacingLoadBalancer(loadBalancer1)
     .withPrimaryInternetFacingLoadBalancerBackends(backendPoolName1, backendPoolName2)
     .withPrimaryInternetFacingLoadBalancerInboundNatPools(natPool50XXto22, natPool60XXto23)
     .withoutPrimaryInternalLoadBalancer()
     .withPopularLinuxImage(KnownLinuxVirtualMachineImage.UBUNTU_SERVER_16_04_LTS)
     .withRootUsername(userName)
     .withSsh(sshKey)
     .withNewDataDisk(100)
     .withNewDataDisk(100, 1, CachingTypes.READ_WRITE)
     .withNewDataDisk(100, 2, CachingTypes.READ_WRITE, StorageAccountTypes.STANDARD_LRS)
     .withCapacity(3)
     .create();

Ready-to-run code samples for virtual machines

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 system assigned managed service identity (MSI) Manage Azure resources from a virtual machine with managed service identity (MSI) credentials Manage Azure resources from a virtual machine with system assigned managed service identity (MSI) Manage virtual machines in availability zones Manage virtual machine scale sets in availability zones List compute SKUs Manage virtual machine with managed disks Manage virtual machine with disks
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 Create multiple virtual machines in parallel and track related resources
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

Networking

Create a virtual network

You can create a virtual network by using a define() … create() method chain.

Network network = azure.networks().define("mynetwork")
	.withRegion(Region.US_EAST)
	.withNewResourceGroup()
	.withAddressSpace("10.0.0.0/28")
	.withSubnet("subnet1", "10.0.0.0/29")
	.withSubnet("subnet2", "10.0.0.8/29")
	.create();

Create a network security group

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

NetworkSecurityGroup frontEndNSG = azure.networkSecurityGroups().define(frontEndNSGName)
    .withRegion(Region.US_EAST)
    .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 a define() … create() method chain.

ApplicationGateway applicationGateway = azure.applicationGateways().define("myFirstAppGateway")
    .withRegion(Region.US_EAST)
    .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();

Ready-to-run code samples for networking

Service	Management Scenario
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 Manage client to virtual network VPN connection
DNS	Host and manage domains
Application Gateway	Manage application gateways Manage application gateways with backend pools
Express Route	Create and configure Express Route

Application Services

Create a Web App

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

WebApp webApp = azure.webApps()
    .define(appName)
    .withRegion(Region.US_WEST)
    .withNewResourceGroup(rgName)
    .withNewWindowsPlan(PricingTier.STANDARD_S1)
    .create();

Ready-to-run code samples for Application Services

Service	Management Scenario
Web Apps on Windows	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 Safegaurd Web app secrets in Key Vault Safegaurd Web app secrets in Key Vault using convenience API Get logs for Web apps
Web Apps on Linux	Manage Web apps Deploy a container image from Azure Container Registry to Linux containers 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 Safegaurd Web app secrets in Key Vault on Linux
Functions	Manage functions Manage functions with custom domains Configure deployment sources for functions Manage authentication for functions Get function logs
Traffic Manager	Manage traffic manager profiles Manage simple traffic manager profiles

Databases and Storage

Create a Cosmos DB with CosmosDB Programming Model

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

CosmosAccount cosmosDBAccount = azure.cosmosDBAccounts().define(cosmosDBName)
	.withRegion(Region.US_EAST)
	.withNewResourceGroup(rgName)
	.withKind(DatabaseAccountKind.GLOBAL_DOCUMENT_DB)
	.withSessionConsistency()
	.withWriteReplication(Region.US_WEST)
	.withReadReplication(Region.US_CENTRAL)
	.create()

Create a SQL Database

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

SqlServer sqlServer = azure.sqlServers().define(sqlServerName)
    .withRegion(Region.US_EAST)
    .withNewResourceGroup(rgName)
    .withAdministratorLogin("fakeAdminLoginPlaceholder")
    .withAdministratorPassword("fakePasswordPlaceholder")
    .withNewFirewallRule("10.0.0.1")
    .withNewFirewallRule("10.2.0.1", "10.2.0.10")
    .create();

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

SqlDatabase database = azure.sqlServers().databases().define("myNewDatabase")
	...
    .create();

Ready-to-run code samples for databases

Service	Management Scenario
Storage	Manage storage accounts Manage storage accounts asynchronously Manage network rules of a storage account
SQL Database	Manage SQL databases Manage SQL databases in elastic pools Manage firewalls for SQL databases Manage SQL databases across regions Import and export SQL databases Restore and recover SQL databases Get SQL Database metrics Manage SQL Database Failover Groups Manage SQL Server DNS aliases Manage SQL secrets (Server Keys) in Azure Key Vault Manage SQL Virtual Network Rules Manage SQL Server Security Alert Policy
Cosmos DB	Create a CosmosDB and configure it for high availability Create a CosmosDB and configure it with eventual consistency Create a CosmosDB, configure it for high availability and create a firewall to limit access from an approved set of IP addresses Create a CosmosDB and get MongoDB connection string Create a CosmosDB Table with a virtual network rule

Other code samples

Service	Management Scenario
Active Directory	Manage credentials for service principals using Java Manage users and groups and manage their roles Manage Azure resources from a managed service identity (MSI) enabled virtual machine that belongs to a Microsoft Entra ID security group
Container Service Container Registry and Container Instances	Manage container registry Manage container registry with Web hooks Manage Kubernetes cluster (AKS) Deploy an image from container registry to Kubernetes cluster (AKS) Manage Kubernetes clusters with advanced networking 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 and scale up containers using Kubernetes in ACS
Resource Groups	Manage resource groups Manage resources Deploy resources using ARM templates Deploy resources using ARM templates asynchronously Deploy resources using ARM templates with deployment operations Deploy resources using ARM templates with progress Deploy resources using ARM templates with tags Deploy a virtual machine with managed disks using an ARM template
Redis Cache	Manage Redis Cache
Key Vault	Manage key vaults
Monitor	Get metrics and activity logs for a resource Configuring activity log alerts to be triggered on potential security breaches or risks. Configuring metric alerts to be triggered on potential performance downgrade. Configuring autoscale settings to scale out based on webapp request count statistic.
App Platform	Manage Spring Cloud