Azure.Compute.Batch Namespace

Classes

AffinityInfo

A locality hint that can be used by the Batch service to select a Compute Node on which to start a Task.

AuthenticationTokenSettings

The settings for an authentication token that the Task can use to perform Batch service operations.

AutomaticOsUpgradePolicy

The configuration parameters used for performing automatic OS upgrade.

AutoScaleRun

The results and errors from an execution of a Pool autoscale formula.

AutoScaleRunError

An error that occurred when executing or evaluating a Pool autoscale formula.

AutoUserSpecification

Specifies the options for the auto user that runs an Azure Batch Task.

AzureBlobFileSystemConfiguration

Information used to connect to an Azure Storage Container using Blobfuse.

AzureFileShareConfiguration

Information used to connect to an Azure Fileshare.

BatchApplication

Contains information about an application in an Azure Batch Account.

BatchApplicationPackageReference

A reference to an Package to be deployed to Compute Nodes.

BatchAutoPoolSpecification

Specifies characteristics for a temporary 'auto pool'. The Batch service will create this auto Pool when the Job is submitted.

BatchClient

The Batch service client.

BatchClientOptions

Client options for BatchClient.

BatchError

An error response received from the Azure Batch service.

BatchErrorDetail

An item of additional information included in an Azure Batch error response.

BatchErrorMessage

An error message received in an Azure Batch error response.

BatchFileProperties

Collection of header values that describe Batch File properties

BatchJob

An Azure Batch Job.

BatchJobConstraints

The execution constraints for a Job.

BatchJobCreateContent

Parameters for creating an Azure Batch Job.

BatchJobDisableContent

Parameters for disabling an Azure Batch Job.

BatchJobExecutionInfo

Contains information about the execution of a Job in the Azure Batch service.

BatchJobManagerTask

Specifies details of a Job Manager Task. The Job Manager Task is automatically started when the Job is created. The Batch service tries to schedule the Job Manager Task before any other Tasks in the Job. When shrinking a Pool, the Batch service tries to preserve Nodes where Job Manager Tasks are running for as long as possible (that is, Compute Nodes running 'normal' Tasks are removed before Compute Nodes running Job Manager Tasks). When a Job Manager Task fails and needs to be restarted, the system tries to schedule it at the highest priority. If there are no idle Compute Nodes available, the system may terminate one of the running Tasks in the Pool and return it to the queue in order to make room for the Job Manager Task to restart. Note that a Job Manager Task in one Job does not have priority over Tasks in other Jobs. Across Jobs, only Job level priorities are observed. For example, if a Job Manager in a priority 0 Job needs to be restarted, it will not displace Tasks of a priority 1 Job. Batch will retry Tasks when a recovery operation is triggered on a Node. Examples of recovery operations include (but are not limited to) when an unhealthy Node is rebooted or a Compute Node disappeared due to host failure. Retries due to recovery operations are independent of and are not counted against the maxTaskRetryCount. Even if the maxTaskRetryCount is 0, an internal retry due to a recovery operation may occur. Because of this, all Tasks should be idempotent. This means Tasks need to tolerate being interrupted and restarted without causing any corruption or duplicate data. The best practice for long running Tasks is to use some form of checkpointing.

BatchJobNetworkConfiguration

The network configuration for the Job.

BatchJobPreparationAndReleaseTaskStatus

The status of the Job Preparation and Job Release Tasks on a Compute Node.

BatchJobPreparationTask

A Job Preparation Task to run before any Tasks of the Job on any given Compute Node. You can use Job Preparation to prepare a Node to run Tasks for the Job. Activities commonly performed in Job Preparation include: Downloading common resource files used by all the Tasks in the Job. The Job Preparation Task can download these common resource files to the shared location on the Node. (AZ_BATCH_NODE_ROOT_DIR\shared), or starting a local service on the Node so that all Tasks of that Job can communicate with it. If the Job Preparation Task fails (that is, exhausts its retry count before exiting with exit code 0), Batch will not run Tasks of this Job on the Node. The Compute Node remains ineligible to run Tasks of this Job until it is reimaged. The Compute Node remains active and can be used for other Jobs. The Job Preparation Task can run multiple times on the same Node. Therefore, you should write the Job Preparation Task to handle re-execution. If the Node is rebooted, the Job Preparation Task is run again on the Compute Node before scheduling any other Task of the Job, if rerunOnNodeRebootAfterSuccess is true or if the Job Preparation Task did not previously complete. If the Node is reimaged, the Job Preparation Task is run again before scheduling any Task of the Job. Batch will retry Tasks when a recovery operation is triggered on a Node. Examples of recovery operations include (but are not limited to) when an unhealthy Node is rebooted or a Compute Node disappeared due to host failure. Retries due to recovery operations are independent of and are not counted against the maxTaskRetryCount. Even if the maxTaskRetryCount is 0, an internal retry due to a recovery operation may occur. Because of this, all Tasks should be idempotent. This means Tasks need to tolerate being interrupted and restarted without causing any corruption or duplicate data. The best practice for long running Tasks is to use some form of checkpointing.

BatchJobPreparationTaskExecutionInfo

Contains information about the execution of a Job Preparation Task on a Compute Node.

BatchJobReleaseTask

A Job Release Task to run on Job completion on any Compute Node where the Job has run. The Job Release Task runs when the Job ends, because of one of the following: The user calls the Terminate Job API, or the Delete Job API while the Job is still active, the Job's maximum wall clock time constraint is reached, and the Job is still active, or the Job's Job Manager Task completed, and the Job is configured to terminate when the Job Manager completes. The Job Release Task runs on each Node where Tasks of the Job have run and the Job Preparation Task ran and completed. If you reimage a Node after it has run the Job Preparation Task, and the Job ends without any further Tasks of the Job running on that Node (and hence the Job Preparation Task does not re-run), then the Job Release Task does not run on that Compute Node. If a Node reboots while the Job Release Task is still running, the Job Release Task runs again when the Compute Node starts up. The Job is not marked as complete until all Job Release Tasks have completed. The Job Release Task runs in the background. It does not occupy a scheduling slot; that is, it does not count towards the taskSlotsPerNode limit specified on the Pool.

BatchJobReleaseTaskExecutionInfo

Contains information about the execution of a Job Release Task on a Compute Node.

BatchJobSchedule

A Job Schedule that allows recurring Jobs by specifying when to run Jobs and a specification used to create each Job.

BatchJobScheduleConfiguration

The schedule according to which Jobs will be created. All times are fixed respective to UTC and are not impacted by daylight saving time.

BatchJobScheduleCreateContent

Parameters for creating an Azure Batch Job Schedule.

BatchJobScheduleExecutionInfo

Contains information about Jobs that have been and will be run under a Job Schedule.

BatchJobScheduleStatistics

Resource usage statistics for a Job Schedule.

BatchJobScheduleUpdateContent

Parameters for updating an Azure Batch Job Schedule.

BatchJobSchedulingError

An error encountered by the Batch service when scheduling a Job.

BatchJobSpecification

Specifies details of the Jobs to be created on a schedule.

BatchJobStatistics

Resource usage statistics for a Job.

BatchJobTerminateContent

Parameters for terminating an Azure Batch Job.

BatchJobUpdateContent

Parameters for updating an Azure Batch Job.

BatchNode

A Compute Node in the Batch service.

BatchNodeAgentInfo

The Batch Compute Node agent is a program that runs on each Compute Node in the Pool and provides Batch capability on the Compute Node.

BatchNodeCounts

The number of Compute Nodes in each Compute Node state.

BatchNodeDisableSchedulingContent

Parameters for disabling scheduling on an Azure Batch Compute Node.

BatchNodeEndpointConfiguration

The endpoint configuration for the Compute Node.

BatchNodeError

An error encountered by a Compute Node.

BatchNodeFile

Information about a file or directory on a Compute Node.

BatchNodeIdentityReference

The reference to a user assigned identity associated with the Batch pool which a compute node will use.

BatchNodeInfo

Information about the Compute Node on which a Task ran.

BatchNodePlacementConfiguration

For regional placement, nodes in the pool will be allocated in the same region. For zonal placement, nodes in the pool will be spread across different zones with best effort balancing.

BatchNodeRebootContent

Parameters for rebooting an Azure Batch Compute Node.

BatchNodeRemoteLoginSettings

The remote login settings for a Compute Node.

BatchNodeRemoveContent

Parameters for removing nodes from an Azure Batch Pool.

BatchNodeUserCreateContent

Parameters for creating a user account for RDP or SSH access on an Azure Batch Compute Node.

BatchNodeUserUpdateContent

Parameters for updating a user account for RDP or SSH access on an Azure Batch Compute Node.

BatchNodeVMExtension

The configuration for virtual machine extension instance view.

BatchPool

A Pool in the Azure Batch service.

BatchPoolCreateContent

Parameters for creating an Azure Batch Pool.

BatchPoolEnableAutoScaleContent

Parameters for enabling automatic scaling on an Azure Batch Pool.

BatchPoolEndpointConfiguration

The endpoint configuration for a Pool.

BatchPoolEvaluateAutoScaleContent

Parameters for evaluating an automatic scaling formula on an Azure Batch Pool.

BatchPoolIdentity

The identity of the Batch pool, if configured.

BatchPoolInfo

Specifies how a Job should be assigned to a Pool.

BatchPoolNodeCounts

The number of Compute Nodes in each state for a Pool.

BatchPoolReplaceContent

Customizing the Serialization of BatchPoolReplaceContent to handle the missing variable certificateReferences. This is a work around will be removed in the next release

BatchPoolResizeContent

Parameters for changing the size of an Azure Batch Pool.

BatchPoolResourceStatistics

Statistics related to resource consumption by Compute Nodes in a Pool.

BatchPoolSpecification

Specification for creating a new Pool.

BatchPoolStatistics

Contains utilization and resource usage statistics for the lifetime of a Pool.

BatchPoolUpdateContent

Parameters for updating an Azure Batch Pool.

BatchPoolUsageMetrics

Usage metrics for a Pool across an aggregation interval.

BatchPoolUsageStatistics

Statistics related to Pool usage information.

BatchStartTask

Batch will retry Tasks when a recovery operation is triggered on a Node. Examples of recovery operations include (but are not limited to) when an unhealthy Node is rebooted or a Compute Node disappeared due to host failure. Retries due to recovery operations are independent of and are not counted against the maxTaskRetryCount. Even if the maxTaskRetryCount is 0, an internal retry due to a recovery operation may occur. Because of this, all Tasks should be idempotent. This means Tasks need to tolerate being interrupted and restarted without causing any corruption or duplicate data. The best practice for long running Tasks is to use some form of checkpointing. In some cases the StartTask may be re-run even though the Compute Node was not rebooted. Special care should be taken to avoid StartTasks which create breakaway process or install/launch services from the StartTask working directory, as this will block Batch from being able to re-run the StartTask.

BatchStartTaskInfo

Information about a StartTask running on a Compute Node.

BatchSubtask

Information about an Azure Batch subtask.

BatchSupportedImage

A reference to the Azure Virtual Machines Marketplace Image and additional information about the Image.

BatchTask

Batch will retry Tasks when a recovery operation is triggered on a Node. Examples of recovery operations include (but are not limited to) when an unhealthy Node is rebooted or a Compute Node disappeared due to host failure. Retries due to recovery operations are independent of and are not counted against the maxTaskRetryCount. Even if the maxTaskRetryCount is 0, an internal retry due to a recovery operation may occur. Because of this, all Tasks should be idempotent. This means Tasks need to tolerate being interrupted and restarted without causing any corruption or duplicate data. The best practice for long running Tasks is to use some form of checkpointing.

BatchTaskAddCollectionResult

The result of adding a collection of Tasks to a Job.

BatchTaskAddResult

Result for a single Task added as part of an add Task collection operation.

BatchTaskConstraints

Execution constraints to apply to a Task.

BatchTaskContainerExecutionInfo

Contains information about the container which a Task is executing.

BatchTaskContainerSettings

The container settings for a Task.

BatchTaskCounts

The Task counts for a Job.

BatchTaskCountsResult

The Task and TaskSlot counts for a Job.

BatchTaskCreateContent

Parameters for creating an Azure Batch Task.

BatchTaskDependencies

Specifies any dependencies of a Task. Any Task that is explicitly specified or within a dependency range must complete before the dependant Task will be scheduled.

BatchTaskExecutionInfo

Information about the execution of a Task.

BatchTaskFailureInfo

Information about a Task failure.

BatchTaskGroup

A collection of Azure Batch Tasks to add.

BatchTaskIdRange

The start and end of the range are inclusive. For example, if a range has start 9 and end 12, then it represents Tasks '9', '10', '11' and '12'.

BatchTaskInfo

Information about a Task running on a Compute Node.

BatchTaskSchedulingPolicy

Specifies how Tasks should be distributed across Compute Nodes.

BatchTaskSlotCounts

The TaskSlot counts for a Job.

BatchTaskStatistics

Resource usage statistics for a Task.

CifsMountConfiguration

Information used to connect to a CIFS file system.

ComputeBatchModelFactory

Model factory for models.

ContainerConfiguration

The configuration for container-enabled Pools.

ContainerRegistryReference

A private container registry.

DataDisk

Settings which will be used by the data disks associated to Compute Nodes in the Pool. When using attached data disks, you need to mount and format the disks from within a VM to use them.

DiffDiskSettings

Specifies the ephemeral Disk Settings for the operating system disk used by the compute node (VM).

DiskEncryptionConfiguration

The disk encryption configuration applied on compute nodes in the pool. Disk encryption configuration is not supported on Linux pool created with Azure Compute Gallery Image.

EnvironmentSetting

An environment variable to be set on a Task process.

ExitCodeMapping

How the Batch service should respond if a Task exits with a particular exit code.

ExitCodeRangeMapping

A range of exit codes and how the Batch service should respond to exit codes within that range.

ExitConditions

Specifies how the Batch service should respond when the Task completes.

ExitOptions

Specifies how the Batch service responds to a particular exit condition.

FileProperties

The properties of a file on a Compute Node.

HttpHeader

An HTTP header name-value pair.

ImageReference

A reference to an Azure Virtual Machines Marketplace Image or a Azure Compute Gallery Image. To get the list of all Azure Marketplace Image references verified by Azure Batch, see the ' List Supported Images ' operation.

InboundEndpoint

An inbound endpoint on a Compute Node.

InboundNatPool

A inbound NAT Pool that can be used to address specific ports on Compute Nodes in a Batch Pool externally.

InstanceViewStatus

The instance view status.

LinuxUserConfiguration

Properties used to create a user Account on a Linux Compute Node.

ManagedDisk

The managed disk parameters.

MetadataItem

The Batch service does not assign any meaning to this metadata; it is solely for the use of user code.

MountConfiguration

The file system to mount on each node.

MultiInstanceSettings

Multi-instance Tasks are commonly used to support MPI Tasks. In the MPI case, if any of the subtasks fail (for example due to exiting with a non-zero exit code) the entire multi-instance Task fails. The multi-instance Task is then terminated and retried, up to its retry limit.

NameValuePair

Represents a name-value pair.

NetworkConfiguration

The network configuration for a Pool.

NetworkSecurityGroupRule

A network security group rule to apply to an inbound endpoint.

NfsMountConfiguration

Information used to connect to an NFS file system.

OSDisk

Settings for the operating system disk of the compute node (VM).

OutputFile

On every file uploads, Batch service writes two log files to the compute node, 'fileuploadout.txt' and 'fileuploaderr.txt'. These log files are used to learn more about a specific failure.

OutputFileBlobContainerDestination

Specifies a file upload destination within an Azure blob storage container.

OutputFileDestination

The destination to which a file should be uploaded.

OutputFileUploadConfig

Options for an output file upload operation, including under what conditions to perform the upload.

PublicIpAddressConfiguration

The public IP Address configuration of the networking configuration of a Pool.

RecentBatchJob

Information about the most recent Job to run under the Job Schedule.

ResizeError

An error that occurred when resizing a Pool.

ResourceFile

A single file or multiple files to be downloaded to a Compute Node.

RollingUpgradePolicy

The configuration parameters used while performing a rolling upgrade.

SecurityProfile

Specifies the security profile settings for the virtual machine or virtual machine scale set.

ServiceArtifactReference

