Ověření dostupnosti domény
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
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro