Überprüfen der Domänenverfügbarkeit

Artikel
09/12/2024

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

So ermitteln Sie, ob eine Domäne zur Verwendung verfügbar ist.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.
Eine Domäne (z. B. contoso.onmicrosoft.com).

C#

Um zu überprüfen, ob eine Domäne verfügbar ist, rufen Sie zuerst IAggregatePartner.Domains auf, um eine Schnittstelle zu Domänenvorgängen zu erhalten. Rufen Sie dann die ByDomain-Methode mit der zu überprüfenden Domäne auf. Diese Methode ruft eine Schnittstelle zu den Vorgängen ab, die für eine bestimmte Domäne verfügbar sind. Rufen Sie abschließend die Exists-Methode auf, um festzustellen, ob die Domäne bereits vorhanden ist.

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

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

Beispiel: Konsolentest-App. Projekt: Partner Center SDK-Beispielklasse: CheckDomainAvailability.cs

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
HEAD	{baseURL}/v1/domains/{domain} HTTP/1.1

URI-Parameter

Verwenden Sie den folgenden Abfrageparameter, um die Domänenverfügbarkeit zu überprüfen.

Name	Typ	Erforderlich	BESCHREIBUNG
domain	string	J	Eine Zeichenfolge, die die zu überprüfende Domäne identifiziert.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine

Anforderungsbeispiel

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

REST-Antwort

Wenn die Domäne vorhanden ist, steht sie nicht zur Verwendung zur Verfügung, und eine Antwort status Code 200 OK wird zurückgegeben. Wenn die Domäne nicht gefunden wird, steht sie zur Verwendung zur Verfügung, und es wird eine Antwort status Code 404 Not Found zurückgegeben.

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-REST-Fehlercodes.

Antwortbeispiel für den Zeitpunkt, in dem die Domäne bereits verwendet wird

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

Antwortbeispiel für den Zeitpunkt, in dem die Domäne verfügbar ist

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

Teilen über