bir iş ortağının yönetici temsilcisi müşterilerini listeleme

  • Makale

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

Bir iş ortağının tüm müşterilerinin listesini döndürür ve ayrıca müşterilerin DAP/DAP dışı bir ilişkisi olup olmadığını gösterir.

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.

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

    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/delegatedAdminCustomers

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.

İsteğe bağlı sorgu parametreleri

Bu yöntem, yanıtı özelleştirmeye yardımcı olmak için , $filter, $skip$top$countve $orderBy (izin verilen alanlar: organizationDisplayName, dapEnabled, startDateTime, lastSignInDateTime) destekler.$select

$top en fazla 300 nesneyi destekler.

İstek örneği

GET https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/delegatedAdminCustomers 
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övdesindeki temsilci Yönetici Customers kaynaklarından oluşan bir koleksiyon 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 Customers kaynağı

bir iş ortağının yönetici temsilcisi müşterisini ve iş ortağının müşterinin kiracısına erişimi hakkındaki ayrıntıları temsil eder.

Properties

Özellik Tür Açıklama
kimlik String Müşteri kiracısının benzersiz tanımlayıcısı.
customerTenantId String Müşteri kiracısının benzersiz tanımlayıcısı.
OrganizationDisplayName String Müşterinin kuruluşunun görünen adı.
partnerAgentCount Int Son bir gün içinde müşteri kiracısında oturum açan iş ortaklarının sayısı.
partnerSignInCount Int İş ortaklarının son bir gün içinde müşteri kiracısında kaç kez oturum açtığı.
dapEnabled Boolean Değer, iş ortağının müşteri için bir DAP ilişkisi olup olmadığını gösterir.
False: Bu müşteri için DAP ilişkisi yoksa.
Doğruysa: Bu müşteri için DAP ilişkisi var
startDateTime String DAP ilişkisinin kurulduğu tarih saati.
endDateTime String DAP ilişkisinin sonlandırıldığı tarih.
lastSignInDateTime String Bu müşteri kiracısında iş ortağının son oturum açma tarihi.
Null/boş: İş ortakları tarafından müşteri kiracısında oturum açma yok.

Yanıt örneği

{ 

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

    "value": [ 

        { 

            "id": "53018d99-ac51-4ec8-b86e-c8a61de43717", 

            "customerTenantId": "53018d99-ac51-4ec8-b86e-c8a61de43717", 

            "organizationDisplayName": "Test_Test_GAA_Partner_Account", 

            "partnerAgentCount": 0, 

            "partnerSignInCount": 0, 

            "globalAdminSignInCount": 0, 

            "dapEnabled": false, 

            "startDateTime": "2021-08-06T21:15:04.3461507Z", 

            "endDateTime": null, 

            "lastSignInDateTime": null 

        }, 

        { 

            "id": "6fc468f5-b399-4e05-a6f1-da8a33da9a6c", 

            "customerTenantId": "6fc468f5-b399-4e05-a6f1-da8a33da9a6c", 

            "organizationDisplayName": "StagingTest", 

            "partnerAgentCount": 0, 

            "partnerSignInCount": 0, 

            "globalAdminSignInCount": 0, 

            "dapEnabled": true, 

            "startDateTime": "2022-04-20T06:11:11.7227953Z", 

            "endDateTime": null, 

            "lastSignInDateTime": "2022-04-20T06:11:11.7227953Z" 

        } 
] 
}