Share via


NetworkConfiguration Class

  • java.lang.Object
    • com.azure.compute.batch.models.NetworkConfiguration

Implements

public final class NetworkConfiguration
implements JsonSerializable<NetworkConfiguration>

The network configuration for a Pool.

Constructor Summary

Constructor Description
NetworkConfiguration()

Creates an instance of NetworkConfiguration class.

Method Summary

Modifier and Type Method and Description
static NetworkConfiguration fromJson(JsonReader jsonReader)

Reads an instance of NetworkConfiguration from the JsonReader.

DynamicVNetAssignmentScope getDynamicVnetAssignmentScope()

Get the dynamicVnetAssignmentScope property: The scope of dynamic vnet assignment.

BatchPoolEndpointConfiguration getEndpointConfiguration()

Get the endpointConfiguration property: The configuration for endpoints on Compute Nodes in the Batch Pool.

BatchPublicIpAddressConfiguration getPublicIpAddressConfiguration()

Get the publicIpAddressConfiguration property: The Public IPAddress configuration for Compute Nodes in the Batch Pool.

String getSubnetId()

Get the subnetId property: The ARM resource identifier of the virtual network subnet which the Compute Nodes of the Pool will join.

Boolean isEnableAcceleratedNetworking()

Get the enableAcceleratedNetworking property: Whether this pool should enable accelerated networking.

NetworkConfiguration setDynamicVnetAssignmentScope(DynamicVNetAssignmentScope dynamicVnetAssignmentScope)

Set the dynamicVnetAssignmentScope property: The scope of dynamic vnet assignment.

NetworkConfiguration setEnableAcceleratedNetworking(Boolean enableAcceleratedNetworking)

Set the enableAcceleratedNetworking property: Whether this pool should enable accelerated networking.

NetworkConfiguration setEndpointConfiguration(BatchPoolEndpointConfiguration endpointConfiguration)

Set the endpointConfiguration property: The configuration for endpoints on Compute Nodes in the Batch Pool.

NetworkConfiguration setPublicIpAddressConfiguration(BatchPublicIpAddressConfiguration publicIpAddressConfiguration)

Set the publicIpAddressConfiguration property: The Public IPAddress configuration for Compute Nodes in the Batch Pool.

NetworkConfiguration setSubnetId(String subnetId)

Set the subnetId property: The ARM resource identifier of the virtual network subnet which the Compute Nodes of the Pool will join.

JsonWriter toJson(JsonWriter jsonWriter)

Methods inherited from java.lang.Object

Constructor Details

NetworkConfiguration

public NetworkConfiguration()

Creates an instance of NetworkConfiguration class.

Method Details

fromJson

public static NetworkConfiguration fromJson(JsonReader jsonReader)

Reads an instance of NetworkConfiguration from the JsonReader.

Parameters:

jsonReader - The JsonReader being read.

Returns:

An instance of NetworkConfiguration if the JsonReader was pointing to an instance of it, or null if it was pointing to JSON null.

Throws:

IOException

- If an error occurs while reading the NetworkConfiguration.

getDynamicVnetAssignmentScope

public DynamicVNetAssignmentScope getDynamicVnetAssignmentScope()

Get the dynamicVnetAssignmentScope property: The scope of dynamic vnet assignment.

Returns:

the dynamicVnetAssignmentScope value.

getEndpointConfiguration

public BatchPoolEndpointConfiguration getEndpointConfiguration()

Get the endpointConfiguration property: The configuration for endpoints on Compute Nodes in the Batch Pool.

Returns:

the endpointConfiguration value.

getPublicIpAddressConfiguration

public BatchPublicIpAddressConfiguration getPublicIpAddressConfiguration()

Get the publicIpAddressConfiguration property: The Public IPAddress configuration for Compute Nodes in the Batch Pool.

Returns:

the publicIpAddressConfiguration value.

getSubnetId

public String getSubnetId()

