Sdílet prostřednictvím

Získání vlastní domény zákazníka

  • Článek

Platí pro: Partnerské centrum

Získá prostředek CustomDomain.

Když se v Partnerském centru vytvoří nový účet zákazníka, přiřadí se mu jedinečná doména. Tuto doménu lze použít k identifikaci zákazníka a dá se použít i pro jiné účely, jako je nastavení poštovní schránky.

Požadavky

  • Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pouze pro aplikace a uživatele.

  • ID zákazníka (customer-tenant-id). Pokud neznáte ID zákazníka, můžete ho vyhledat v Partnerském centru. Na domovské stránce Partnerského centra vyberte pracovní prostor Zákazníci. V seznamu Zákazník vyberte zákazníka a pak vyberte Účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Podrobnosti o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).

Důležité

K volání tohoto rozhraní API se vyžadují role GDAP. DAP se nepodporuje. Ověřování partnera je stále povinné (AdminAgent/HelpDeskAgent/SalesAgent)

Role GDAP

Potřebujete alespoň jednu z následujících rolí GDAP:

  • Zapisovač adresářů
  • Globální čtenář
  • Správce domény

Požadavek REST

Syntaxe požadavku

metoda Identifikátor URI žádosti
GET {baseURL}/v1/customers/{customer-tenant-id}/customDomains HTTP/1.1

Parametr identifikátoru URI

Pro konkrétního zákazníka použijte následující parametr dotazu.

Name Type Požadováno Popis
customer-tenant-id identifikátor guid Y Hodnota je GUID formátované ID tenanta zákazníka, které umožňuje prodejci filtrovat výsledky pro daného zákazníka, který patří k prodejci.

Záhlaví žádosti

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

Text požadavku

Nezaokrouhlovat.

Příklad požadavku

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/customDomains HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

Odpověď REST

Pokud je tato metoda úspěšná, vrátí prostředek vlastní domény v textu odpovědi.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání 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.

Příklad odpovědi

HTTP/1.1 200 OK
Content-Length: 1530
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

["contosco.onmicrosoft.com"]

Související obsah