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şlemleri gerçekleştirme
Power BI İçeriği Ekleme
Not
Power BI API'lerinden bazıları çalışma alanlarını grup olarak adlandırıyor. 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, isteğiniz 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.
Kapsamlar
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ıyla ilgili izinleri belirler ve Power BI REST API'lerine erişim izni verir. Bir uygulamayı kaydetmeyi öğrenmek için bkz. Power BI ile kullanmak üzere bir Azure AD uygulaması kaydetme.
bir 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. Neden Microsoft kimlik platformu güncelleştirmesi (v2.0)?
Power BI erişim izinleri hakkında daha fazla bilgi için bkz. Microsoft kimlik platformu uç noktasında izinler ve onay.
Hizmet sorumlusu kullanma
Hizmet sorumlusu kullanıyorsanız kapsamlar gerekli değildir. Bir hizmet sorumlusunun Power BI ile kullanılmasını etkinleştirdiğinizde, 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.
Soldan Yönet'in altında API izinleri'ni seçin.
İzin ekle'yi seçin.
API izinleri iste penceresinde Power BI Hizmeti'ni seçin.
Temsilci izinleri'ne tıklayın. API'lerin listesi görüntülenir.
İzin eklemek istediğiniz API'yi genişletin ve buna eklemek istediğiniz izinleri seçin.
İzin ekle'yi seçin.
Kapsamları kaldırma
Azure AD uygulamanızdan izinleri kaldırmak için şu adımları izleyin:
Uygulamanızı Azure'da açın.
Soldan Yönet'in altında API izinleri'ni seçin.
Bağlam menüsünü (izin üç noktası) seçin.
İzni kaldı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 aşırı kullanılmasını önlemek için kullanıcı başına bir zaman penceresi içinde API çağrılarının sayısını sınırlar.
Bir kullanıcı bir zaman penceresinde önceden belirlenmiş sınırı aşan bir dizi istek gönderdiğinde, Power BI bu kullanıcıdan gelen diğer istekleri kısa bir süre için 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ğrı yapan uygulamanın yeni istek yapmadan önce kaç saniye beklemesi gerekir?
REST İşlem grupları
Bu tabloda Power BI REST API işlem grupları listelenmektedir.
Not
Power BI Embedded kapasitelerini yönetmek için Azure Resource Manager REST API'lerini Power BI Embedded kullanın.
| İşlem grubu | Description |
|---|---|
| Yönetici | Yönetim görevleriyle çalışmaya yönelik işlemler. |
| Uygulamalar | Uygulamalarla çalışmaya yönelik işlemler. |
| Kullanılabilir Özellikler | Kullanılabilir özellikleri döndüren işlemler. |
| Kapasiteler | Kapasitelerle çalışmaya yönelik operasyonlar. |
| Panolar | Panolarla çalışmaya yönelik işlemler. |
| Veri Akışı Depolama Hesapları | Veri akışı depolama hesaplarıyla çalışmaya yönelik işlemler. |
| Veri akışları | 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. |
| Ithalat | İçeri aktarmalarla çalışmaya yönelik işlemler. |
| Pipelines | Dağıtım işlem hatları ile ç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. |