VirtualNetworkResource.CheckIPAddressAvailability Method

Definition

Checks whether a private IP address is available for use.

  • Request Path. : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/checkIPAddressAvailability.
  • Operation Id. : VirtualNetworks_CheckIPAddressAvailability.
  • Default Api Version. : 2025-07-01.
  • Resource. : VirtualNetworkResource.
public virtual Azure.Response<Azure.ResourceManager.Network.Models.IPAddressAvailabilityResult> CheckIPAddressAvailability(string ipAddress, System.Threading.CancellationToken cancellationToken = default);
abstract member CheckIPAddressAvailability : string * System.Threading.CancellationToken -> Azure.Response<Azure.ResourceManager.Network.Models.IPAddressAvailabilityResult>
override this.CheckIPAddressAvailability : string * System.Threading.CancellationToken -> Azure.Response<Azure.ResourceManager.Network.Models.IPAddressAvailabilityResult>
Public Overridable Function CheckIPAddressAvailability (ipAddress As String, Optional cancellationToken As CancellationToken = Nothing) As Response(Of IPAddressAvailabilityResult)

Parameters

ipAddress
String

The private IP address to be verified.

cancellationToken
CancellationToken

The cancellation token to use.

Returns

Exceptions

ipAddress is null.

ipAddress is an empty string, and was expected to be non-empty.

Applies to