İngilizce dilinde oku

Aracılığıyla paylaş


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:

  1. Uygulamanızı Azure'da açın.

  2. Soldan Yönet'in altında API izinleri'ni seçin.

  3. İzin ekle'yi seçin.

  4. API izinleri iste penceresinde Power BI Hizmeti'ni seçin.

  5. Temsilci izinleri'ne tıklayın. API'lerin listesi görüntülenir.

  6. İzin eklemek istediğiniz API'yi genişletin ve buna eklemek istediğiniz izinleri seçin.

  7. İzin ekle'yi seçin.

Kapsamları kaldırma

Azure AD uygulamanızdan izinleri kaldırmak için şu adımları izleyin:

  1. Uygulamanızı Azure'da açın.

  2. Soldan Yönet'in altında API izinleri'ni seçin.

  3. Bağlam menüsünü (izin üç noktası) seçin.

  4. İ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.

Sonraki adımlar