Ověření dostupnosti domény

Článek
06/19/2023

Platí pro: Partnerské centrum | Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud for US Government

Jak zjistit, jestli je doména dostupná pro použití

Požadavky

Přihlašovací údaje, jak je popsáno v tématu Ověřování v Partnerském centru. Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.
Doména (například contoso.onmicrosoft.com).

C#

Chcete-li ověřit, zda je doména k dispozici, nejprve zavolejte IAggregatePartner.Domains a získejte rozhraní pro operace domény. Pak zavolejte metodu ByDomain s doménou, kterou chcete zkontrolovat. Tato metoda načte rozhraní pro operace dostupné pro konkrétní doménu. Nakonec zavolejte metodu Exists , abyste zjistili, jestli doména již existuje.

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

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

Ukázka: Testovací aplikace konzoly Projekt: Ukázky sady SDK Partnerského centra – třída: CheckDomainAvailability.cs

Požadavek REST

Syntaxe požadavku

Metoda	Identifikátor URI žádosti
HEAD	{baseURL}/v1/domains/{domain} HTTP/1.1

Parametr identifikátoru URI

K ověření dostupnosti domény použijte následující parametr dotazu.

Název	Typ	Vyžadováno	Popis
Domény	řetězec	Y	Řetězec, který identifikuje doménu, kterou chcete zkontrolovat.

Hlavičky požadavku

Další informace najdete v tématu Hlavičky REST Partnerského centra.

Text požadavku

Žádné

Příklad požadavku

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

Odpověď REST

Pokud doména existuje, není k dispozici pro použití a vrátí se stavový kód odpovědi 200 OK. Pokud se doména nenajde, je k dispozici pro použití a vrátí se stavový kód odpovědi 404 Nenalezena.

Úspěšné odpovědi a kódy chyb

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo neúspěch, a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb rozhraní REST v Partnerském centru.

Příklad odpovědi pro případ, že se doména už používá

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

Příklad odpovědi pro dobu, kdy je doména dostupná

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

Share via