AFD Profiles - Check Host Name Availability

Layanan:

Front Door Service

Versi API:

2025-04-15

Memvalidasi pemetaan domain kustom untuk memastikannya dipetakan ke titik akhir Azure Front Door yang benar di DNS.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Cdn/profiles/{profileName}/checkHostNameAvailability?api-version=2025-04-15

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
profileName	path	True	string minLength: 1 maxLength: 260 pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$	Nama Azure Front Door Standard atau Azure Front Door Premium yang unik dalam grup sumber daya.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._\(\)]+$	Nama grup Sumber Daya dalam langganan Azure.
subscriptionId	path	True	string	ID Langganan Azure.
api-version	query	True	string	Versi API yang akan digunakan dengan permintaan klien. Versi saat ini adalah 2025-04-15.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
hostName	True	string	Nama host untuk divalidasi.

Respons

Nama	Jenis	Deskripsi
200 OK	CheckNameAvailabilityOutput	OKE. The request has succeeded.
Other Status Codes	AfdErrorResponse	Respons kesalahan Azure Front Door 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

AFDProfiles_CheckHostNameAvailability

Permintaan sampel

HTTP

POST https://management.azure.com/subscriptions/subid/resourceGroups/RG/providers/Microsoft.Cdn/profiles/profile1/checkHostNameAvailability?api-version=2025-04-15

{
  "hostName": "www.someDomain.net"
}

Respon sampel

Kode status:

200

{
  "nameAvailable": false,
  "reason": "Conflict",
  "message": "The hostname 'www.someDomain.net' is already owned by another profile."
}

Definisi

Nama	Deskripsi
AfdErrorResponse	Tanggapan kesalahan
CheckHostNameAvailabilityInput	Input of CheckHostNameAvailability API.
CheckNameAvailabilityOutput	Output api ketersediaan nama pemeriksaan.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.

AfdErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

CheckHostNameAvailabilityInput

Objek

Input of CheckHostNameAvailability API.

Nama	Jenis	Deskripsi
hostName	string	Nama host untuk divalidasi.

CheckNameAvailabilityOutput

Objek

Output api ketersediaan nama pemeriksaan.

Nama	Jenis	Deskripsi
message	string	Pesan kesalahan terperinci yang menjelaskan mengapa nama tidak tersedia.
nameAvailable	boolean	Menunjukkan apakah nama tersedia.
reason	string	Alasan mengapa nama tidak tersedia.

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.