Get the subnetId property: The ARM resource identifier of the virtual network subnet which the Compute Nodes of the Pool will join. This is of the form /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. The virtual network must be in the same region and subscription as the Azure Batch Account. The specified subnet should have enough free IP addresses to accommodate the number of Compute Nodes in the Pool. If the subnet doesn't have enough free IP addresses, the Pool will partially allocate Nodes and a resize error will occur. The 'MicrosoftAzureBatch' service principal must have the 'Classic Virtual Machine Contributor' Role-Based Access Control (RBAC) role for the specified VNet. The specified subnet must allow communication from the Azure Batch service to be able to schedule Tasks on the Nodes. This can be verified by checking if the specified VNet has any associated Network Security Groups (NSG). If communication to the Nodes in the specified subnet is denied by an NSG, then the Batch service will set the state of the Compute Nodes to unusable. Only ARM virtual networks ('Microsoft.Network/virtualNetworks') are supported. If the specified VNet has any associated Network Security Groups (NSG), then a few reserved system ports must be enabled for inbound communication, including ports 29876 and 29877. Also enable outbound connections to Azure Storage on port 443. For more details see: https://learn.microsoft.com/azure/batch/nodes-and-pools\#virtual-network-vnet-and-firewall-configuration.

Returns:

the subnetId value.

isEnableAcceleratedNetworking

public Boolean isEnableAcceleratedNetworking()

Get the enableAcceleratedNetworking property: Whether this pool should enable accelerated networking. Accelerated networking enables single root I/O virtualization (SR-IOV) to a VM, which may lead to improved networking performance. For more details, see: https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview.

Returns:

the enableAcceleratedNetworking value.

setDynamicVnetAssignmentScope

public NetworkConfiguration setDynamicVnetAssignmentScope(DynamicVNetAssignmentScope dynamicVnetAssignmentScope)

Set the dynamicVnetAssignmentScope property: The scope of dynamic vnet assignment.

Parameters:

dynamicVnetAssignmentScope - the dynamicVnetAssignmentScope value to set.

Returns:

the NetworkConfiguration object itself.

setEnableAcceleratedNetworking

public NetworkConfiguration setEnableAcceleratedNetworking(Boolean enableAcceleratedNetworking)

Set the enableAcceleratedNetworking property: Whether this pool should enable accelerated networking. Accelerated networking enables single root I/O virtualization (SR-IOV) to a VM, which may lead to improved networking performance. For more details, see: https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview.

Parameters:

enableAcceleratedNetworking - the enableAcceleratedNetworking value to set.

Returns:

the NetworkConfiguration object itself.

setEndpointConfiguration

public NetworkConfiguration setEndpointConfiguration(BatchPoolEndpointConfiguration endpointConfiguration)

Set the endpointConfiguration property: The configuration for endpoints on Compute Nodes in the Batch Pool.

Parameters:

endpointConfiguration - the endpointConfiguration value to set.

Returns:

the NetworkConfiguration object itself.

setPublicIpAddressConfiguration

public NetworkConfiguration setPublicIpAddressConfiguration(BatchPublicIpAddressConfiguration publicIpAddressConfiguration)

Set the publicIpAddressConfiguration property: The Public IPAddress configuration for Compute Nodes in the Batch Pool.

Parameters:

publicIpAddressConfiguration - the publicIpAddressConfiguration value to set.

Returns:

the NetworkConfiguration object itself.

setSubnetId

public NetworkConfiguration setSubnetId(String subnetId)

Set the subnetId property: The ARM resource identifier of the virtual network subnet which the Compute Nodes of the Pool will join. This is of the form /subscriptions/{subscription}/resourceGroups/{group}/providers/{provider}/virtualNetworks/{network}/subnets/{subnet}. The virtual network must be in the same region and subscription as the Azure Batch Account. The specified subnet should have enough free IP addresses to accommodate the number of Compute Nodes in the Pool. If the subnet doesn't have enough free IP addresses, the Pool will partially allocate Nodes and a resize error will occur. The 'MicrosoftAzureBatch' service principal must have the 'Classic Virtual Machine Contributor' Role-Based Access Control (RBAC) role for the specified VNet. The specified subnet must allow communication from the Azure Batch service to be able to schedule Tasks on the Nodes. This can be verified by checking if the specified VNet has any associated Network Security Groups (NSG). If communication to the Nodes in the specified subnet is denied by an NSG, then the Batch service will set the state of the Compute Nodes to unusable. Only ARM virtual networks ('Microsoft.Network/virtualNetworks') are supported. If the specified VNet has any associated Network Security Groups (NSG), then a few reserved system ports must be enabled for inbound communication, including ports 29876 and 29877. Also enable outbound connections to Azure Storage on port 443. For more details see: https://learn.microsoft.com/azure/batch/nodes-and-pools\#virtual-network-vnet-and-firewall-configuration.

Parameters:

subnetId - the subnetId value to set.

Returns:

the NetworkConfiguration object itself.

toJson

public JsonWriter toJson(JsonWriter jsonWriter)

Parameters:

jsonWriter

Throws:

Applies to