Müşteri için kullanıcı rolleri alma

Makale
03/06/2024

Kullanıcı hesabına eklenen tüm rollerin/izinlerin listesini alın. Çeşitlemeler, bir müşterinin tüm kullanıcı hesaplarında tüm izinlerin listesini almayı ve belirli bir role sahip kullanıcıların listesini almayı içerir.

Önkoşullar

İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca App+User kimlik bilgileriyle kimlik doğrulamayı destekler.
Müşteri kimliği (customer-tenant-id). Müşterinin kimliğini bilmiyorsanız, İş Ortağı Merkezi'nde Müşteriler çalışma alanını, ardından müşteri listesinden müşteriyi ve ardından Hesap'ı seçerek bunu arayabilirsiniz. Müşterinin Hesap sayfasında, Müşteri Hesabı Bilgileri bölümünde Microsoft Kimliği'ni arayın. Microsoft Kimliği, müşteri kimliğiyle (customer-tenant-id) aynıdır.

GDAP rolleri

Aşağıdaki GDAP rollerinden en az birine ihtiyacınız vardır:

Dizin Okuyucusu
Genel okuyucu
Kullanıcı Yöneticisi
Ayrıcalıklı Rol Yöneticisi
Dizin Yazarları

C#

Belirtilen müşterinin tüm dizin rollerini almak için önce belirtilen müşteri kimliğini alın. Ardından, IAggregatePartner.Customers koleksiyonunuzu kullanın ve ById() yöntemini çağırın. Ardından DirectoryRoles özelliğini ve ardından Get() veya GetAsync() yöntemini çağırın.

// string selectedCustomerId;
// IAggregatePartner partnerOperations;

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

Örnek: Konsol test uygulaması. Proje: İş Ortağı Merkezi SDK Örnekleri Sınıfı: GetCustomerDirectoryRoles.cs

Belirli bir role sahip olan müşteri kullanıcılarının listesini almak için önce belirtilen müşteri kimliğini ve dizin rolü kimliğini alın. Ardından, IAggregatePartner.Customers koleksiyonunuzu kullanın ve ById() yöntemini çağırın. Ardından DirectoryRoles özelliğini, ardından ById() yöntemini, ardından UserMembers özelliğini ve ardından Get() veya GetAsync() yöntemini çağırın.

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

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

Örnek: Konsol test uygulaması. Proje: PartnerSDK.FeatureSamples Sınıfı: GetCustomerDirectoryRoleUserMembers.cs

REST isteği

İstek söz dizimi

Yöntem	İstek URI'si
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 parametresi

Doğru müşteriyi tanımlamak için aşağıdaki sorgu parametresini kullanın.

Ad	Tür	Zorunlu	Açıklama
customer-tenant-id	Guıd	Y	Değer, kurumsal bayinin kurumsal bayiye ait belirli bir müşterinin sonuçlarını filtrelemesine olanak tanıyan GUID biçimli müşteri kiracı kimliğidir .
kullanıcı kimliği	Guıd	N	Değer, tek bir kullanıcı hesabına ait GUID biçimli bir kullanıcı kimliğidir .
rol kimliği	Guıd	N	Değer, bir rol türüne ait GUID biçimli rol kimliğidir . Tüm kullanıcı hesaplarında bir müşterinin tüm dizin rollerini sorgulayarak bu kimlikleri alabilirsiniz. (Yukarıdaki ikinci senaryo).

İstek üst bilgileri

Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri.

Request body

İstek örneği

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 yanıtı

Başarılı olursa, bu yöntem verilen kullanıcı hesabıyla ilişkili rollerin listesini döndürür.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu belirten bir HTTP durum kodu ve ek hata ayıklama bilgileriyle birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . Hata Kodları.

Yanıt örneği

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

Aracılığıyla paylaş