Delen via

Het aangepaste domein van een klant ophalen

  • Artikel

Van toepassing op: Partnercentrum

Hiermee haalt u een CustomDomain-resource op.

Wanneer een nieuw klantaccount wordt gemaakt in Partner Center, wordt er een uniek domein toegewezen. Dit domein kan worden gebruikt om een klant te identificeren en kan ook worden gebruikt voor andere doeleinden, zoals het instellen van postvakken.

Vereisten

  • Inloggegevens zoals beschreven in Partner Center-authenticatie. Dit scenario biedt ondersteuning voor app+gebruikersreferenties of alleen-app-verificatie.

  • Een klant-ID (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in Partner Center. Selecteer de Klanten werkruimte op de startpagina van Partnercentrum. Selecteer de klant uit de Klantenlijst, en selecteer vervolgens Account. Zoek op de klantaccountpagina naar de Microsoft-id in de sectie Klantaccountdetails. De Microsoft ID is hetzelfde als de klant-ID (customer-tenant-id).

Belangrijk

GDAP-rollen zijn vereist om deze API aan te roepen. DAP wordt niet ondersteund. Partnerverificatie is nog steeds vereist (AdminAgent/HelpDeskAgent/SalesAgent)

GDAP-rollen

U hebt ten minste een van de volgende GDAP-rollen nodig:

  • Mapschrijver
  • Wereld Lezer
  • Domeinbeheerder

REST-aanvraag

Aanvraagsyntaxis

Wijze Aanvraag URI
GET {baseURL}/v1/customers/{customer-tenant-id}/customDomains HTTP/1.1

URI-parameter

Gebruik de volgende queryparameter voor een specifieke klant.

Name Soort Vereist Beschrijving
customer-tenant-id Handleiding Y De waarde is een GUID-geformatteerde klant-tenant-id waarmee de reseller de resultaten kan filteren voor een bepaalde klant die tot de reseller behoort.

Aanvraagheaders

Raadpleeg voor meer informatie Partner Center REST-headers.

Aanvraagtekst

Geen.

Aanvraagvoorbeeld

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

REST-antwoord

Als dit lukt, retourneert deze methode een aangepaste domeinresource in de hoofdtekst van het antwoord.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft of de reactie succesvol is of mislukt en met andere informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie Foutcodes voor de volledige lijst.

Responsvoorbeeld

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"]

Gerelateerde inhoud