Verifiera domäntillgänglighet

Artikel
09/12/2024

Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

Så här fastställer du om en domän är tillgänglig för användning.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och app+användarautentiseringsuppgifter.
En domän (till exempel contoso.onmicrosoft.com).

C#

För att kontrollera om en domän är tillgänglig anropar du först IAggregatePartner.Domains för att hämta ett gränssnitt för domänåtgärder. Anropa sedan metoden ByDomain med domänen för att kontrollera. Den här metoden hämtar ett gränssnitt för de åtgärder som är tillgängliga för en specifik domän. Anropa slutligen metoden Exists för att se om domänen redan finns.

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

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

Exempel: Konsoltestapp. Projekt: Exempelklass för Partnercenter SDK: CheckDomainAvailability.cs

REST-begäran

Begärandesyntax

Metod	URI för förfrågan
HUVUD	{baseURL}/v1/domains/{domain} HTTP/1.1

URI-parameter

Använd följande frågeparameter för att verifiera domäntillgängligheten.

Namn	Typ	Obligatorisk	Beskrivning
Domän	sträng	Y	En sträng som identifierar domänen som ska kontrolleras.

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Ingen

Exempel på begäran

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

Om domänen finns är den inte tillgänglig för användning och svarsstatuskoden 200 OK returneras. Om domänen inte hittas är den tillgänglig för användning och svarsstatuskoden 404 Hittades inte returneras.

Lyckade svar och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckat eller misslyckat och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Partnercenter REST-felkoder.

Svarsexempel för när domänen redan används

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

Svarsexempel för när domänen är tillgänglig

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

Dela via