Vérifier la disponibilité du domaineVerify domain availability

S’applique àApplies To

  • Espace partenairesPartner Center
  • Espace partenaires géré par 21VianetPartner Center operated by 21Vianet
  • Espace partenaires de Microsoft Cloud GermanyPartner Center for Microsoft Cloud Germany
  • Espace partenaires de Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Comment déterminer si un domaine peut être utilisé.How to determine if a domain is available for use.

PrérequisPrerequisites

  • Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires.Credentials as described in Partner Center authentication. Ce scénario prend en charge l’authentification avec les informations d’identification de l’application autonome et de l’application + utilisateur.This scenario supports authentication with both standalone App and App+User credentials.

  • Un domaine (par exemple contoso.onmicrosoft.com ).A domain (for example contoso.onmicrosoft.com).

C#C#

Pour vérifier si un domaine est disponible, appelez d’abord collection iaggregatepartner. Domains pour obtenir une interface pour les opérations de domaine.To verify if a domain is available, first call IAggregatePartner.Domains to obtain an interface to domain operations. Appelez ensuite la méthode ByDomain avec le domaine à vérifier.Then call the ByDomain method with the domain to check. Cette méthode récupère une interface pour les opérations disponibles pour un domaine spécifique.This method retrieves an interface to the operations available for a specific domain. Enfin, appelez la méthode Exists pour voir si le domaine existe déjà.Finally, call the Exists method to see if the domain already exists.

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

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

Exemple: application de test console.Sample: Console test app. Projet: classed’exemples du kit de développement logiciel (SDK) Partner Center : CheckDomainAvailability.csProject: Partner Center SDK Samples Class: CheckDomainAvailability.cs

Demande RESTREST request

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de requêteRequest URI
SIÈGEHEAD {baseURL}/v1/domains/{domain} http/1.1{baseURL}/v1/domains/{domain} HTTP/1.1

Paramètre d’URIURI parameter

Utilisez le paramètre de requête suivant pour vérifier la disponibilité du domaine.Use the following query parameter to verify domain availability.

NomName TypeType ObligatoireRequired DescriptionDescription
Domaindomain stringstring OY Chaîne identifiant le domaine à vérifier.A string that identifies the domain to check.

En-têtes de requêteRequest headers

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.For more information, see Partner Center REST headers.

Corps de demandeRequest body

NoneNone

Exemple de requêteRequest example

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: ec57501a-a4c3-45ee-ab2b-da4250545fc9
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

Réponse RESTREST response

Si le domaine existe, il n’est pas utilisable et un code d’état de réponse 200 OK est retourné.If the domain exists, it isn't available for use and a response status code 200 OK is returned. Si le domaine est introuvable, il est disponible pour utilisation et un code d’état de réponse 404 introuvable est retourné.If the domain isn't found, it's available for use and a response status code 404 Not Found is returned.

Codes d’erreur et de réussite de la réponseResponse success and error codes

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.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires.Use a network trace tool to read this code, error type, and additional parameters. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.For the full list, see Partner Center REST error codes.

Exemple de réponse lorsque le domaine est déjà utiliséResponse example for when the domain is already in use

HTTP/1.1 200 OK
Content-Length: 0
MS-CorrelationId: ec57501a-a4c3-45ee-ab2b-da4250545fc9
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 lorsque le domaine est disponibleResponse example for when the domain is available

HTTP/1.1 404 Not Found
Content-Length: 0
MS-CorrelationId: 54770745-17f0-433c-bd7b-0265e5b38f98
MS-RequestId: 1169a4cd-3be7-4e29-9cb3-0f78ffa2e91e
MS-CV: RRmc+bEw9U2e97CC.0
MS-ServerId: 202010406
Date: Tue, 31 Jan 2017 22:36:01 GMT