Reports - Clone Report
Belirtilen raporu Çalışma alanım bölümünden kopyalar.
- Kopyalanan raporun veri kümesi iki farklı çalışma alanında veya Çalışma alanım'da bulunuyorsa, raporun çalışma alanında paylaşılan bir veri kümesi oluşturulur.
- Kopyalandığında, canlı bağlantısı olan raporlar bu bağlantıyı kaybeder ve bunun yerine hedef veri kümesine doğrudan bağlamaya sahip olur.
İzinler
Bir gereksinim geçerli olmadığı sürece kullanıcının aşağıdakilerin tümüne sahip olması gerekir:
- Belirtilen rapora yazma izni.
- Parametre kullanılıyorsa, hedef veri kümesi üzerinde
targetModelId
derleme izni gerekir.
Gerekli Kapsam
Content.Create
POST https://api.powerbi.com/v1.0/myorg/reports/{reportId}/Clone
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
report
|
path | True |
string uuid |
Rapor kimliği |
İstek Gövdesi
Name | Gerekli | Tür | Description |
---|---|---|---|
name | True |
string |
Yeni rapor adı |
targetModelId |
string |
İsteğe bağlı. Hedefle ilişkilendirilmiş veri kümesi kimliğini belirtme parametresi. Sağlanmadıysa, yeni rapor kaynak raporla aynı veri kümesiyle ilişkilendirilecektir. |
|
targetWorkspaceId |
string |
İsteğe bağlı. Hedef çalışma alanı kimliğini belirtme parametresi. Boş BIR GUID ( |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Tamam |
Örnekler
Example
Örnek isteği
POST https://api.powerbi.com/v1.0/myorg/reports/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Clone
{
"name": "New Report Name",
"targetModelId": "8e4d5880-81d6-4804-ab97-054665050799",
"targetWorkspaceId": "2f42a406-a075-4a15-bbf2-97ef958c94cb"
}
Örnek yanıt
Tanımlar
Name | Description |
---|---|
Clone |
Power BI kopya rapor isteği |
Principal |
Sorumlu türü |
Report |
Power BI raporu. API, aşağıdaki rapor özellikleri listesinin bir alt kümesini döndürür. Alt küme, çağrılan API'ye, çağıran izinlerine ve Power BI veritabanındaki verilerin kullanılabilirliğine bağlıdır. |
Report |
Bir rapor için Power BI kullanıcı erişim hakkı girdisi |
Report |
Kullanıcının rapor için sahip olduğu erişim hakkı (izin düzeyi) |
Service |
Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir. |
Subscription |
Power BI öğesi (rapor veya pano gibi) için e-posta aboneliği |
Subscription |
Power BI e-posta aboneliği kullanıcısı |
CloneReportRequest
Power BI kopya rapor isteği
Name | Tür | Description |
---|---|---|
name |
string |
Yeni rapor adı |
targetModelId |
string |
İsteğe bağlı. Hedefle ilişkilendirilmiş veri kümesi kimliğini belirtme parametresi. Sağlanmadıysa, yeni rapor kaynak raporla aynı veri kümesiyle ilişkilendirilecektir. |
targetWorkspaceId |
string |
İsteğe bağlı. Hedef çalışma alanı kimliğini belirtme parametresi. Boş BIR GUID ( |
PrincipalType
Sorumlu türü
Name | Tür | Description |
---|---|---|
App |
string |
Hizmet sorumlusu türü |
Group |
string |
Grup sorumlusu türü |
None |
string |
Sorumlu türü yok. Tüm kuruluş düzeyinde erişim için kullanın. |
User |
string |
Kullanıcı asıl türü |
Report
Power BI raporu. API, aşağıdaki rapor özellikleri listesinin bir alt kümesini döndürür. Alt küme, çağrılan API'ye, çağıran izinlerine ve Power BI veritabanındaki verilerin kullanılabilirliğine bağlıdır.
Name | Tür | Description |
---|---|---|
appId |
string |
Yalnızca rapor bir uygulamaya aitse döndürülen uygulama kimliği |
datasetId |
string |
Raporun veri kümesi kimliği |
description |
string |
Rapor açıklaması |
embedUrl |
string |
Raporun ekleme URL'si |
id |
string |
Rapor kimliği |
isOwnedByMe |
boolean |
Raporun geçerli kullanıcı tarafından oluşturulup oluşturulmadığını belirleyin. |
name |
string |
Raporun adı |
originalReportId |
string |
Çalışma alanı bir uygulama olarak yayımlandığında gerçek rapor kimliği. |
reportType |
enum:
|
Rapor türü |
subscriptions |
(Boş Değer) Bir Power BI öğesinin (rapor veya pano gibi) abonelik ayrıntıları. Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Yönetici API çağrısı olarak Rapor Aboneliklerini Al'ı kullanarak bir Power BI raporunun abonelik bilgilerini alabilirsiniz. |
|
users |
(Boş değer) Power BI raporu için kullanıcı erişim ayrıntıları. Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır.
Rapor Kullanıcılarını Yönetici API olarak alma çağrısını veya parametresiyle PostWorkspaceInfo API çağrısını kullanarak bir Power BI raporundaki |
|
webUrl |
string |
Raporun web URL'si |
ReportUser
Bir rapor için Power BI kullanıcı erişim hakkı girdisi
Name | Tür | Description |
---|---|---|
displayName |
string |
Sorumlunun görünen adı |
emailAddress |
string |
Kullanıcının e-posta adresi |
graphId |
string |
Microsoft Graph'ta sorumlunun tanımlayıcısı. Yalnızca yönetici API'leri için kullanılabilir. |
identifier |
string |
Sorumlunun tanımlayıcısı |
principalType |
Sorumlu türü |
|
profile |
Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir. |
|
reportUserAccessRight |
Kullanıcının rapor için sahip olduğu erişim hakkı (izin düzeyi) |
|
userType |
string |
Kullanıcının türü. |
ReportUserAccessRight
Kullanıcının rapor için sahip olduğu erişim hakkı (izin düzeyi)
Name | Tür | Description |
---|---|---|
None |
string |
Rapordaki içeriğe izin yok |
Owner |
string |
Rapordaki içeriğe Okuma, Yazma ve Yeniden Paylaşma erişimi verir |
Read |
string |
Rapordaki içeriğe Okuma erişimi verir |
ReadCopy |
string |
Rapordaki içeriğe Okuma ve Kopyalama erişimi verir |
ReadReshare |
string |
Rapordaki içeriğe Okuma ve Yeniden Paylaşma erişimi verir |
ReadWrite |
string |
Rapordaki içeriğe Okuma ve Yazma erişimi verir |
ServicePrincipalProfile
Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.
Name | Tür | Description |
---|---|---|
displayName |
string |
Hizmet sorumlusu profil adı |
id |
string |
Hizmet sorumlusu profil kimliği |
Subscription
Power BI öğesi (rapor veya pano gibi) için e-posta aboneliği
Name | Tür | Description |
---|---|---|
artifactDisplayName |
string |
Abone olunan Power BI öğesinin adı (rapor veya pano gibi) |
artifactId |
string |
Abone olunan Power BI öğesinin kimliği (rapor veya pano gibi) |
artifactType |
string |
Power BI öğesinin türü (örneğin |
attachmentFormat |
string |
E-posta aboneliğine eklenen raporun biçimi |
endDate |
string |
E-posta aboneliğinin bitiş tarihi ve saati |
frequency |
string |
E-posta aboneliğinin sıklığı |
id |
string |
Abonelik kimliği |
isEnabled |
boolean |
E-posta aboneliğinin etkinleştirilip etkinleştirilmediği |
linkToContent |
boolean |
E-posta aboneliğinde abonelik bağlantısı olup olmadığı |
previewImage |
boolean |
Raporun ekran görüntüsünün e-posta aboneliğinde olup olmadığı |
startDate |
string |
E-posta aboneliğinin başlangıç tarihi ve saati |
subArtifactDisplayName |
string |
Bir raporsa abone olunan Power BI öğesinin sayfa adı. |
title |
string |
Uygulama adı |
users |
Her e-posta abonesinin ayrıntıları. Api çağrısını Yönetici Olarak Kullanıcı Aboneliklerini Al kullanıldığında, döndürülen değer boş bir dizidir (null). Bu özellik, gelecek bir sürümde yük yanıtından kaldırılacaktır. Bir Power BI raporu veya panosundaki abonelik bilgilerini almak için Rapor Aboneliklerini Yönetici Olarak Al veya Pano Aboneliklerini Yönetici API çağrıları olarak al'ı kullanabilirsiniz. |
SubscriptionUser
Power BI e-posta aboneliği kullanıcısı
Name | Tür | Description |
---|---|---|
displayName |
string |
Sorumlunun görünen adı |
emailAddress |
string |
Kullanıcının e-posta adresi |
graphId |
string |
Microsoft Graph'ta sorumlunun tanımlayıcısı. Yalnızca yönetici API'leri için kullanılabilir. |
identifier |
string |
Sorumlunun tanımlayıcısı |
principalType |
Sorumlu türü |
|
profile |
Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir. |
|
userType |
string |
Kullanıcının türü. |