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 partnercentrum, 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

  • Referenties zoals beschreven in verificatie in partnercentrum. 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 partnercentrum. Selecteer de werkruimte Klanten op de startpagina van Partnercentrum. Selecteer de klant in de lijst Klant en selecteer Vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Details van het klantaccount. 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:

  • Globale beheerder
  • Mapschrijver
  • Algemene 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 Type Vereist Beschrijving
klant-tenant-id Guid J De waarde is een door een GUID opgemaakte klant-tenant-id waarmee de reseller de resultaten kan filteren op een bepaalde klant die deel uitmaakt van de reseller.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

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: a176c585-b5de-4d65-824c-67a6deb45cd9
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 dat de fout is geslaagd of mislukt en 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: a176c585-b5de-4d65-824c-67a6deb45cd9
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

["contosco.onmicrosoft.com"]

Volgende stappen