Získání uživatelských rolí pro zákazníka

  • Článek

Získejte seznam všech rolí a oprávnění připojených k uživatelskému účtu. Mezi varianty patří získání seznamu všech oprávnění napříč všemi uživatelskými účty pro zákazníka a získání seznamu uživatelů, kteří mají danou roli.

Požadavky

  • Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pouze s přihlašovacími údaji 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 tak , že vyberete pracovní prostor Zákazníci , pak zákazník ze seznamu zákazníků a pak účet. Na stránce Účet zákazníka vyhledejte ID Microsoftu v části Informace o účtu zákazníka. ID Microsoftu je stejné jako ID zákazníka (customer-tenant-id).

Role GDAP

Budete potřebovat alespoň jednu z následujících rolí GDAP:

  • Čtenář adresáře
  • Globální čtenář
  • Správce uživatelů
  • Správce privilegovaných rolí
  • Zapisovače adresářů

C#

Pokud chcete načíst všechny role adresáře pro zadaného zákazníka, nejprve načtěte zadané ID zákazníka. Pak použijte kolekci IAggregatePartner.Customers a zavolejte Metodu ById(). Potom zavolejte DirectoryRoles vlastnost, následované Get() nebo GetAsync() metoda.

// string selectedCustomerId;
// IAggregatePartner partnerOperations;

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

Ukázka: Konzolová testovací aplikace Projekt: Ukázky sady SDK v Partnerském centru – třída: GetCustomerDirectoryRoles.cs

Pokud chcete načíst seznam uživatelů zákazníka, kteří mají danou roli, nejprve načtěte zadané ID zákazníka a ID role adresáře. Pak použijte kolekci IAggregatePartner.Customers a zavolejte Metodu ById(). Pak zavolejte DirectoryRoles vlastnost, pak ById() metoda, pak UserMembers vlastnost, následované Get() nebo GetAsync() metoda.

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

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

Ukázka: Konzolová testovací aplikace Projekt: PartnerSDK.FeatureSamples – třída: GetCustomerDirectoryRoleUserMembers.cs

Požadavek REST

Syntaxe požadavku

Metoda Identifikátor URI žádosti
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

Parametr identifikátoru URI

Pomocí následujícího parametru dotazu identifikujte správného zákazníka.

Jméno Typ 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.
ID uživatele Identifikátor guid N Hodnota je IDENTIFIKÁTOR GUID formátovaný id uživatele , které patří do jednoho uživatelského účtu.
ID role Identifikátor guid N Hodnota je GUID formátované ID role, které patří k typu role. Tato ID můžete získat dotazem na všechny role adresáře zákazníka napříč všemi uživatelskými účty. (Druhý scénář výše)

Záhlaví žádosti

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

Text požadavku

Příklad požadavku

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: 8a53b025-d5be-4d98-ab20-229d1813de76

Odpověď REST

V případě úspěchu vrátí tato metoda seznam rolí přidružených k danému uživatelskému účtu.

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: 31942
Content-Type: application/json
MS-CorrelationId: 8a53b025-d5be-4d98-ab20-229d1813de76
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" }
}