azure-docs-sdk-java/docs-ref-services/batch.md

title	description	keywords	author	ms.author	manager	ms.date	ms.topic	ms.prod	ms.technology	ms.devlang	ms.service
Azure Batch libraries for Java	Reference documentation for the Java Batch libraries	Azure, Java, SDK, API, Batch, processing, scheduling, long-running	rloutlaw	routlaw	douge	06/21/2017	article	azure	azure	java	batch

Azure Batch libraries for Java

Overview

Run large-scale parallel and high-performance computing applications efficiently in the cloud with Azure Batch.

To get started with Azure Batch, see Create a Batch account with the Azure portal.

Client library

The Azure Batch client libraries let you configure compute nodes and pools, define tasks and configure them to run in jobs, and set up a job manager to control and monitor job execution. Learn more about using these objects to run large-scale parallel compute solutions.

Add a dependency to your Maven pom.xml file to use the client library in your project. The client library source code can be found in Github.

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>azure-batch</artifactId>
    <version>4.0.0</version>
</dependency>

Example

Set up a pool of Linux compute nodes in a batch account:

// create the batch client for an account using its URI and keys
BatchClient client = BatchClient.open(new BatchSharedKeyCredentials("https://fabrikambatch.eastus.batch.azure.com", "fabrikambatch", batchKey));

// configure a pool of VMs to use 
VirtualMachineConfiguration configuration = new VirtualMachineConfiguration();
configuration.withNodeAgentSKUId("batch.node.ubuntu 16.04");
client.poolOperations().createPool(poolId, poolVMSize, configuration, poolVMCount);

[!div class="nextstepaction"] Explore the Client APIs

Management API

Use the Azure Batch management libraries to create and delete batch accounts, read and regenerate batch account keys, and manage batch account storage.

Add a dependency to your Maven pom.xml file to use the management API in your project.

<dependency>
    <groupId>com.microsoft.azure</groupId>
    <artifactId>azure-mgmt-batch</artifactId>
    <version>1.3.0</version>
</dependency>

Example

Create an Azure Batch account and configure a new application and Azure storage account for it.

BatchAccount batchAccount = azure.batchAccounts().define("newBatchAcct")
    .withRegion(Region.US_EAST)
    .withNewResourceGroup("myResourceGroup")
    .defineNewApplication("batchAppName")
        .defineNewApplicationPackage(applicationPackageName)
        .withAllowUpdates(true)
        .withDisplayName(applicationDisplayName)
        .attach()
    .withNewStorageAccount("batchStorageAcct")
    .create();

[!div class="nextstepaction"] Explore the Management APIs

Samples

Manage Batch accounts

Explore more sample Java code for Azure Batch you can use in your apps.