Tartomány rendelkezésre állásának ellenőrzése
A következőre vonatkozik: Partnerközpont | A 21Vianet által üzemeltetett Partnerközpont | Partnerközpont Microsoft Cloud for US Government
Hogyan állapítható meg, hogy egy tartomány használható-e.
Előfeltételek
Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja a különálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.
Egy tartomány (például
contoso.onmicrosoft.com
).
C#
Annak ellenőrzéséhez, hogy elérhető-e egy tartomány, először hívja meg az IAggregatePartner.Domainst a tartományműveletek felületének beszerzéséhez. Ezután hívja meg a ByDomain metódust a tartomány ellenőrzéshez. Ez a metódus egy felületet kér le az adott tartományhoz elérhető műveletekhez. Végül hívja meg a Exists metódust, és ellenőrizze, hogy a tartomány már létezik-e.
// IAggregatePartner partnerOperations;
// const string domain = "contoso.onmicrosoft.com";
bool result = partnerOperations.Domains.ByDomain(domain).Exists();
Minta: Konzolteszt alkalmazás. Projekt: Partnerközpont SDK-minták osztálya: CheckDomainAvailability.cs
REST-kérelem
Kérés szintaxisa
Metódus | Kérés URI-ja |
---|---|
FEJ | {baseURL}/v1/domains/{domain} HTTP/1.1 |
URI-paraméter
A tartomány rendelkezésre állásának ellenőrzéséhez használja az alábbi lekérdezési paramétert.
Név | Típus | Kötelező | Leírás |
---|---|---|---|
Tartomány | sztring | Y | Egy sztring, amely azonosítja az ellenőrizendő tartományt. |
Kérésfejlécek
További információ: Partnerközpont REST-fejlécei.
A kérés törzse
None
Példa kérésre
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-válasz
Ha a tartomány létezik, nem használható, és a rendszer 200 OK válaszállapot-kódot ad vissza. Ha a tartomány nem található, akkor használható, és a rendszer a 404 Nem található válasz állapotkódot adja vissza.
Sikeres válasz és hibakódok
Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. Használja a hálózati nyomkövetési eszközt a kód, a hibatípus és a további paraméterek olvasásához. A teljes listát a Partnerközpont REST-hibakódjai című témakörben találja.
Példa válasz arra az esetre, ha a tartomány már használatban van
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élda válasz arra, hogy mikor érhető el a tartomány
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
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: