Beschikbaarheid van domein verifiëren

Artikel
06/19/2023

Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud for US Government

Bepalen of een domein beschikbaar is voor gebruik.

Vereisten

Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als App+User-referenties.
Een domein (bijvoorbeeld contoso.onmicrosoft.com).

C#

Als u wilt controleren of een domein beschikbaar is, roept u eerst IAggregatePartner.Domains aan om een interface voor domeinbewerkingen te verkrijgen. Roep vervolgens de ByDomain-methode aan met het domein dat u wilt controleren. Met deze methode wordt een interface opgehaald voor de bewerkingen die beschikbaar zijn voor een specifiek domein. Roep ten slotte de exists-methode aan om te zien of het domein al bestaat.

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

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

Voorbeeld: Console-test-app. Project: Partner Center SDK-voorbeeldklasse: CheckDomainAvailability.cs

REST-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag-URI
HOOFD	{baseURL}/v1/domains/{domain} HTTP/1.1

URI-parameter

Gebruik de volgende queryparameter om de beschikbaarheid van het domein te controleren.

Naam	Type	Vereist	Beschrijving
Domein	tekenreeks	J	Een tekenreeks die het domein aangeeft dat moet worden gecontroleerd.

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

Geen

Voorbeeld van aanvraag

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

REST-antwoord

Als het domein bestaat, is het niet beschikbaar voor gebruik en wordt een antwoordstatuscode 200 OK geretourneerd. Als het domein niet wordt gevonden, is het beschikbaar voor gebruik en wordt de antwoordstatuscode 404 Niet gevonden geretourneerd.

Geslaagde en foutcodes voor antwoorden

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat het is gelukt of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Partner Center REST-foutcodes voor de volledige lijst.

Antwoordvoorbeeld voor wanneer het domein al in gebruik is

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

Antwoordvoorbeeld voor wanneer het domein beschikbaar is

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

Delen via