Yönetici ilişkisi istatistiklerini alma

  • Makale

Şunlar için geçerlidir: İş Ortağı Merkezi

Tüm müşterilerinde bir iş ortağıyla ilişkili kurulan veya etkin olan Temsilci Yönetici (DAP) ilişkilerinin sayısıyla ilgili bilgileri döndürür.

Amaç: İş ortakları, müşteri kiracısını güvenli bir şekilde yönetmeye ve Müşteriyle DAP ilişkisini kaldırma - İş Ortağı Merkezi uygulama geliştiricisini kullanarak 90 günden daha eski etkin olmayan DAP ilişkilerini kaldırmaya uyumludur.

Bu API, iş ortaklarının etkin DAP'leri Ayrıntılı yönetici ayrıcalıklarına (GDAP) geçirebilmesi için etkin DAP'lerin istatistiklerini izlemeye yardımcı olur.

Dekont

Bu API kısa ömürlüdür ve DAP kullanımdan kaldırma aşamasında desteklenecektir. DAP Kullanımdan Kaldırma programı sonrasında bu API kullanımdan kaldırılacaktır.

Ön koşullar

Kimlik Bilgileri

Bu senaryo yalnızca App+User kimlik bilgileriyle kimlik doğrulamayı destekler.

Erişim belirteci almak için belirteç değişimi

Daha fazla bilgi için bkz . Web API'sine erişmek için uygulama yapılandırma.

PowerShell konsolundan aşağıdaki komutları yürüterek iş ortağı kiracısında İş Ortağı Müşteri Temsilcisi Yönetici istrasyon API'si uygulaması için bir hizmet sorumlusu oluşturun.

  1. Azure Active Directory'ye Bağlan.

    Connect-AzureAD

    Bu, oturum açmak için etkileşimli bir pencere açar. Korumalı alan iş ortağı kiracısının kimlik bilgilerini girin.

  2. Ardından yeni bir hizmet sorumlusu oluşturun: New-AzureADServicePrincipal -AppId 2832473f-ec63-45fb-976f-5d45a7d4bb91

    ObjectId AppId DisplayName
    c1bf31da-09e5-4985-ab50-3232d4ae4f5a 2832473f-ec63-45fb-976f-5d45a7d4bb91 İş Ortağı Müşteri Temsilcisi Yönetici

  3. Ardından Azure portalına gidip Uygulama kayıtları ardından Genel istemci uygulaması oluştur veya Mevcut bir uygulamayı kullan'ı kullanarak kiracıda bir uygulama oluşturursunuz.

  4. API izinlerini görüntüle Kuruluşumun kullandığı izin>API'leri>ekle'yi seçin

  5. İş Ortağı Müşteri Temsilcisi Yönetici Temsilci>izinleri>İzin ekle'yi seçin

  6. Bu yeni izin için yönetici onayı verin.

Artık GDAP API'lerini çağırmak için bu uygulamayı (oturum açmış bir kiracı yöneticisiyle) kullanarak App+User belirtecini (kaynakla https://api.partnercustomeradministration.microsoft.com) kullanabilirsiniz.

POST https://login.microsoftonline.com/<partner_tenant_id>/oauth2/token grant_type=client_credentials&scope:https://api.partnercustomeradministration.microsoft.com&client_id:<client_id>&client_secret:<client_secret>

REST isteği

İstek söz dizimi

Metot İstek URI'si
GET https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/delegatedAdminStatistics

URI parametresi

Bu API için URI parametresi gerekmez.

İstek üst bilgileri

Üst bilgi Tanım Değer
Yetkilendirme Taşıyıcı <token>formundaki yetkilendirme belirteci. String

Request body

Bu API için istek gövdesi sağlama.

İstek örneği

GET https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/ delegatedAdminStatistics  
HTTP/1.1 
Authorization: Bearer \<token\> 
Content-Type: application/json; charset=utf-8

REST yanıtı

Başarılı olursa, bu yöntem yanıt gövdesinde temsilci Yönetici Statistics kaynaklarının bir koleksiyonunu 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 ve diğer hata ayıklama bilgilerini gösteren bir HTTP durum koduyla birlikte gelir. Bu kodu, hata türünü ve diğer parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . İş Ortağı Merkezi REST hata kodları.

delegated Yönetici Statistics kaynağı

Temsilci Yönetici Ayrıcalığı (DAP) ilişkilerinin kullanımıyla ilgili istatistikleri içeren nesneyi temsil eder.

Properties

Özellik Tür Açıklama
kimlik String İş ortağı kiracısının benzersiz tanımlayıcısı.
partnerTenantId String İş ortağı kiracısının benzersiz tanımlayıcısı.
totalDapCustomerCount Int DAP erişimi olan toplam müşteri sayısı.
establishedDapCount delegated Yönetici AccessCount koleksiyonu Oluşturulan (oluşturulan) DAP sayısı ve Oluşturma tarihi. Örnek: 18.06.2021 tarihinde 10 DAP oluşturulduysa, yanıt "count" değerini 10 olarak ve "date" değerini "18.6.2021" olarak içerecektir.
inactiveDapCount delegated Yönetici AccessCount koleksiyonu Son oturum açma tarihiyle oturum açan müşterilerin sayısı. Örnek: İş ortakları 18.06.2021 tarihinde 10 müşteri kiracısında oturum açtıysa, yanıt "count" değerini 10 olarak ve "date" değerini "18.6.2021" olarak içerecektir.

delegated Yönetici AccessCount kaynağı

Günlük yönetici temsilcisi sayısını temsil eder.

Özellik Tür Tanım
Tarih String Eylemin [oluşturulduğu veya oturum açtığı] tarihi.
Sayı Int Müşteri sayısı.

Yanıt örneği

{ 

  "@odata.context": "https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/$metadata#delegatedAdminStatistics/$entity", 

  "id": "8984fecd-00a2-4686-ba43-b5c20866944a", 

  "partnerTenantId": "8984fecd-00a2-4686-ba43-b5c20866944a", 

  "totalDapCustomerCount": 200, 

  "establishedDapCount": [ 

    { 

      "date": "6/18/2021", 

      "count": 1 

    }, 

    { 

      "date": "2/18/2022", 

      "count": 1 

    } 

  ], 

  "inactiveDapCount": [ 

    { 

      "date": "2/18/2022", 

      "count": 1  

    }, 

    { 

      "date": "2/24/2022", 

      "count": 1 

    } 

  ] 

}