Power BI REST API'lerini kullanma
Power BI REST API'leri ekleme, yönetim, idare ve kullanıcı kaynakları için hizmet uç noktaları sağlar.
Power BI REST API'leri ile aşağıdakileri yapabilirsiniz:
Power BI içeriğini yönetme
Yönetici işlemlerini gerçekleştirme
Power BI İçeriği Ekleme
Not
Power BI API'lerinden bazıları çalışma alanlarını grup olarak ifade eder. Gruplara yapılan tüm başvurular, çalışma alanlarıyla çalıştığınız anlamına gelir.
Power BI REST API'sine erişirken, istek ve yanıt içeriğiniz ve verileriniz Power BI kiracınızın ana bölgesi dışındaki bölgelerdeki veri merkezleri tarafından işlenebilir.
Kapsam
Power BI REST API'lerini kullanmak için Azure'da bir Azure Active Directory (Azure AD) uygulaması kaydetmeniz gerekir. Azure AD uygulaması, Power BI REST kaynakları için izinler oluşturur ve Power BI REST API'lerine erişim sağlar. Bir uygulamanın nasıl kaydedildiğini öğrenmek için bkz. Azure AD uygulamasını Power BI ile kullanmak üzere kaydetme.
Azure AD uygulamasını kaydettikten sonra Azure AD (v1.0; ADAL) veya Microsoft kimlik platformu (v2.0; MSAL) uç noktaları. Bu kimlik doğrulama yöntemlerinin nasıl çalıştığı hakkında daha fazla bilgi edinmek için bkz. Microsoft kimlik platformuna neden güncelleştirme (v2.0)?
Power BI erişim izinleri hakkında daha fazla bilgi için bkz. Microsoft kimlik platformu uç noktasında İzinler ve onay.
Hizmet sorumlusu kullanma
birhizmet sorumlusu kullanıyorsanız kapsamlar gerekli değildir. Bir hizmet sorumlusunun Power BI ile kullanılmasını etkinleştirdikten sonra uygulamanın AD izinleri artık geçerli olmaz. Hizmet sorumlusu kullanılırken uygulamanın izinleri Power BI yönetici portalı üzerinden yönetilir. Daha fazla bilgi için bkz. Power BI hizmeti yönetici ayarlarını etkinleştirme.
Kapsam ekleme
Azure AD uygulamanıza izin eklemek için şu adımları izleyin:
Uygulamanızı Azure'da açın.
Soldaki Yönetaltında API izinleriniseçin.
İzinekle'yi seçin.
api izinleri isteme penceresinde power bi hizmeti 'i seçin.
temsilci izinleriseçin. API'lerin listesi görüntülenir.
İzin eklemek istediğiniz API'yi genişletin ve eklemek istediğiniz izinleri seçin.
İzin ekleöğesini seçin.
Kapsamlar kaldırılıyor
Azure AD uygulamanızdan izinleri kaldırmak için şu adımları izleyin:
Uygulamanızı Azure'da açın.
Soldaki Yönetaltında API izinleriniseçin.
Bağlam menüsünü (izin üç noktası) seçin.
İzinkaldır'ı seçin.
Azaltma
Power BI, en iyi performansı ve güvenilirliği korumak için azaltmayı kullanır. Power BI, kaynakların tek kullanıcılardan fazla kullanılmasını önlemek için kullanıcı başına bir zaman aralığı içinde API çağrılarının sayısını sınırlar.
Kullanıcı bir zaman penceresinde önceden belirlenmiş sınırı aşan bir dizi istek gönderdiğinde Power BI, kısa bir süre için bu kullanıcıdan gelen diğer istekleri kısıtlar.
Uygulamalar azaltmayla karşılaştığında Power BI, yanıtta Retry-After HTTP üst bilgisine sahip bir HTTP durum kodu 429 (Çok fazla istek) döndürür ve çağıran uygulamanın yeni bir istek yapmadan önce kaç saniye beklemesi gerekir.
Coğrafi bölgeler arasında indirme
Çağrının yürütüldüğü bölgeden farklı bir bölgede dosya indirmeyi içeren işlemler beklenenden uzun sürebilir.
REST İşlem grupları
Bu tabloda Power BI REST API işlem grupları listelenir.
Not
Power BI Embedded kapasitelerini yönetmek için Power BI Embedded Azure Resource Manager REST API'lerini kullanın.
| İşlem grubu | Açıklama |
|---|---|
| yönetici | Yönetim görevleriyle çalışmaya yönelik işlemler. |
| Apps | Uygulamalarla çalışmaya yönelik işlemler. |
| Kullanılabilir Özellikler | Kullanılabilir özellikleri döndüren işlemler. |
| Kapasiteler | Kapasitelerle çalışmaya yönelik işlemler. |
| Panolar | Panolarla çalışmaya yönelik işlemler. |
| Veri Akışı Depolama Hesaplarını | Veri akışı depolama hesaplarıyla çalışmaya yönelik işlemler. |
| veri akışlarını | Veri akışlarıyla çalışmaya yönelik işlemler. |
| Veri Kümeleri | Veri kümeleriyle çalışmaya yönelik işlemler. |
| Ekleme Belirteci | Ekleme belirteçleriyle çalışmaya yönelik işlemler. |
| Ağ Geçitleri | Ağ geçitleriyle çalışmaya yönelik işlemler. |
| Grupları | Gruplarla çalışmaya yönelik işlemler. |
| İçeri Aktarma | İçeri aktarmalarla çalışmaya yönelik işlemler. |
| İşlem Hatları | Dağıtım işlem hatlarıyla çalışmaya yönelik işlemler. |
| Gönderme Veri Kümeleri | Gönderme veri kümeleriyle çalışmaya yönelik işlemler. |
| raporları | Raporlarla çalışmaya yönelik işlemler. |
| Şablon Uygulamaları | Şablon Uygulamaları ile çalışmaya yönelik işlemler. |
| Kullanıcıları | Kullanıcılarla çalışmaya yönelik işlemler. |