Microsoft Fabric'i bir süredir kullanıyorsanız, arayüzün ne kadar zengin olduğunu biliyorsunuzdur. Workspace'ler, deployment pipeline'lar, raporlar, semantik modeller… Çoğu işi tıkır tıkır portal üzerinden hallediyorsunuz. Ama bir gün geliyor, bir duvara toslıyorsunuz: “Bunu arayüzde nereden yapıyordum? Hatta yapabiliyor muyum ki?” İşte tam o noktada, çoğumuzun gözden kaçırdığı bir kapı var: REST API'lar. Bu yazıda, Fabric arayüzünde göremediğiniz ya da yapamadığınız işlemleri REST API'larla nasıl halledebileceğinizi, hem de tek satır kod yazmadan nasıl deneyebileceğinizi anlatacağım. Hadi başlayalım. <h3 id="61cfb193-edb0-4618-81d9-8d9fd15db885" data-toc-id="61cfb193-edb0-4618-81d9-8d9fd15db885" style="font-size: 20px; line-height: 1.2;">Somut bir örnek: Tüm organizasyonun deployment pipeline'larını listelemek </h3>Diyelim ki bir yöneticisiniz ve şu soruyu yanıtlamanız gerekiyor: “Şirketimizde toplam kaç tane deployment pipeline var, kimler kurmuş, hangileri aktif?” Arayüzde bunu tek bir ekrandan, organizasyon genelinde topluca görmek pek mümkün değil. Kendi eriştiğiniz pipeline'ları görürsünüz ama tenant'ın tamamını kuşbakışı göremezsiniz. İşte burada devreye GetPipelinesAsAdmin endpoint'i giriyor. Microsoft Learn'deki “Admin - Pipelines GetPipelinesAsAdmin” dökümantasyon sayfası. Solda diğer admin endpoint'lerinin uzun listesi, sağda endpoint'in detayları.Microsoft Learn'deki “Admin - Pipelines GetPipelinesAsAdmin” dökümantasyon sayfası. Solda diğer admin endpoint'lerinin uzun listesi, sağda endpoint'in detayları. <img src="https://ezycourse.b-cdn.net/6009/cmq9gstze16exy3pm1y6sfhry.png" alt="image" containerstyle="width: 100%; height: auto; cursor: pointer; " wrapperstyle="display: flex">Bu sayfada dikkat etmenizi istediğim birkaç şey var, çünkü her REST API endpoint'inde aynı bilgileri arayacaksınız: Ne yapıyor? Organizasyondaki tüm deployment pipeline'ları getiriyor (“Returns a list of deployment pipelines for the organization.”). Arayüzün size vermediği o bütüncül resmi sağlıyor. Hangi yetki gerekiyor? (Permissions) Kullanıcının yönetici (admin) haklarına sahip olması ya da bir service principal ile kimlik doğrulaması yapması gerekiyor. Yani bu endpoint'ler herkese açık değil; “AsAdmin” eki tam da bunu anlatıyor. Gereken kapsam (Required Scope) <a target="_blank" href="http://Tenant.Read">Tenant.Read</a>.All veya Tenant.ReadWrite.All. Bu kapsamlar “tenant'ın tamamını okuyabilirsin” demek. Salt okuma yapacaksanız Read yeterli. Sınırlar (Limitations) Saatte maksimum 200 istek. Bu çok önemli bir detay — eğer bu endpoint'i bir döngü içinde binlerce kez çağırmayı planlıyorsanız, bu limiti baştan hesaba katmanız gerekir. Asıl çağrı: GET <a target="_blank" href="https://api.powerbi.com/v1.0/myorg/admin/pipelines">https://api.powerbi.com/v1.0/myorg/admin/pipelines</a> İsteğe bağlı parametrelerle birlikte: GET <a target="_blank" href="https://api.powerbi.com/v1.0/myorg/admin/pipelines">https://api.powerbi.com/v1.0/myorg/admin/pipelines</a> ?$expand={$expand}&amp;$filter={$filter}&amp;$top={$top}&amp;$skip={$skip} Buradaki $top, $skip, $filter gibi parametreler, sonucu sayfalamak ve filtrelemek için. Yani “bana ilk 50 pipeline'ı getir” ya da “şu kullanıcıya ait olanları süz” diyebiliyorsunuz. Peki bunu denemek için kod yazmam mı gerekiyor? Hayır! Microsoft Learn, bu endpoint'leri tarayıcıdan, tek satır kod yazmadan denemeniz için harika bir özellik sunuyor.Dökümantasyon sayfasındaki HTTP çağrısının hemen yanında küçük bir “Try It” düğmesi var. <img src="https://ezycourse.b-cdn.net/6009/cmq9gt64i16uzy3pm4lpngydz.png" alt="image" containerstyle="width: 100%; height: auto; cursor: pointer; " wrapperstyle="display: flex">Bu düğmeye bastığınızda Microsoft sizi kimliğinizi onaylamaya davet ediyor. Zaten Learn'e giriş yaptıysanız, mevcut hesabınızla devam edebilirsiniz. <img src="https://ezycourse.b-cdn.net/6009/cmq9gt64y16nci9pj040ffzhs.png" alt="image" containerstyle="width: 100%; height: auto; cursor: pointer; " wrapperstyle="display: flex">Hesabınızı onayladıktan sonra karşınıza interaktif bir test paneli çıkıyor: REST API Try It. Burada Request URL'i görüyorsunuz, isterseniz parametre ve header ekliyorsunuz, en altta Run düğmesine basıyorsunuz ve… <img src="https://ezycourse.b-cdn.net/6009/cmq9gt65c14hl8dpg17w79v5b.png" alt="image" containerstyle="width: 100%; height: auto; cursor: pointer; " wrapperstyle="display: flex">Response Code: 200 gördüyseniz, tebrikler — Authorization token'ını arka planda Learn sizin için ekledi, çağrı çalıştı ve organizasyonunuzdaki pipeline'ların listesi JSON olarak önünüze geldi. Hiç Postman açmadan, hiç token üretmeden. Yeni bir endpoint'i keşfederken bunu bir “deneme tahtası” gibi kullanmanızı şiddetle öneririm. “Try It” güzel de, peki bu tek bir endpoint mi? Kesinlikle hayır. Görsel 1'de sol taraftaki o uzun listeyi fark ettiniz mi? GetPipelinesAsAdmin o denizdeki bir damla sadece. Aynı mantıkla çalışan onlarca admin endpoint'i var. Birkaç tanesini, hangi soruyu yanıtladıklarıyla birlikte paylaşayım: <table style="width: 842px;"><colgroup><col style="width: 282px;"><col style="width: 560px;"></colgroup><tbody><tr><th colspan="1" rowspan="1" colwidth="282" style="width: 282px;">API Endpoint</th><th colspan="1" rowspan="1" colwidth="560" style="width: 560px;">Ne işe yarıyor?</th></tr><tr><td colspan="1" rowspan="1" colwidth="282" style="width: 282px;">Groups - GetGroupsAsAdmin&nbsp;</td><td colspan="1" rowspan="1" colwidth="560" style="width: 560px;">Tenant'taki tüm workspace'lerin envanteri </td></tr><tr><td colspan="1" rowspan="1" colwidth="282" style="width: 282px;">Reports - GetReportsAsAdmin&nbsp;</td><td colspan="1" rowspan="1" colwidth="560" style="width: 560px;">Organizasyondaki tüm raporlar, sahipleriyle birlikte.</td></tr><tr><td colspan="1" rowspan="1" colwidth="282" style="width: 282px;">Pipelines - GetPipelineUsersAsAdmin&nbsp;</td><td colspan="1" rowspan="1" colwidth="560" style="width: 560px;">Bir pipeline'a kimlerin eriştiği </td></tr><tr><td colspan="1" rowspan="1" colwidth="282" style="width: 282px;">WidelySharedArtifacts - PublishedToWeb</td><td colspan="1" rowspan="1" colwidth="560" style="width: 560px;">“Publish to web” ile internete açılmış içerikler (güvenlik açısından altın değerinde bu arada) </td></tr><tr><td colspan="1" rowspan="1" colwidth="282" style="width: 282px;">Users - GetUserArtifactAccessAsAdmin </td><td colspan="1" rowspan="1" colwidth="560" style="width: 560px;">Belirli bir kullanıcının neye erişebildiği </td></tr></tbody></table>Bunlara ek olarak, sahnenin gerisinde iki güçlü API ailesi daha var: <ul><li>Scanner API (admin/workspaces/getInfo ve getScanResult): Tenant'ın tüm metadata'sını — workspace, dataset, tablo, kolon, ilişki seviyesine kadar — derinlemesine tarar. Bir veri kataloğu ya da governance panosu besleyecekseniz aradığınız yer burası olacak </li><li>Activity Events API (admin/activityevents): Kim, ne zaman, hangi raporu açtı, neyi sildi, neyi paylaştı? Denetim (audit) kayıtlarınızın kapısı. </li></ul>Ve tabii lakehouse, warehouse, notebook, data pipeline gibi Fabric item'larını programatik olarak oluşturup yönetebileceğiniz endpoint'ler de aynı yaklaşımla çalışıyor. Peki ben bunları ne zaman kullanırım? (Gerçek senaryolar) API'ları anlatmak güzel de, asıl mesele “ben bunu hangi gerçek işimde açarım?” sorusu. İşte sizi REST API'lara yönlendiren tipik anlar: <ul><li>Tenant geneli envanter ve governance amaçlı. “Şirkette toplam kaç workspace, kaç rapor, kaç dataset var ve sahipleri kim?” Bu soruyu arayüzden tek tek dolaşarak yanıtlamak günler alır. Bir scriptle 10 dakikada tablolaştırırsınız. </li><li>Güvenlik ve uyumluluk denetimi. “İnternete açık (publish to web) raporumuz var mı? Tüm organizasyona link'lenmiş hassas bir içerik var mı?” Bunlar arayüzde göze çarpmaz ama WidelySharedArtifacts endpoint'leriyle saniyeler içinde ortaya dökülür. </li><li>Toplu (bulk) işlemler. Bir kişi şirketten ayrıldı ve 40 farklı pipeline'da yetkisi var. Arayüzde 40 kez tıklamak yerine, DeleteUserAsAdmin endpoint'iyle döngü içinde topluca temizlersiniz. </li><li>Otomasyon ve CI/CD. Deployment pipeline'larınızı bir DevOps akışına bağlamak istiyorsanız, “Deploy” düğmesine elle basmak yerine API'yı tetiklersiniz. </li><li>Zamanlanmış izleme. Her sabah çalışan bir job, dün gece kapasitenizde ne olmuş, hangi yenileme (refresh) başarısız olmuş diye Activity Events'ten çeker ve size bir özet yollar. </li><li>Ortak nokta şu: Arayüz tekil ve manuel işler için, API ise toplu, tekrarlı ve otomatik işler için. İkisi rakip değil, birbirini tamamlıyor. </li></ul>“Try It”in ötesi: BU API’ları profosyonel olarak kullanmak.Tarayıcıdaki “Try It” keşif için harika, ama gerçek işlerde bu çağrıları bir yere bağlamanız gerekir. Bu durumda postmandan istek atabilecğeiniz gibi bir PowerShell komutu ile de bu apılara istek atabilirsiniz. Ek olarak Python scriptleri ile de bu REST API’lara istek atıp gerekirse önüne bir arayüz yazarak Fabric’i yönettiğiniz bir uygulama yazabilirsiniz! <h3 id="d2cf109d-b54d-4132-b5be-98ca0f92c035" data-toc-id="d2cf109d-b54d-4132-b5be-98ca0f92c035" style="font-size: 20px; line-height: 1.2;">Toparlarsak </h3>Fabric arayüzü, işinizin %80'ini fazlasıyla görür. Ama o geri kalan %20 — tenant geneli envanter, güvenlik denetimi, toplu işlemler, otomasyon — çoğunlukla REST API'ların dünyasında yaşar. Üstelik bu dünyaya adım atmak için önce kod yazmanıza bile gerek yok: bir dökümantasyon sayfasındaki “Try It” düğmesi, sizi saniyeler içinde içeri alıyor. Sonraki bölümlerde gerçek kullanım senaryoları ile bu API’ları birlikte deneyeceğiz. Görüşmek üzere!

Fabrication #11 : REST API'lar ile Fabric Yönetimi

Somut bir örnek: Tüm organizasyonun deployment pipeline'larını listelemek 

Read articles, tips, and resources to help you learn, grow, and succeed. Explore our latest posts covering education, community, and personal growth

Blog – Insights, Tips & Resources for Learning and Growth

Explore articles, tips, and insights to help you succeed in learning, community building, and personal development.

Fabrication #11 : REST API'lar ile Fabric Yönetimi

Fabrication #11 : REST API'lar ile Fabric Yönetimi

Related Posts

Fabrication #10 : Fabric App Nedir?

Fabrication #9 : Notebook Yasak, Dataflow Serbest

H-Azure Bilgi #1 : Shared Responsibility Model Nedir?

Veri Modelleme Öldü Mü? Sonsuz İşlem Gücü Çağında Normalizasyon ve Denormalizasyon İkilemi