Sprawdzanie dostępności domeny

Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla Microsoft Cloud for US Government

Jak określić, czy domena jest dostępna do użycia.

Wymagania wstępne

• Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.

• Domena (na przykład contoso.onmicrosoft.com).

C#

Aby sprawdzić, czy domena jest dostępna, najpierw wywołaj metodę IAggregatePartner.Domains , aby uzyskać interfejs operacji domeny. Następnie wywołaj metodę ByDomain z domeną, aby sprawdzić. Ta metoda pobiera interfejs do operacji dostępnych dla określonej domeny. Na koniec wywołaj metodę Exists , aby sprawdzić, czy domena już istnieje.

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

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

Przykład: aplikacja testowa konsoli. Projekt: Klasa przykładów zestawu SDK Centrum partnerskiego: CheckDomainAvailability.cs

Żądanie REST

Składnia żądania

Metoda	Identyfikator URI żądania
HEAD	{baseURL}/v1/domains/{domain} HTTP/1.1

Parametr identyfikatora URI

Użyj następującego parametru zapytania, aby zweryfikować dostępność domeny.

Nazwa	Typ	Wymagane	Opis
Domeny	ciąg	Y	Ciąg identyfikujący domenę do sprawdzenia.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Brak

Przykład żądania

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

Odpowiedź REST

Jeśli domena istnieje, nie jest dostępna do użycia i zostanie zwrócony kod stanu odpowiedzi 200 OK. Jeśli domena nie zostanie znaleziona, będzie ona dostępna do użycia i zostanie zwrócony kod stanu odpowiedzi 404 Nie znaleziono.

Kody powodzenia i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie oraz dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i dodatkowe parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum partnerskiego.

Przykład odpowiedzi, gdy domena jest już używana

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

Przykład odpowiedzi, gdy domena jest dostępna

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