Een gebruikersaccount ophalen op basis van id

Artikel
06/04/2024

Een specifiek gebruikersaccount voor een klant ophalen.

Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario biedt alleen ondersteuning voor verificatie met app+gebruikersreferenties.
Een klant-id (customer-tenant-id). Als u de klant-id niet weet, kunt u deze opzoeken in het Partnercentrum door de werkruimte Klanten te selecteren, vervolgens de klant in de lijst met klanten en vervolgens Account. Zoek op de pagina Account van de klant naar de Microsoft-id in de sectie Klantaccountgegevens . De Microsoft-id is hetzelfde als de klant-id (customer-tenant-id).

GDAP-rollen

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

Maplezer
Globale lezer
Gebruikersbeheerder

C#

Als u een gebruikersaccount voor een klant wilt ophalen, belt u de methode IAggregatePartner.Customers.ById met de klant-id om de klant te identificeren. Roep vervolgens de methode Users.ById aan om de specifieke gebruiker op te halen. Roep ten slotte de methode Users.Get of GetAsync aan om het gebruikersaccount op te halen.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;
// string selectedCustomerUserId;

// Get customer user detail.
var customerUsers = partnerOperations.Customers.ById(selectedCustomerId).Users.ById(selectedCustomerUserId).Get();

Voorbeeld: consoletest-app. Project: Voorbeeldklasse Partner Center SDK: GetCustomerUserDetails.cs

REST-aanvraag

Aanvraagsyntaxis

Method	Aanvraag-URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/users/{user-id} HTTP/1.1

URI-parameter

Gebruik de volgende URI-parameters om de juiste klant en gebruiker te identificeren.

Naam	Type	Vereist	Beschrijving
klant-tenant-id	Guid	Y	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.
user-id	Guid	Y	De waarde is een gebruikers-id met EEN GUID-indeling die deel uitmaakt van één gebruikersaccount.

Aanvraagheaders

Zie Rest-headers in Partnercentrum voor meer informatie.

Aanvraagtekst

Geen.

Aanvraagvoorbeeld

GET https://api.partnercenter.microsoft.com/v1/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/a9ef48bb-8758-4590-a312-d4a47bfaded4 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c1f673cb-655c-45a7-8a6b-257a0a006f4b
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST-antwoord

Als dit lukt, retourneert deze methode het gebruikersaccount voor de klant.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie rest-foutcodes in Partnercentrum voor de volledige lijst.

Responsvoorbeeld

HTTP/1.1 200 OK
Content-Length: 432
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: c1f673cb-655c-45a7-8a6b-257a0a006f4b
MS-CV: uWM1EGU7+0aI2MvV.0
MS-ServerId: 020021921
Date: Wed, 21 Dec 2016 22:59:10 GMT

{
    "usageLocation": "US",
    "id": "a9ef48bb-8758-4590-a312-d4a47bfaded4",
    "userPrincipalName": "Daniel@dtdemocspcustomer005.onmicrosoft.com",
    "firstName": "Daniel",
    "lastName": "Tsai",
    "displayName": "Daniel Tsai",
    "userDomainType": "none",
    "state": "active",
    "links": {
        "self": {
            "uri": "/customers/4d3cf487-70f4-4e1e-9ff1-b2bfce8d9f04/users/a9ef48bb-8758-4590-a312-d4a47bfaded4",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "CustomerUser"
    }
}

Delen via