Hämta användarroller för en kund

Artikel
09/11/2024

Hämta en lista över alla roller/behörigheter som är kopplade till ett användarkonto. Variationer inkluderar att hämta en lista över alla behörigheter för alla användarkonton för en kund och få en lista över användare som har en viss roll.

Förutsättningar

Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder endast autentisering med App+User-autentiseringsuppgifter.
Ett kund-ID (customer-tenant-id). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du efter Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID :t (customer-tenant-id).

GDAP-roller

Du behöver minst en av följande GDAP-roller:

Katalogläsare
Global läsare
Användaradministratör
Administratör för privilegierad roll
Katalogförfattare

C#

Om du vill hämta alla katalogroller för en angiven kund hämtar du först det angivna kund-ID:t. Använd sedan din IAggregatePartner.Customers-samling och anropa metoden ById(). Anropa sedan egenskapen DirectoryRoles följt av metoden Get() eller GetAsync().

// string selectedCustomerId;
// IAggregatePartner partnerOperations;

var directoryRoles = partnerOperations.Customers.ById(selectedCustomerId).DirectoryRoles.Get();

Exempel: Konsoltestapp. Projekt: SDK-exempelklass för Partnercenter: GetCustomerDirectoryRoles.cs

Om du vill hämta en lista över kundanvändare som har en viss roll hämtar du först det angivna kund-ID:t och katalogroll-ID:t. Använd sedan din IAggregatePartner.Customers-samling och anropa metoden ById(). Anropa sedan egenskapen DirectoryRoles, sedan ById()-metoden, sedan egenskapen UserMembers, följt av metoden Get() eller GetAsync().

// string selectedCustomerId;
// IAggregatePartner partnerOperations;
// string selectedDirectoryRoleId;

var userMembers = partnerOperations.Customers.ById(selectedCustomerId).DirectoryRoles.ById(selectedDirectoryRoleId).UserMembers.Get();

Exempel: Konsoltestapp. Projekt: PartnerSDK.FeatureSamples-klass: GetCustomerDirectoryRoleUserMembers.cs

REST-begäran

Syntax för begäran

Metod	URI för förfrågan
GET	{baseURL}/v1/customers/{customer-tenant-id}/users/{user-id}/directoryroles HTTP/1.1
GET	{baseURL}/v1/customers/{customer-tenant-id}/directoryroles HTTP/1.1
GET	{baseURL}/v1/customers/{customer-tenant-id}/directoryroles/{role-ID}/usermembers

URI-parameter

Använd följande frågeparameter för att identifiera rätt kund.

Namn	Typ	Obligatoriskt	Beskrivning
customer-tenant-id	Guid	Y	Värdet är ett GUID-formaterat kund-klient-ID som gör att återförsäljaren kan filtrera resultatet för en viss kund som tillhör återförsäljaren.
användar-ID	Guid	N	Värdet är ett GUID-formaterat användar-ID som tillhör ett enda användarkonto.
roll-id	Guid	N	Värdet är ett GUID-formaterat roll-ID som tillhör en typ av roll. Du kan hämta dessa ID:er genom att fråga efter alla katalogroller för en kund i alla användarkonton. (Det andra scenariot ovan).

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Exempel på begäran

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/users/<user-id>/directoryroles HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

REST-svar

Om det lyckas returnerar den här metoden en lista över de roller som är associerade med det angivna användarkontot.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Felkoder.

Svarsexempel

HTTP/1.1 200 OK
Content-Length: 31942
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: b1317092-f087-471e-a637-f66523b2b94c
Date: June 24 2016 22:00:25 PST

{
      "totalCount": 2,
      "items": [
        {
          "name": "Helpdesk Administrator",
          "id": "729827e3-9c14-49f7-bb1b-9608f156bbb8",
          "attributes": { "objectType": "DirectoryRole" }
        },
        {
          "name": "User Account Administrator",
          "id": "fe930be7-5e62-47db-91af-98c3a49a38b1",
          "attributes": { "objectType": "DirectoryRole" }
        }
      ],
      "attributes": { "objectType": "Collection" }
}

Dela via