Pool Interface
public interface Pool
An immutable client-side representation of Pool.
Method Summary
| Modifier and Type | Method and Description |
|---|---|
|
abstract
Allocation |
allocationState()
Gets the allocation |
|
abstract
Offset |
allocationStateTransitionTime()
Gets the allocation |
| abstract List<String> |
applicationLicenses()
Gets the application |
|
abstract
List<Application |
applicationPackages()
Gets the application |
|
abstract
Auto |
autoScaleRun()
Gets the auto |
|
abstract
List<Certificate |
certificates()
Gets the certificates property: For Windows compute nodes, the Batch service installs the certificates to the specified certificate store and location. |
|
abstract
Offset |
creationTime()
Gets the creation |
| abstract Integer |
currentDedicatedNodes()
Gets the current |
| abstract Integer |
currentLowPriorityNodes()
Gets the current |
|
abstract
Node |
currentNodeCommunicationMode()
Gets the current |
|
abstract
Deployment |
deploymentConfiguration()
Gets the deployment |
| abstract Pool |
disableAutoScale()
Disables automatic scaling for a pool. |
| abstract Response<Pool> |
disableAutoScaleWithResponse(Context context)
Disables automatic scaling for a pool. |
| abstract String |
displayName()
Gets the display |
| abstract String |
etag()
Gets the etag property: The ETag of the resource, used for concurrency statements. |
| abstract String |
id()
Gets the id property: Fully qualified resource Id for the resource. |
|
abstract
Batch |
identity()
Gets the identity property: The type of identity used for the Batch Pool. |
|
abstract
Pool |
innerModel()
Gets the inner com. |
|
abstract
Inter |
interNodeCommunication()
Gets the inter |
|
abstract
Offset |
lastModified()
Gets the last |
|
abstract
List<Metadata |
metadata()
Gets the metadata property: The Batch service does not assign any meaning to metadata; it is solely for the use of user code. |
|
abstract
List<Mount |
mountConfiguration()
Gets the mount |
| abstract String |
name()
Gets the name property: The name of the resource. |
|
abstract
Network |
networkConfiguration()
Gets the network |
|
abstract
Pool |
provisioningState()
Gets the provisioning |
|
abstract
Offset |
provisioningStateTransitionTime()
Gets the provisioning |
| abstract Pool |
refresh()
Refreshes the resource to sync with Azure. |
| abstract Pool |
refresh(Context context)
Refreshes the resource to sync with Azure. |
|
abstract
Resize |
resizeOperationStatus()
Gets the resize |
| abstract String |
resourceGroupName()
Gets the name of the resource group. |
| abstract Map<String,String> |
resourceTags()
Gets the resource |
|
abstract
Scale |
scaleSettings()
Gets the scale |
|
abstract
Start |
startTask()
Gets the start |
| abstract Pool |
stopResize()
Stops an ongoing resize operation on the pool. |
| abstract Response<Pool> |
stopResizeWithResponse(Context context)
Stops an ongoing resize operation on the pool. |
| abstract Map<String,String> |
tags()
Gets the tags property: The tags of the resource. |
|
abstract
Node |
targetNodeCommunicationMode()
Gets the target |
|
abstract
Task |
taskSchedulingPolicy()
Gets the task |
| abstract Integer |
taskSlotsPerNode()
Gets the task |
| abstract String |
type()
Gets the type property: The type of the resource. |
| abstract Update |
update()
Begins update for the Pool resource. |
|
abstract
Upgrade |
upgradePolicy()
Gets the upgrade |
|
abstract
List<User |
userAccounts()
Gets the user |
| abstract String |
vmSize()
Gets the vm |
Method Details
allocationState
public abstract AllocationState allocationState()
Gets the allocationState property: Whether the pool is resizing.
Returns:
allocationStateTransitionTime
public abstract OffsetDateTime allocationStateTransitionTime()
Gets the allocationStateTransitionTime property: The time at which the pool entered its current allocation state.
Returns:
applicationLicenses
public abstract List<String> applicationLicenses()
Gets the applicationLicenses property: The list of application licenses must be a subset of available Batch service application licenses. If a license is requested which is not supported, pool creation will fail.
Returns:
applicationPackages
public abstract List<ApplicationPackageReference> applicationPackages()
Gets the applicationPackages property: Changes to application package references affect all new compute nodes joining the pool, but do not affect compute nodes that are already in the pool until they are rebooted or reimaged. There is a maximum of 10 application package references on any given pool.
Returns:
autoScaleRun
public abstract AutoScaleRun autoScaleRun()
Gets the autoScaleRun property: This property is set only if the pool automatically scales, i.e. autoScaleSettings are used.
Returns:
certificates
public abstract List<CertificateReference> certificates()
Gets the certificates property: For Windows compute nodes, the Batch service installs the certificates to the specified certificate store and location. For Linux compute nodes, the certificates are stored in a directory inside the task working directory and an environment variable AZ_BATCH_CERTIFICATES_DIR is supplied to the task to query for this location. For certificates with visibility of 'remoteUser', a 'certs' directory is created in the user's home directory (e.g., /home/{user-name}/certs) and certificates are placed in that directory. Warning: This property is deprecated and will be removed after February, 2024. Please use the [Azure KeyVault Extension](https://learn.microsoft.com/azure/batch/batch-certificate-migration-guide) instead.
Returns:
creationTime
public abstract OffsetDateTime creationTime()
Gets the creationTime property: The creation time of the pool.
Returns:
currentDedicatedNodes
public abstract Integer currentDedicatedNodes()
Gets the currentDedicatedNodes property: The number of dedicated compute nodes currently in the pool.
Returns:
currentLowPriorityNodes
public abstract Integer currentLowPriorityNodes()
Gets the currentLowPriorityNodes property: The number of Spot/low-priority compute nodes currently in the pool.
Returns:
currentNodeCommunicationMode
public abstract NodeCommunicationMode currentNodeCommunicationMode()
Gets the currentNodeCommunicationMode property: Determines how a pool communicates with the Batch service.
Returns:
deploymentConfiguration
public abstract DeploymentConfiguration deploymentConfiguration()
Gets the deploymentConfiguration property: Deployment configuration properties.
Returns:
disableAutoScale
public abstract Pool disableAutoScale()
Disables automatic scaling for a pool.
Returns:
disableAutoScaleWithResponse
public abstract Response<Pool> disableAutoScaleWithResponse(Context context)
Disables automatic scaling for a pool.
Parameters:
Returns:
displayName
public abstract String displayName()
Gets the displayName property: The display name need not be unique and can contain any Unicode characters up to a maximum length of 1024.
Returns:
etag
public abstract String etag()
Gets the etag property: The ETag of the resource, used for concurrency statements.
Returns:
id
public abstract String id()
Gets the id property: Fully qualified resource Id for the resource.
Returns:
identity
public abstract BatchPoolIdentity identity()
Gets the identity property: The type of identity used for the Batch Pool.
Returns:
innerModel
public abstract PoolInner innerModel()
Gets the inner com.azure.resourcemanager.batch.fluent.models.PoolInner object.
Returns:
interNodeCommunication
public abstract InterNodeCommunicationState interNodeCommunication()
Gets the interNodeCommunication property: This imposes restrictions on which nodes can be assigned to the pool. Enabling this value can reduce the chance of the requested number of nodes to be allocated in the pool. If not specified, this value defaults to 'Disabled'.
Returns:
lastModified
public abstract OffsetDateTime lastModified()
Gets the lastModified property: This is the last time at which the pool level data, such as the targetDedicatedNodes or autoScaleSettings, changed. It does not factor in node-level changes such as a compute node changing state.
Returns:
metadata
public abstract List<MetadataItem> metadata()
Gets the metadata property: The Batch service does not assign any meaning to metadata; it is solely for the use of user code.
Returns:
mountConfiguration
public abstract List<MountConfiguration> mountConfiguration()
Gets the mountConfiguration property: This supports Azure Files, NFS, CIFS/SMB, and Blobfuse.
Returns:
name
public abstract String name()
Gets the name property: The name of the resource.
Returns:
networkConfiguration
public abstract NetworkConfiguration networkConfiguration()
Gets the networkConfiguration property: The network configuration for a pool.
Returns:
provisioningState
public abstract PoolProvisioningState provisioningState()
Gets the provisioningState property: The current state of the pool.
Returns:
provisioningStateTransitionTime
public abstract OffsetDateTime provisioningStateTransitionTime()
Gets the provisioningStateTransitionTime property: The time at which the pool entered its current state.
Returns:
refresh
public abstract Pool refresh()
Refreshes the resource to sync with Azure.
Returns:
refresh
public abstract Pool refresh(Context context)
Refreshes the resource to sync with Azure.
Parameters:
Returns:
resizeOperationStatus
public abstract ResizeOperationStatus resizeOperationStatus()
Gets the resizeOperationStatus property: Describes either the current operation (if the pool AllocationState is Resizing) or the previously completed operation (if the AllocationState is Steady).
Returns:
resourceGroupName
public abstract String resourceGroupName()
Gets the name of the resource group.
Returns:
resourceTags
public abstract Map<String,String> resourceTags()
Gets the resourceTags property: The user-defined tags to be associated with the Azure Batch Pool. When specified, these tags are propagated to the backing Azure resources associated with the pool. This property can only be specified when the Batch account was created with the poolAllocationMode property set to 'UserSubscription'.
Returns:
scaleSettings
public abstract ScaleSettings scaleSettings()
Gets the scaleSettings property: Defines the desired size of the pool. This can either be 'fixedScale' where the requested targetDedicatedNodes is specified, or 'autoScale' which defines a formula which is periodically reevaluated. If this property is not specified, the pool will have a fixed scale with 0 targetDedicatedNodes.
Returns:
startTask
public abstract StartTask startTask()
Gets the startTask property: In an PATCH (update) operation, this property can be set to an empty object to remove the start task from the pool.
Returns:
stopResize
public abstract Pool stopResize()
Stops an ongoing resize operation on the pool. This does not restore the pool to its previous state before the resize operation: it only stops any further changes being made, and the pool maintains its current state. After stopping, the pool stabilizes at the number of nodes it was at when the stop operation was done. During the stop operation, the pool allocation state changes first to stopping and then to steady. A resize operation need not be an explicit resize pool request; this API can also be used to halt the initial sizing of the pool when it is created.
Returns:
stopResizeWithResponse
public abstract Response<Pool> stopResizeWithResponse(Context context)
Stops an ongoing resize operation on the pool. This does not restore the pool to its previous state before the resize operation: it only stops any further changes being made, and the pool maintains its current state. After stopping, the pool stabilizes at the number of nodes it was at when the stop operation was done. During the stop operation, the pool allocation state changes first to stopping and then to steady. A resize operation need not be an explicit resize pool request; this API can also be used to halt the initial sizing of the pool when it is created.
Parameters:
Returns:
tags
public abstract Map<String,String> tags()
Gets the tags property: The tags of the resource.
Returns:
targetNodeCommunicationMode
public abstract NodeCommunicationMode targetNodeCommunicationMode()
Gets the targetNodeCommunicationMode property: If omitted, the default value is Default.
Returns:
taskSchedulingPolicy
public abstract TaskSchedulingPolicy taskSchedulingPolicy()
Gets the taskSchedulingPolicy property: If not specified, the default is spread.
Returns:
taskSlotsPerNode
public abstract Integer taskSlotsPerNode()
Gets the taskSlotsPerNode property: The default value is 1. The maximum value is the smaller of 4 times the number of cores of the vmSize of the pool or 256.
Returns:
type
public abstract String type()
Gets the type property: The type of the resource.
Returns:
update
public abstract Pool.Update update()
Begins update for the Pool resource.
Returns:
upgradePolicy
public abstract UpgradePolicy upgradePolicy()
Gets the upgradePolicy property: Describes an upgrade policy - automatic, manual, or rolling.
Returns:
userAccounts
public abstract List<UserAccount> userAccounts()
Gets the userAccounts property: The list of user accounts to be created on each node in the pool.
Returns:
vmSize
public abstract String vmSize()
Gets the vmSize property: For information about available VM sizes, see Sizes for Virtual Machines (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) or Sizes for Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch supports all Azure VM sizes except STANDARD_A0 and those with premium storage (STANDARD_GS, STANDARD_DS, and STANDARD_DSV2 series).
Returns: