Virtual Networks - Check IP Address Availability

Controleert of een privé-IP-adres beschikbaar is voor gebruik.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/CheckIPAddressAvailability?ipAddress={ipAddress}&api-version=2023-09-01

URI-parameters

Name In Vereist Type Description
resourceGroupName
path True

string

De naam van de resourcegroep.

subscriptionId
path True

string

De abonnementsreferenties waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke service-aanroep.

virtualNetworkName
path True

string

De naam van het virtuele netwerk.

api-version
query True

string

Client-API-versie.

ipAddress
query True

string

Het privé-IP-adres dat moet worden geverifieerd.

Antwoorden

Name Type Description
200 OK

IPAddressAvailabilityResult

Beschikbaarheid van privé-IP-adressen en een lijst met andere gratis adressen als de aangevraagde niet beschikbaar is.

Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation uw gebruikersaccount imiteren

Voorbeelden

Check IP address availability

Sample Request

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/CheckIPAddressAvailability?ipAddress=10.0.1.4&api-version=2023-09-01

Sample Response

{
  "available": false,
  "availableIPAddresses": [
    "10.0.1.5",
    "10.0.1.6",
    "10.0.1.7",
    "10.0.1.8",
    "10.0.1.9"
  ]
}

Definities

Name Description
CloudError

Een foutreactie van de service.

CloudErrorBody

Een foutreactie van de service.

IPAddressAvailabilityResult

Antwoord voor checkIPAddressAvailability API-serviceaanroep.

CloudError

Een foutreactie van de service.

Name Type Description
error

CloudErrorBody

Hoofdtekst van cloudfout.

CloudErrorBody

Een foutreactie van de service.

Name Type Description
code

string

Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.

details

CloudErrorBody[]

Een lijst met aanvullende informatie over de fout.

message

string

Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.

target

string

Het doel van de specifieke fout. Bijvoorbeeld de naam van de eigenschap in fout.

IPAddressAvailabilityResult

Antwoord voor checkIPAddressAvailability API-serviceaanroep.

Name Type Description
available

boolean

Beschikbaarheid van privé-IP-adressen.

availableIPAddresses

string[]

Bevat andere beschikbare privé-IP-adressen als het aangevraagde adres wordt gebruikt.

isPlatformReserved

boolean

Privé-IP-adresplatform gereserveerd.