1.0.0-beta.5 (2025-09-15)
Breaking Changes
-
Renamed every model with a suffix of
-Content
to have a suffix of-Parameters
instead.- Examples:
BatchJobCreateContent
is nowBatchJobCreateParameters
.BatchNodeDisableSchedulingContent
is nowBatchNodeDisableSchedulingParameters
.BatchPoolResizeContent
is nowBatchPoolResizeParameters
.
This change affects all models previously suffixed with-Content
.
- Examples:
-
Made miscellaneous model name changes:
BatchJobAction
is nowBatchJobActionKind
.BatchNodeRebootOption
is nowBatchNodeRebootKind
.ContainerConfiguration
is nowBatchContainerConfiguration
.ErrorCategory
is nowBatchErrorSourceCategory
.ImageReference
is nowBatchVmImageReference
.MetadataItem
is nowBatchMetadataItem
.OnAllBatchTasksComplete
is nowBatchAllTasksCompleteMode
.OnBatchTaskFailure
is nowBatchTaskFailureMode
.UserAssignedIdentity
is nowBatchUserAssignedIdentity
.DiffDiskSettings
is nowBatchDiffDiskSettings
.InboundNatPool
is nowBatchInboundNatPool
.OSDisk
is nowBatchOsDisk
.PublicIpAddressConfiguration
is nowBatchPublicIpAddressConfiguration
.UefiSettings
is nowBatchUefiSettings
.AccessScope
is nowBatchAccessScope
.AffinityInfo
is nowBatchAffinityInfo
.HttpHeader
is nowOutputFileUploadHeader
.BatchClientParallelOptions
is nowBatchTaskBulkCreateOptions
-
Made many small name/casing changes to names of models, properties, and methods for clarity and consistency.
- On
BatchJobNetworkConfiguration
,isSkipWithdrawFromVNet()
is nowisSkipWithdrawFromVnet()
. - On
BatchPoolResourceStatistics
,getDiskReadIOps()
is nowgetDiskReadIops()
andgetDiskWriteIOps()
is nowgetDiskWriteIops()
. - On
NetworkConfiguration
,getDynamicVNetAssignmentScope()
is nowgetDynamicVnetAssignmentScope()
andsetDynamicVNetAssignmentScope
is nowsetDynamicVnetAssignmentScope
. - On
BatchTaskStatistics
,getReadIOps()
is nowgetReadIops()
,getWriteIOps()
is nowgetWriteIops()
,getReadIOGiB()
is nowgetReadIoGiB()
, andgetWriteIOGiB()
is nowgetWriteIoGiB()
. VMDiskSecurityProfile
has now been changed toBatchVmDiskSecurityProfile
.DeleteBatchCertificateError
has now been changed toBatchCertificateDeleteError
.- On
BatchJobStatistics
andBatchJobScheduleStatistics
,getNumSucceededTasks()
is nowgetSucceededTasksCount()
,getNumFailedTasks()
is nowgetFailedTasksCount()
,getNumTaskRetries()
is nowgetTaskRetriesCount()
,getReadIOps()
is nowgetReadIops()
,getWriteIOps()
is nowgetWriteIops()
,getReadIOGiB()
is nowgetReadIoGiB()
, andgetWriteIOGiB()
is nowgetWriteIoGiB()
- On
BatchTaskBulkCreateOptions
,getMaxDegreeOfParallelism()
is nowgetMaxConcurrency()
. - On the
BatchClient
(synchronous client),getNodeFileProperties
andgetTaskFileProperties
now returnBatchFileProperties
instead ofFileResponseHeaderProperties
. OnBatchAsyncClient
(asynchronous methods),getNodeFileProperties
andgetTaskFileProperties
now returnMono<BatchFileProperties>
instead ofMono<FileResponseHeaderProperties>
. - On
BatchCreateTaskCollectionResult
andBatchTaskGroup
,getValue()
is nowgetValues()
. - On
BatchJob
,getOnAllTasksComplete()
is now namedgetAllTasksCompleteMode()
.setOnAllTasksComplete
is nowsetAllTasksCompleteMode
.getStats()
is now namedgetJobStatistics()
.getOnTaskFailure()
is nowgetTaskFailureMode()
. - On
BatchJobSchedule
,getStats()
is now namedgetJobScheduleStatistics()
. - On
BatchJobSpecification
andBatchJobCreateParameters
,getOnAllTasksComplete()
is now namedgetAllTasksCompleteMode()
.setOnAllTasksComplete
is nowsetAllTasksCompleteMode
.getOnTaskFailure()
is nowgetTaskFailureMode()
.setOnTaskFailure
is nowsetTaskFailureMode
. - On
BatchJobUpdateParameters
,getOnAllTasksComplete()
is now namedgetAllTasksCompleteMode()
.setOnAllTasksComplete
is nowsetAllTasksCompleteMode
. - On
BatchNodeRebootParameters
,getNodeRebootOption()
is nowgetNodeRebootKind()
.setNodeRebootOption
is nowsetNodeRebootKind
. - On
BatchNodeRemoveParameters
,getNodeList()
is nowgetNodeIds()
. - On
BatchPool
,getStats()
is nowgetPoolStatistics()
. - On
BatchPoolStatistics
,getUsageStats()
is nowgetUsageStatistics()
andgetResourceStats()
is nowgetResourceStatistics()
. - On
BatchTask
,getStats()
is nowgetTaskStatistics()
. - On the
BatchCertificate
model, the return type ofgetData()
is nowbyte[]
instead ofString
.
- On
-
Renamed all optional parameter model classes to follow the consistent
{Resource}{Operation}Options
naming pattern.- Examples:
GetBatchApplicationOptions
is nowBatchApplicationGetOptions
.TerminateBatchJobOptions
is nowBatchJobTerminateOptions
.GetBatchNodeFilePropertiesOptions
is nowBatchNodeFilePropertiesGetOptions
.
- Examples:
This change affects all operation-specific options classes across jobs, pools, certificates, tasks, and nodes.
-
The type of
timeOutInSeconds
in many of the optional parameter models has changed fromInteger
toDuration
. This affects the getter and setter methods on these models.getTimeOutInSeconds()
now returnsDuration
instead ofInteger
.setTimeOutInSeconds(Integer timeOutInSeconds)
is nowsetTimeOutInSeconds(Duration timeOutInSeconds)
. This change applies to the same set of{Resource}{Operation}Options
models referenced above. -
Several methods in the SDK have been updated to use the Long-Running Operation (LRO) pattern. LROs are used when an operation may take an extended period to complete. Instead of blocking or returning immediately, LRO methods return a Poller that tracks the operation’s progress and provides access to intermediate and final results.
- Examples:
deleteJob
has been renamed tobeginDeleteJob
.- In the synchronous
BatchClient
, the return type changed fromvoid
toSyncPoller<BatchJob, Void>
. - In the asynchronous
BatchAsyncClient
, the return type changed fromMono<Void>
toPollerFlux<BatchJob, Void>
.
- In the synchronous
deallocateNode
has been renamed tobeginDeallocateNode
.- In the synchronous
BatchClient
, the return type changed fromvoid
toSyncPoller<BatchNode, BatchNode>
. - In the asynchronous
BatchAsyncClient
, the return type changed fromMono<Void>
toPollerFlux<BatchNode, BatchNode>
.
- In the synchronous
stopPoolResize
has been renamed tobeginStopPoolResize
.- In the synchronous
BatchClient
, the return type changed fromvoid
toSyncPoller<BatchPool, BatchPool>
. - In the asynchronous
BatchAsyncClient
, the return type changed fromMono<Void>
toPollerFlux<BatchPool, BatchPool>
.
The same rename pattern (method to beginMethod) and return type change applies to the following old method names:deleteCertificate
,disableJob
,enableJob
,terminateJob
,deleteJobSchedule
,terminateJobSchedule
,rebootNode
,reimageNode
,startNode
,removeNodes
,deletePool
, andresizePool
.
- In the synchronous
- Examples: