Anlam modeli REST API izinleri
Bu makalede genel olarak Power BI izinleri ve Power BI REST API'leri bağlamında anlamsal model izinleri açıklanmaktadır.
Power BI izinleri
Power BI'ın iki izin kümesi vardır:
Çalışma alanı izinleri
Klasör izinleri veya rolleri olarak da bilinen çalışma alanı izinleri, Power BI'daki en yüksek izin düzeyidir. Bu izinler, çalışma alanı klasöründeki belirli bir öğeye verilen izinleri geçersiz kılar.
Aşağıdaki tabloda dört tür klasör rolü listelenmiştir. Her rolün düzeyini ve Power BI REST API'leri tarafından döndürülen kod dizesini gösterir. Yönetici en yüksek çalışma alanı izin düzeyi ve görüntüleyici en düşük düzeydir. Her izin düzeyi, altındaki izinlerin özelliklerini içerir. Çalışma Alanı rollerinde her iznin özelliklerini gözden geçirebilirsiniz.
| Klasör Rolü | Düzey | Çalışma alanında oluşturulan anlamsal modeller için türetilmiş izinler |
|---|---|---|
| Yönetici | 4 | ReadWriteReshareExplore |
| Üye | 3 | ReadWriteReshareExplore |
| Katılımcı | 2 | ReadWriteExplore |
| İzleyici | 1 | Read |
Not
Yazma izni, sahip oldukları bir çalışma alanında yönetici, üye ve katkıda bulunan kullanıcılar tarafından oluşturulan Power BI anlam modellerine uygulanır. Yazma izni yalnızca çalışma alanı izinleri kullanılarak verilebilir veya silinebilir. Bir Power BI öğesine doğrudan verilemez veya öğeden silinemez.
API'lerle çalışma alanı izinleri alma ve ekleme
Çalışma alanı izinlerini program aracılığıyla almak ve eklemek için şu API'leri kullanın:
Gruplar - Grup Kullanıcısı Ekleme - Çalışma alanı izinleri eklemek için bir POST API'si
Gruplar - Grup Kullanıcısını Güncelleştirme - Çalışma alanı izinlerini değiştirmek için PUT API'si
Gruplar - Grup Kullanıcılarını Alma - Çalışma alanı izinlerini almak için bir GET API'si
Öğe izinleri
Raporlar, anlam modelleri ve panolar gibi Power BI öğelerinin kendi izinleri vardır. Öğe izinleri çalışma alanı izinlerini geçersiz kılamaz ve yalnızca en az aynı izin düzeyine sahip biri tarafından verilebilir.
Anlam modeli izinleri ve REST API'leri
Anlam modeli izinleri, öğe izinlerinin bir parçasıdır. Aşağıdaki tabloda Power BI anlam modeli izinleri ve Bunların Power BI REST API'lerindeki gösterimi listelenmiştir.
İpucu
API izinleri Power BI hizmeti izinleriyle aynı olsa da, build izinler API'lerdeki araştırma izinleri olarak adlandırılır.
| İzin | Oku | Araştırın | Yeniden paylaş |
|---|---|---|---|
| Açıklama | Kullanıcının anlamsal modelin içeriğini okumasına izin verir | Derleme izinlerine eşdeğer | Kullanıcının anlamsal modelin içeriğini okuma, yeniden paylaşma veya inceleme izinlerini alacak diğer kullanıcılarla paylaşmasına izin verir |
| ReadReshareExplore | 
|
|
|
| ReadReshare |
|
|
|
| ReadExplore |
|
|
|
| Okuma |
|
|
|
Not
Bir kullanıcının anlamsal modelde yazma işlemleri gerçekleştirmesine izin vermek için önce çalışma alanı izinlerini değiştirin.
Derleme izinleri ve REST API'leri
Power BI REST API'lerinde, build araştırma olarak izin döndürülür. Örneğin, okuma, yeniden paylaşma ve derleme izinlerine sahip bir dize şöyle görünür: ReadReshareExplore.
Bir kullanıcıya build izin verdiğinizde, bunlar semantik modelinizde yeni içerik oluşturabilir. Oluşturabilecekleri içeriğe örnek olarak raporlar, panolar, Soru-Cevap'tan sabitlenmiş kutucuklar, sayfalandırılmış raporlar ve bulma Analizler verilebilir.
Kullanıcıların Power BI dışındaki verilerle çalışabilmesi için de izinlere sahip olması gerekir build :
Temel alınan verileri dışarı aktarmak için.
Excel'de Çözümle gibi anlamsal modelde yeni içerik oluşturmak için.
VERILERE XMLA uç noktası üzerinden erişmek için.
Satır düzeyi güvenlik
Satır düzeyi güvenlik (RLS) kullanan bir anlam modeli için, daha build yüksek izinler kullanıcının anlam modelindeki tüm verileri görüntülemesine olanak tanır. Buildve izinlerinden daha builddüşük olan izinler, semantik model kullanıcısına yalnızca RLS ayarlarınızda yapılandırıldığı gibi görmelerine izin verilen verilere erişim verir.
API'lerle anlam modeli izinlerini alma ve güncelleştirme
POST API'leri, bir anlam modeline yeni izinler eklemenize olanak sağlar. Bu API'leri kullanarak kullanıcılara izin ekleyebilir, ancak izinleri kaldıramazsınız. Örneğin, izni olan
Resharebir kullanıcıyaReadizni ekleyebilirsiniz. Ancak, izni eklemeye çalışarak hemResharehem deReadizinleri olan bir kullanıcıdan izni kaldıramazsınızReshare.ReadPUT API'leri kullanıcının izinlerini belirli bir veri kümesine güncelleştirir. PUT API'si yazma izinlerini veya devralınan herhangi bir klasör düzeyindeki izinleri değiştirmek için kullanılamaz. Bu API ayrıca belirli bir hedef için bir veri kümesinin tüm izinlerinin kaldırılmasını da destekler.
GET API'leri, belirtilen veri kümesine erişimi olan sorumluların listesini döndürür.
Dikkat edilecekler ve sınırlamalar
Yukarıdaki API'lerin her biri, bunları kimlerin ve nasıl kullanabileceğiyle ilgili belirli sınırlamalarla birlikte gelir. Her API'nin sınırlamalarını görmek için söz konusu API'nin bağlantısını seçin.