Vérifier la disponibilité du domaine

Article
09/12/2024

S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government

Comment déterminer si un domaine est disponible pour une utilisation.

Prérequis

Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec des informations d’identification d’application et d’utilisateur autonomes.
Un domaine (par exemple contoso.onmicrosoft.com).

C#

Pour vérifier si un domaine est disponible, appelez d’abord IAggregatePartner.Domains pour obtenir une interface aux opérations de domaine. Appelez ensuite la méthode ByDomain avec le domaine pour case activée. Cette méthode récupère une interface pour les opérations disponibles pour un domaine spécifique. Enfin, appelez la méthode Exists pour voir si le domaine existe déjà.

// IAggregatePartner partnerOperations;
// const string domain = "contoso.onmicrosoft.com";

bool result = partnerOperations.Domains.ByDomain(domain).Exists();

Exemple : Application de test console. Project: Partner Center SDK Samples Class: CheckDomainAvailability.cs

Demande REST

Syntaxe de la requête

Méthode	URI de demande
HEAD	{baseURL}/v1/domains/{domain} HTTP/1.1

Paramètre d’URI

Utilisez le paramètre de requête suivant pour vérifier la disponibilité du domaine.

Nom	Type	Obligatoire	Description
domaine	string	O	Chaîne identifiant le domaine à vérifier.

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de demande

None

Exemple de requête

HEAD https://api.partnercenter.microsoft.com/v1/domains/contoso.onmicrosoft.com HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: cf5b00d6-9240-431c-a973-cc06c904e5bf
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

Réponse REST

Si le domaine existe, il n’est pas disponible pour utilisation et une réponse status code 200 OK est retournée. Si le domaine est introuvable, il peut être utilisé et une réponse status code 404 Introuvable est retournée.

Codes d’erreur et de réussite de la réponse

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.

Exemple de réponse lorsque le domaine est déjà utilisé

HTTP/1.1 200 OK
Content-Length: 0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: cf5b00d6-9240-431c-a973-cc06c904e5bf
MS-CV: 7UXAHds8J0mNUCSp.0
MS-ServerId: 201022015
Date: Tue, 31 Jan 2017 22:22:35 GMT

Exemple de réponse pour quand le domaine est disponible

HTTP/1.1 404 Not Found
Content-Length: 0
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 1169a4cd-3be7-4e29-9cb3-0f78ffa2e91e
MS-CV: RRmc+bEw9U2e97CC.0
MS-ServerId: 202010406
Date: Tue, 31 Jan 2017 22:36:01 GMT

Partager via