Partager via


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

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

Réponse d’erreur

Nom Type Description
error

ErrorDetail

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

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.