Specifies the service artifact reference id used to set same image version for all virtual machines in the scale set when using 'latest' image version.

UefiSettings

Specifies the security settings like secure boot and vTPM used while creating the virtual machine.

UpgradePolicy

Describes an upgrade policy - automatic, manual, or rolling.

UploadBatchServiceLogsContent

The Azure Batch service log files upload parameters for a Compute Node.

UploadBatchServiceLogsResult

The result of uploading Batch service log files from a specific Compute Node.

UserAccount

Properties used to create a user used to execute Tasks on an Azure Batch Compute Node.

UserAssignedIdentity

The user assigned Identity.

UserIdentity

The definition of the user identity under which the Task is run. Specify either the userName or autoUser property, but not both.

VirtualMachineConfiguration

The configuration for Compute Nodes in a Pool based on the Azure Virtual Machines infrastructure.

VirtualMachineInfo

Info about the current state of the virtual machine.

VMExtension

The configuration for virtual machine extensions.

VMExtensionInstanceView

The vm extension instance view.

WindowsConfiguration

Windows operating system settings to apply to the virtual machine.

WindowsUserConfiguration

Properties used to create a user Account on a Windows Compute Node.

Structs

AccessScope

AccessScope enums.

AllocationState

AllocationState enums.

AutoUserScope

AutoUserScope enums.

BatchJobAction

BatchJobAction enums.

BatchJobPreparationTaskState

BatchJobPreparationTaskState enums.

BatchJobReleaseTaskState

BatchJobReleaseTaskState enums.

BatchJobScheduleState

BatchJobScheduleState enums.

BatchJobState

BatchJobState enums.

BatchNodeCommunicationMode

BatchNodeCommunicationMode enums.

BatchNodeDeallocationOption

BatchNodeDeallocationOption enums.

BatchNodeDisableSchedulingOption

BatchNodeDisableSchedulingOption enums.

BatchNodeFillType

BatchNodeFillType enums.

BatchNodePlacementPolicyType

BatchNodePlacementPolicyType enums.

BatchNodeRebootOption

BatchNodeRebootOption enums.

BatchNodeState

BatchNodeState enums.

BatchPoolIdentityType

BatchPoolIdentityType enums.

BatchPoolLifetimeOption

BatchPoolLifetimeOption enums.

BatchPoolState

BatchPoolState enums.

BatchStartTaskState

BatchStartTaskState enums.

BatchSubtaskState

BatchSubtaskState enums.

BatchTaskAddStatus

BatchTaskAddStatus enums.

BatchTaskExecutionResult

BatchTaskExecutionResult enums.

BatchTaskState

BatchTaskState enums.

CachingType

CachingType enums.

ContainerType

ContainerType enums.

ContainerWorkingDirectory

ContainerWorkingDirectory enums.

DependencyAction

DependencyAction enums.

DiffDiskPlacement

AccessDiffDiskPlacementScope enums.

DisableBatchJobOption

DisableBatchJobOption enums.

DiskEncryptionTarget

DiskEncryptionTarget enums.

DynamicVNetAssignmentScope

DynamicVNetAssignmentScope enums.

ElevationLevel

ElevationLevel enums.

ErrorCategory

ErrorCategory enums.

ImageVerificationType

ImageVerificationType enums.

InboundEndpointProtocol

InboundEndpointProtocol enums.

IpAddressProvisioningType

IPAddressProvisioningType enums.

LoginMode

LoginMode enums.

NetworkSecurityGroupRuleAccess

NetworkSecurityGroupRuleAccess enums.

OnAllBatchTasksComplete

The action the Batch service should take when all Tasks in the Job are in the completed state.

OnBatchTaskFailure

OnTaskFailure enums.

OSType

OSType enums.

OutputFileUploadCondition

OutputFileUploadCondition enums.

SchedulingState

SchedulingState enums.

SecurityTypes

Specifies the SecurityType of the virtual machine. It has to be set to any specified value to enable UefiSettings.

StatusLevelTypes

Level code.

StorageAccountType

StorageAccountType enums.

UpgradeMode

UpgradeMode enums.

Enums

BatchClientOptions.ServiceVersion

The version of the service to use.