Egy ügyfél felhasználói szerepköreinek lekérése

  • Cikk

A felhasználói fiókhoz csatolt összes szerepkör/engedély listájának lekérése. A változatok közé tartozik az ügyfél összes felhasználói fiókjához tartozó összes engedély listájának lekérése, valamint az adott szerepkörrel rendelkező felhasználók listájának lekérése.

Előfeltételek

  • Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv csak app+felhasználói hitelesítő adatokkal támogatja a hitelesítést.

  • Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából, majd a Fiók listában. Az ügyfél Fiók lapján keresse meg a Microsoft-azonosítót az Ügyfélfiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).

GDAP-szerepkörök

A következő GDAP-szerepkörök közül legalább egyre lesz szüksége:

  • Címtárolvasó
  • Globális olvasó
  • Felhasználói rendszergazda
  • Kiemelt szerepkörű rendszergazda
  • Címtárírók

C#

Egy adott ügyfél összes címtárszerepkörének lekéréséhez először kérje le a megadott ügyfél-azonosítót. Ezután használja az IAggregatePartner.Customers gyűjteményt, és hívja meg a ById() metódust. Ezután hívja meg a DirectoryRoles tulajdonságot, majd a Get() vagy a GetAsync() metódust.

// string selectedCustomerId;
// IAggregatePartner partnerOperations;

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

Példa: Konzoltesztelő alkalmazás. Projekt: Partnerközpont SDK-minták osztálya: GetCustomerDirectoryRoles.cs

Az adott szerepkörrel rendelkező ügyfélfelhasználók listájának lekéréséhez először kérje le a megadott ügyfél-azonosítót és a címtárszerepkör-azonosítót. Ezután használja az IAggregatePartner.Customers gyűjteményt, és hívja meg a ById() metódust. Ezután hívja meg a DirectoryRoles tulajdonságot, majd a ById() metódust, majd a UserMembers tulajdonságot, majd a Get() vagy a GetAsync() metódust.

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

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

Példa: Konzoltesztelő alkalmazás. Projekt: PartnerSDK.FeatureSamples osztály: GetCustomerDirectoryRoleUserMembers.cs

REST-kérés

Kérés szintaxisa

Metódus Kérés URI-ja
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-paraméter

A megfelelő ügyfél azonosításához használja az alábbi lekérdezési paramétert.

Név Típus Kötelező Leírás
ügyfél-bérlő-azonosító Guid Y Az érték egy GUID formátumú ügyfél-bérlő azonosító , amely lehetővé teszi, hogy a viszonteladó szűrje a viszonteladóhoz tartozó adott ügyfél eredményeit.
felhasználó-azonosító Guid N Az érték egy GUID formátumú felhasználói azonosító , amely egyetlen felhasználói fiókhoz tartozik.
szerepkör-azonosító Guid N Az érték egy GUID formátumú szerepkör-azonosító , amely egy szerepkörtípushoz tartozik. Ezeket az azonosítókat úgy szerezheti be, hogy lekérdezi az ügyfél összes címtárszerepkörét az összes felhasználói fiókban. (A második forgatókönyv, fent).

Kérelemfejlécek

További információ: Partnerközpont – REST fejlécek.

A kérés törzse

Példa kérése

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

REST-válasz

Ha sikeres, ez a metódus visszaadja az adott felhasználói fiókhoz társított szerepkörök listáját.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Hibakódok című témakörben találja.

Példa válaszra

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