AFD Profiles - Check Host Name Availability

Service:

Front Door Service

Version d'API:

2025-04-15

Valide le mappage de domaine personnalisé pour s’assurer qu’il est mappé au point de terminaison Azure Front Door approprié dans DNS.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
profileName	path	True	string minLength: 1 maxLength: 260 pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$	Nom d’Azure Front Door Standard ou d’Azure Front Door Premium qui est unique dans le groupe de ressources.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._\(\)]+$	Nom du groupe de ressources dans l’abonnement Azure.
subscriptionId	path	True	string	ID d’abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser avec la demande cliente. La version actuelle est 2025-04-15.

Corps de la demande

Nom	Obligatoire	Type	Description
hostName	True	string	Nom d’hôte à valider.

Réponses

Nom	Type	Description
200 OK	CheckNameAvailabilityOutput	D’ACCORD. The request has succeeded.
Other Status Codes	AfdErrorResponse	Réponse d’erreur Azure Front Door décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

AFDProfiles_CheckHostNameAvailability

Exemple de requête

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"
}

Exemple de réponse

Code d’état:

200

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

Définitions

Nom	Description
AfdErrorResponse	Réponse d’erreur
CheckHostNameAvailabilityInput	Entrée de l’API CheckHostNameAvailability.
CheckNameAvailabilityOutput	Sortie de l’API de disponibilité du nom de vérification.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.

AfdErrorResponse

Object

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

CheckHostNameAvailabilityInput

Object

Entrée de l’API CheckHostNameAvailability.

Nom	Type	Description
hostName	string	Nom d’hôte à valider.

CheckNameAvailabilityOutput

Object

Sortie de l’API de disponibilité du nom de vérification.

Nom	Type	Description
message	string	Message d’erreur détaillé décrivant pourquoi le nom n’est pas disponible.
nameAvailable	boolean	Indique si le nom est disponible.
reason	string	Raison pour laquelle le nom n’est pas disponible.

ErrorAdditionalInfo

Object

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Object

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.