Aracılığıyla paylaş


SaaS teklifleri için ISV uygulama lisans yönetimi

İş Ortağı Merkezi'nde SaaS teklifleriniz için lisans yönetimini etkinleştirdiyseniz (şu anda yalnızca AppSource için kullanılabilir), müşterilerin lisanslarını aramak için usageRights Graph API'siyle tümleştirmeniz gerekir. Çözümünüzü çağıran müşterinin lisans durumunu belirlemek için usageRights API'sini kullanırsınız, böylece uygun şekilde hareket edebilirsiniz.

Önemli

Azure Active Directory (Azure AD) Graph, 30 Haziran 2023 itibarıyla kullanım dışı bırakılmıştır. Bundan sonra Azure AD Graph'a başka yatırım yapmayız. Azure AD Graph API'lerinin güvenlikle ilgili düzeltmelerin ötesinde SLA veya bakım taahhüdü yoktur. Yeni özelliklere ve işlevlere yapılan yatırımlar yalnızca Microsoft Graph'ta yapılacaktır.

Uygulamalarınızı Microsoft Graph API'lerine geçirmek için yeterli zamanınız olması için Azure AD Graph'ı artımlı adımlarla kullanımdan alacağız. Duyuracağımız sonraki bir tarihte, Azure AD Graph kullanarak yeni uygulamaların oluşturulmasını engelleyeceğiz.

Daha fazla bilgi edinmek için bkz . Önemli: Azure AD Graph Kullanımdan Kaldırma ve PowerShell Modülü Kullanımdan Kaldırma.

usageRights API

API: usageRight kaynak türü

usageRights API'sini kullanma

Teklifinizin aboneliğini satın alan oturum açmış kullanıcının lisans durumunu belirlemek için usageRights Graph API'sini çağırabilirsiniz. API'yi çağırmak için şu adımları izleyin:

  1. Kullanıcı Adına belirteç alma: Bkz . Kullanıcı adına erişim alma
  2. Kullanıcının nesne kimliğini almak için Graph'ı çağırın: bkz . Microsoft Graph API'sini kullanma
  3. Kullanıcının plana lisansı olduğunu belirlemek için usageRights API'sini çağırın: bkz . kullanıcı kullanımını listelemeRights

Not

usageRights çağrısı yapmak için en düşük User.Read izinlerine sahip olmanız gerekir. usageRights API'si şu anda beta sürümündedir. Sürüm V1'e güncelleştirildikten sonra, kullanılabilir olduğunda ISV'lerin beta sürümünden V1 sürümüne yükseltilmesi gerekir.

Yanıt Kodları

Yanıt gövdesine sahip kod 200:

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#users('ea201692-eb91-44e0-b82a-9dd4c78ced32')/usageRights",
    "@odata.nextLink": "https://graph.microsoft.com/beta/users/ea201692-eb91-44e0-b82a-9dd4c78ced32/usageRights?$skiptoken=ZXlKamIzTnRiM05FWWxSdmEyVnVJam9pVzN0Y0ltTnZiWEJ2YzJsMFpWUnZhMlZ1WENJNmUxd2lkRzlyWlc1Y0lqcHVkV3hzTEZ3aWNtRnVaMlZjSWpwN1hDSnRhVzVjSWpwY0lqRkdSa1pHUmtaR1JrWkdSa1pHUmtaR1JrWkdSa1pHUmt.......",
    "value": [
        {
            "id": "635991be-b7a3-4dd4-a48c-f1d39732fe94",
            "catalogId": "ID of the Product",
            "serviceIdentifier": "ISV friendly ID of the product, this is same as planID in partner center",
            "state": "active"
        }
    ]
}

API yanıtı açıklandı

  • Odata.nextLink: İsteğinizin çeşitli sonuçları varsa ve sayfalanması gerekiyorsa, Odata.nextLink yanıttadır. Yanıtın sonunu gösteren Odata.nextLink değerleri görünmeyene kadar sonuçları sayfaya eklemek için bunu kullanabilirsiniz.
  • serviceIdentifier: Müşterinin satın aldığı planın plan Kimliği.
  • state: Lisansın durumu. durum değerlerinin tüm olası değerlerini usageRights API belgelerinde görebilirsiniz. Genellikle, lisans durumu etkinse veya uyarı verirse kullanıcı çözümünüzü çalıştırabilmelidir. Başka herhangi bir durum, kullanıcının aboneliğinin süresi dolduğu, ödeme yapmaması vb. için askıya alındığı için iyi durumda olmadığı anlamına gelir.
  • Boş yanıt içeren kod 200: Bunun nedeni büyük olasılıkla müşterinin atanmış bir lisansı olmamasıdır.
  • Kod 400 Hatalı isteği: Bunun nedeni büyük olasılıkla Taşıyıcı belirteci gibi API çağrılırken eksik alanlar olmasıdır. API çağrı parametrelerinizi denetleyin.
  • Kod 403 Yasak: Bunun nedeni büyük olasılıkla süresi dolmuş veya yetkisiz belirteçtir. usageRights Graph API'sinin kimliğini doğrulamak için doğru Microsoft Entra Uygulamasını kullandığınızı doğrulayın.
  • Kod 500 İç sunucu hatası: API çağrısını yeniden deneyin. Hata devam ederse Microsoft Desteği başvurun.

Not

SaaS gerçekleştirme API'si için kullandığınız Microsoft Entra uygulaması usageRights API'si için de kullanılıyorsa, ekleme uygulamasının oluşturulduğu kiracının yayımlama kiracısı VEYA iş ortağı merkezindeki ilişkili kiracı olduğundan emin olun.

Microsoft Entra App'in altında oluşturulduğu kiracının iş ortağı merkezi kurulumunun bir parçası olduğunu belirlemek için aşağıdaki adımları kullanın:

  1. SaaS teklifini yayımlamak için kullanılan yayımcı hesabıyla Microsoft İş Ortağı Merkezi'nde oturum açın.
  2. Sağ üst köşedeki ayarlar bağlantısı altında "Hesap ayarları" ve ardından "kiracılar" seçeneğini belirleyin
  3. Microsoft AI Bulut İş Ortağı Programı hesabında ilişkili tüm kiracıları görebilirsiniz.
  4. Microsoft Entra Uygulamasının sahibi olan kiracı bu listede olmalıdır.
  5. Kiracı listede değilse, kiracıyı bağlamak için "Azure Kimliğini İlişkile" düğmesini kullanabilirsiniz.