AFD Profiles - Check Host Name Availability
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 |
---|---|---|---|---|
profile
|
path | True |
string minLength: 1maxLength: 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. |
resource
|
path | True |
string minLength: 1maxLength: 90 pattern: ^[-\w\._\(\)]+$ |
Nom du groupe de ressources dans l’abonnement Azure. |
subscription
|
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 |
D’ACCORD. The request has succeeded. |
|
Other Status Codes |
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
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
{
"nameAvailable": false,
"reason": "Conflict",
"message": "The hostname 'www.someDomain.net' is already owned by another profile."
}
Définitions
Nom | Description |
---|---|
Afd |
Réponse d’erreur |
Check |
Entrée de l’API CheckHostNameAvailability. |
Check |
Sortie de l’API de disponibilité du nom de vérification. |
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
Error |
Détail de l’erreur. |
AfdErrorResponse
Réponse d’erreur
Nom | Type | Description |
---|---|---|
error |
Objet d’erreur. |
CheckHostNameAvailabilityInput
Entrée de l’API CheckHostNameAvailability.
Nom | Type | Description |
---|---|---|
hostName |
string |
Nom d’hôte à valider. |
CheckNameAvailabilityOutput
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
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
Détail de l’erreur.
Nom | Type | Description |
---|---|---|
additionalInfo |
Informations supplémentaires sur l’erreur. |
|
code |
string |
Code d’erreur. |
details |
Détails de l’erreur. |
|
message |
string |
Message d’erreur. |
target |
string |
Cible d’erreur. |