Bagikan melalui


Virtual Networks - Check IP Address Availability

Memeriksa apakah alamat IP privat tersedia untuk digunakan.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
resourceGroupName
path True

string

Nama grup sumber daya.

subscriptionId
path True

string

Info masuk langganan yang secara unik mengidentifikasi langganan Microsoft Azure. ID langganan membentuk bagian dari URI untuk setiap panggilan layanan.

virtualNetworkName
path True

string

Nama jaringan virtual.

api-version
query True

string

Versi API Klien.

ipAddress
query True

string

Alamat IP privat yang akan diverifikasi.

Respons

Nama Jenis Deskripsi
200 OK

IPAddressAvailabilityResult

Ketersediaan alamat IP privat dan daftar alamat gratis lainnya jika alamat yang diminta tidak tersedia.

Other Status Codes

CloudError

Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

Check IP address availability

Permintaan sampel

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

Respon sampel

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

Definisi

Nama Deskripsi
CloudError

Respons kesalahan dari layanan.

CloudErrorBody

Respons kesalahan dari layanan.

IPAddressAvailabilityResult

Respons untuk panggilan layanan API CheckIPAddressAvailability.

CloudError

Respons kesalahan dari layanan.

Nama Jenis Deskripsi
error

CloudErrorBody

Isi kesalahan cloud.

CloudErrorBody

Respons kesalahan dari layanan.

Nama Jenis Deskripsi
code

string

Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.

details

CloudErrorBody[]

Daftar detail tambahan tentang kesalahan.

message

string

Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.

target

string

Target kesalahan tertentu. Misalnya, nama properti dalam kesalahan.

IPAddressAvailabilityResult

Respons untuk panggilan layanan API CheckIPAddressAvailability.

Nama Jenis Deskripsi
available

boolean

Ketersediaan alamat IP privat.

availableIPAddresses

string[]

Berisi alamat IP privat lain yang tersedia jika alamat yang diminta diambil.

isPlatformReserved

boolean

Platform alamat IP privat dicadangkan.