PoolInner Class
- java.
lang. Object - com.
azure. core. management. ProxyResource - com.
azure. resourcemanager. batch. fluent. models. PoolInner
- com.
- com.
public final class PoolInner
extends ProxyResource
Contains information about a pool.
Constructor Summary
Constructor | Description |
---|---|
PoolInner() |
Creates an instance of Pool |
Method Summary
Modifier and Type | Method and Description |
---|---|
Allocation |
allocationState()
Get the allocation |
Offset |
allocationStateTransitionTime()
Get the allocation |
List<String> |
applicationLicenses()
Get the application |
List<Application |
applicationPackages()
Get the application |
Auto |
autoScaleRun()
Get the auto |
List<Certificate |
certificates()
Get the certificates property: The list of certificates to be installed on each compute node in the pool. |
Offset |
creationTime()
Get the creation |
Integer |
currentDedicatedNodes()
Get the current |
Integer |
currentLowPriorityNodes()
Get the current |
Node |
currentNodeCommunicationMode()
Get the current |
Deployment |
deploymentConfiguration()
Get the deployment |
String |
displayName()
Get the display |
String |
etag()
Get the etag property: The ETag of the resource, used for concurrency statements. |
Batch |
identity()
Get the identity property: The type of identity used for the Batch Pool. |
Inter |
interNodeCommunication()
Get the inter |
Offset |
lastModified()
Get the last |
List<Metadata |
metadata()
Get the metadata property: A list of name-value pairs associated with the pool as metadata. |
List<Mount |
mountConfiguration()
Get the mount |
Network |
networkConfiguration()
Get the network |
Pool |
provisioningState()
Get the provisioning |
Offset |
provisioningStateTransitionTime()
Get the provisioning |
Resize |
resizeOperationStatus()
Get the resize |
Map<String,String> |
resourceTags()
Get the resource |
Scale |
scaleSettings()
Get the scale |
Start |
startTask()
Get the start |
Node |
targetNodeCommunicationMode()
Get the target |
Task |
taskSchedulingPolicy()
Get the task |
Integer |
taskSlotsPerNode()
Get the task |
Upgrade |
upgradePolicy()
Get the upgrade |
List<User |
userAccounts()
Get the user |
void |
validate()
Validates the instance. |
String |
vmSize()
Get the vm |
Pool |
withApplicationLicenses(List<String> applicationLicenses)
Set the application |
Pool |
withApplicationPackages(List<ApplicationPackageReference> applicationPackages)
Set the application |
Pool |
withCertificates(List<CertificateReference> certificates)
Set the certificates property: The list of certificates to be installed on each compute node in the pool. |
Pool |
withDeploymentConfiguration(DeploymentConfiguration deploymentConfiguration)
Set the deployment |
Pool |
withDisplayName(String displayName)
Set the display |
Pool |
withIdentity(BatchPoolIdentity identity)
Set the identity property: The type of identity used for the Batch Pool. |
Pool |
withInterNodeCommunication(InterNodeCommunicationState interNodeCommunication)
Set the inter |
Pool |
withMetadata(List<MetadataItem> metadata)
Set the metadata property: A list of name-value pairs associated with the pool as metadata. |
Pool |
withMountConfiguration(List<MountConfiguration> mountConfiguration)
Set the mount |
Pool |
withNetworkConfiguration(NetworkConfiguration networkConfiguration)
Set the network |
Pool |
withResourceTags(Map<String,String> resourceTags)
Set the resource |
Pool |
withScaleSettings(ScaleSettings scaleSettings)
Set the scale |
Pool |
withStartTask(StartTask startTask)
Set the start |
Pool |
withTargetNodeCommunicationMode(NodeCommunicationMode targetNodeCommunicationMode)
Set the target |
Pool |
withTaskSchedulingPolicy(TaskSchedulingPolicy taskSchedulingPolicy)
Set the task |
Pool |
withTaskSlotsPerNode(Integer taskSlotsPerNode)
Set the task |
Pool |
withUpgradePolicy(UpgradePolicy upgradePolicy)
Set the upgrade |
Pool |
withUserAccounts(List<UserAccount> userAccounts)
Set the user |
Pool |
withVmSize(String vmSize)
Set the vm |
Methods inherited from ProxyResource
Methods inherited from java.lang.Object
Constructor Details
PoolInner
public PoolInner()
Creates an instance of PoolInner class.
Method Details
allocationState
public AllocationState allocationState()
Get the allocationState property: Whether the pool is resizing.
Returns:
allocationStateTransitionTime
public OffsetDateTime allocationStateTransitionTime()
Get the allocationStateTransitionTime property: The time at which the pool entered its current allocation state.
Returns:
applicationLicenses
public List
Get the applicationLicenses property: The list of application licenses the Batch service will make available on each compute node in the pool. 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 List
Get the applicationPackages property: The list of application packages to be installed on each compute node in the pool. 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 AutoScaleRun autoScaleRun()
Get the autoScaleRun property: The results and errors from an execution of a pool autoscale formula. This property is set only if the pool automatically scales, i.e. autoScaleSettings are used.
Returns:
certificates
public List
Get the certificates property: The list of certificates to be installed on each compute node in the pool. 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 OffsetDateTime creationTime()
Get the creationTime property: The creation time of the pool.
Returns:
currentDedicatedNodes
public Integer currentDedicatedNodes()
Get the currentDedicatedNodes property: The number of dedicated compute nodes currently in the pool.
Returns:
currentLowPriorityNodes
public Integer currentLowPriorityNodes()
Get the currentLowPriorityNodes property: The number of Spot/low-priority compute nodes currently in the pool.
Returns:
currentNodeCommunicationMode
public NodeCommunicationMode currentNodeCommunicationMode()
Get the currentNodeCommunicationMode property: Determines how a pool communicates with the Batch service.
Returns:
deploymentConfiguration
public DeploymentConfiguration deploymentConfiguration()
Get the deploymentConfiguration property: Deployment configuration properties. Using CloudServiceConfiguration specifies that the nodes should be creating using Azure Cloud Services (PaaS), while VirtualMachineConfiguration uses Azure Virtual Machines (IaaS).
Returns:
displayName
public String displayName()
Get the displayName property: The display name for the pool. The display name need not be unique and can contain any Unicode characters up to a maximum length of 1024.
Returns:
etag
public String etag()
Get the etag property: The ETag of the resource, used for concurrency statements.
Returns:
identity
public BatchPoolIdentity identity()
Get the identity property: The type of identity used for the Batch Pool.
Returns:
interNodeCommunication
public InterNodeCommunicationState interNodeCommunication()
Get the interNodeCommunication property: Whether the pool permits direct communication between nodes. 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 OffsetDateTime lastModified()
Get the lastModified property: The last modified time of the pool. 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 List
Get the metadata property: A list of name-value pairs associated with the pool as metadata. The Batch service does not assign any meaning to metadata; it is solely for the use of user code.
Returns:
mountConfiguration
public List
Get the mountConfiguration property: A list of file systems to mount on each node in the pool. This supports Azure Files, NFS, CIFS/SMB, and Blobfuse.
Returns:
networkConfiguration
public NetworkConfiguration networkConfiguration()
Get the networkConfiguration property: The network configuration for a pool.
Returns:
provisioningState
public PoolProvisioningState provisioningState()
Get the provisioningState property: The current state of the pool.
Returns:
provisioningStateTransitionTime
public OffsetDateTime provisioningStateTransitionTime()
Get the provisioningStateTransitionTime property: The time at which the pool entered its current state.
Returns:
resizeOperationStatus
public ResizeOperationStatus resizeOperationStatus()
Get the resizeOperationStatus property: Details about the current or last completed resize operation. Describes either the current operation (if the pool AllocationState is Resizing) or the previously completed operation (if the AllocationState is Steady).
Returns:
resourceTags
public Map
Get 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 ScaleSettings scaleSettings()
Get the scaleSettings property: Scale settings for the pool 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 StartTask startTask()
Get the startTask property: A task which is run when a compute node joins a pool in the Azure Batch service, or when the compute node is rebooted or reimaged. In an PATCH (update) operation, this property can be set to an empty object to remove the start task from the pool.
Returns:
targetNodeCommunicationMode
public NodeCommunicationMode targetNodeCommunicationMode()
Get the targetNodeCommunicationMode property: Determines how a pool communicates with the Batch service. If omitted, the default value is Default.
Returns:
taskSchedulingPolicy
public TaskSchedulingPolicy taskSchedulingPolicy()
Get the taskSchedulingPolicy property: Specifies how tasks should be distributed across compute nodes. If not specified, the default is spread.
Returns:
taskSlotsPerNode
public Integer taskSlotsPerNode()
Get the taskSlotsPerNode property: The number of task slots that can be used to run concurrent tasks on a single compute node in the pool. 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:
upgradePolicy
public UpgradePolicy upgradePolicy()
Get the upgradePolicy property: Describes an upgrade policy - automatic, manual, or rolling.
Returns:
userAccounts
public List
Get the userAccounts property: The list of user accounts to be created on each node in the pool.
Returns:
validate
public void validate()
Validates the instance.
vmSize
public String vmSize()
Get the vmSize property: The size of virtual machines in the pool. All VMs in a pool are the same size. For information about available sizes of virtual machines for Cloud Services pools (pools created with cloudServiceConfiguration), see Sizes for Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch supports all Cloud Services VM sizes except ExtraSmall. For information about available VM sizes for pools using images from the Virtual Machines Marketplace (pools created with virtualMachineConfiguration) 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:
withApplicationLicenses
public PoolInner withApplicationLicenses(List
Set the applicationLicenses property: The list of application licenses the Batch service will make available on each compute node in the pool. 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.
Parameters:
Returns:
withApplicationPackages
public PoolInner withApplicationPackages(List
Set the applicationPackages property: The list of application packages to be installed on each compute node in the pool. 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.
Parameters:
Returns:
withCertificates
public PoolInner withCertificates(List
Set the certificates property: The list of certificates to be installed on each compute node in the pool. 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.
Parameters:
Returns:
withDeploymentConfiguration
public PoolInner withDeploymentConfiguration(DeploymentConfiguration deploymentConfiguration)
Set the deploymentConfiguration property: Deployment configuration properties. Using CloudServiceConfiguration specifies that the nodes should be creating using Azure Cloud Services (PaaS), while VirtualMachineConfiguration uses Azure Virtual Machines (IaaS).
Parameters:
Returns:
withDisplayName
public PoolInner withDisplayName(String displayName)
Set the displayName property: The display name for the pool. The display name need not be unique and can contain any Unicode characters up to a maximum length of 1024.
Parameters:
Returns:
withIdentity
public PoolInner withIdentity(BatchPoolIdentity identity)
Set the identity property: The type of identity used for the Batch Pool.
Parameters:
Returns:
withInterNodeCommunication
public PoolInner withInterNodeCommunication(InterNodeCommunicationState interNodeCommunication)
Set the interNodeCommunication property: Whether the pool permits direct communication between nodes. 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'.
Parameters:
Returns:
withMetadata
public PoolInner withMetadata(List
Set the metadata property: A list of name-value pairs associated with the pool as metadata. The Batch service does not assign any meaning to metadata; it is solely for the use of user code.
Parameters:
Returns:
withMountConfiguration
public PoolInner withMountConfiguration(List
Set the mountConfiguration property: A list of file systems to mount on each node in the pool. This supports Azure Files, NFS, CIFS/SMB, and Blobfuse.
Parameters:
Returns:
withNetworkConfiguration
public PoolInner withNetworkConfiguration(NetworkConfiguration networkConfiguration)
Set the networkConfiguration property: The network configuration for a pool.
Parameters:
Returns:
withResourceTags
public PoolInner withResourceTags(Map
Set 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'.
Parameters:
Returns:
withScaleSettings
public PoolInner withScaleSettings(ScaleSettings scaleSettings)
Set the scaleSettings property: Scale settings for the pool 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.
Parameters:
Returns:
withStartTask
public PoolInner withStartTask(StartTask startTask)
Set the startTask property: A task which is run when a compute node joins a pool in the Azure Batch service, or when the compute node is rebooted or reimaged. In an PATCH (update) operation, this property can be set to an empty object to remove the start task from the pool.
Parameters:
Returns:
withTargetNodeCommunicationMode
public PoolInner withTargetNodeCommunicationMode(NodeCommunicationMode targetNodeCommunicationMode)
Set the targetNodeCommunicationMode property: Determines how a pool communicates with the Batch service. If omitted, the default value is Default.
Parameters:
Returns:
withTaskSchedulingPolicy
public PoolInner withTaskSchedulingPolicy(TaskSchedulingPolicy taskSchedulingPolicy)
Set the taskSchedulingPolicy property: Specifies how tasks should be distributed across compute nodes. If not specified, the default is spread.
Parameters:
Returns:
withTaskSlotsPerNode
public PoolInner withTaskSlotsPerNode(Integer taskSlotsPerNode)
Set the taskSlotsPerNode property: The number of task slots that can be used to run concurrent tasks on a single compute node in the pool. 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.
Parameters:
Returns:
withUpgradePolicy
public PoolInner withUpgradePolicy(UpgradePolicy upgradePolicy)
Set the upgradePolicy property: Describes an upgrade policy - automatic, manual, or rolling.
Parameters:
Returns:
withUserAccounts
public PoolInner withUserAccounts(List
Set the userAccounts property: The list of user accounts to be created on each node in the pool.
Parameters:
Returns:
withVmSize
public PoolInner withVmSize(String vmSize)
Set the vmSize property: The size of virtual machines in the pool. All VMs in a pool are the same size. For information about available sizes of virtual machines for Cloud Services pools (pools created with cloudServiceConfiguration), see Sizes for Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch supports all Cloud Services VM sizes except ExtraSmall. For information about available VM sizes for pools using images from the Virtual Machines Marketplace (pools created with virtualMachineConfiguration) 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).
Parameters:
Returns:
Applies to
Azure SDK for Java
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for