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

  • Makale
  • Okumak için 2 dakika

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

Önkoşullar

  • Iş ortağı merkezi kimlik doğrulamasındaaçıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca uygulama + kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.

  • Bir müşteri KIMLIĞI ( customer-tenant-id ). Müşterinin KIMLIĞINI bilmiyorsanız Iş Ortağı Merkezi panosundabulabilirsiniz. Iş Ortağı Merkezi menüsünden CSP ' yi ve ardından müşteriler' i seçin. Müşteri listesinden müşteriyi seçin ve ardından Hesap' ı seçin. 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ĞI () ile aynıdır customer-tenant-id .

C#

Belirtilen bir müşterinin tüm dizin rollerini almak için, önce belirtilen müşteri KIMLIĞINI alın. Ardından, ıaggregatepartner. Customers koleksiyonunuzu kullanın ve byıd () yöntemini çağırın. Ardından, Get () veya * * GetAsync () * * yönteminin ardından directoryroles özelliğini çağırın.

// string selectedCustomerId;
// IAggregatePartner partnerOperations;

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

Örnek: konsol test uygulaması. Project: iş ortağı merkezi SDK örnekleri sınıfı: getcustomerdirectoryroles. cs

Belirli bir rolü 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, ıaggregatepartner. Customers koleksiyonunuzu kullanın ve byıd () yöntemini çağırın. Daha sonra Directoryroles özelliğini ve ardından byıd () yöntemini çağırın, ardından Usermembers özelliği, ardından Get () veya GetAsync () yöntemi tarafından izlenir.

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

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

Örnek: konsol test uygulaması. Project: partnersdk. featuresamples sınıfı: getcustomerdirectoryroleusermembers. cs

REST isteği

İstek sözdizimi

Yöntem İstek URI'si
AL {BaseUrl}/v1/Customers/{Customer-Tenant-ID}/Users/{User-ID}/directoryroles http/1.1
AL {BaseUrl}/v1/Customers/{Customer-Tenant-ID}/directoryroles http/1.1
AL {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 Gerekli Açıklama
Müşteri-Kiracı kimliği guid Y Değer, satıcının satıcıya ait olan belirli bir müşteriye ait sonuçları filtrelemesine olanak tanıyan bir GUID biçimli Müşteri-Kiracı kimliği ' dir.
Kullanıcı kimliği guid N Değer, tek bir kullanıcı hesabına ait olan GUID biçimli bir Kullanıcı kimliği olur.
rol kimliği guid N Değer, bir rol türüne ait olan GUID biçimli bir rol kimliği olur. 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. Iş ortağı MERKEZI Rest üstbilgileri.

İstek gövdesi

İ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 bir listesini döndürür.

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

Her yanıt başarı veya başarısızlık ve ek hata ayıklama bilgilerini gösteren bir HTTP durum kodu ile 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" }
}