Reports - Clone Report

Başvuru

Hizmet:: Power BI REST APIs

API Sürümü:: v1.0

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 targetModelIdderleme 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
reportId	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 (`00000000-0000-0000-0000-000000000000`), Çalışma alanım'ı gösterir. Bu parametre sağlanmazsa, yeni rapor kaynak raporla aynı çalışma alanında kopyalanır.

Yanıtlar

Name	Tür	Description
200 OK	Report	Tamam

Örnekler

Example

Örnek isteği

POST https://api.powerbi.com/v1.0/myorg/reports/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Clone

İstek Gövdesi

{
  "name": "New Report Name",
  "targetModelId": "8e4d5880-81d6-4804-ab97-054665050799",
  "targetWorkspaceId": "2f42a406-a075-4a15-bbf2-97ef958c94cb"
}

Örnek yanıt

Durum kodu:: 200

Tanımlar

Name	Description
CloneReportRequest	Power BI kopya rapor isteği
PrincipalType	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.
ReportUser	Bir rapor için Power BI kullanıcı erişim hakkı girdisi
ReportUserAccessRight	Kullanıcının rapor için sahip olduğu erişim hakkı (izin düzeyi)
ServicePrincipalProfile	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
SubscriptionUser	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 (`00000000-0000-0000-0000-000000000000`), Çalışma alanım'ı gösterir. Bu parametre sağlanmazsa, yeni rapor kaynak raporla aynı çalışma alanında kopyalanır.

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: PaginatedReport PowerBIReport	Rapor türü
subscriptions	Subscription[]	(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	ReportUser[]	(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 `getArtifactUsers` kullanıcı bilgilerini alabilirsiniz.
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	PrincipalType	Sorumlu türü
profile	ServicePrincipalProfile	Power BI hizmeti asıl profili. Yalnızca çok kiracılı Power BI Embedded çözüm için geçerlidir.
reportUserAccessRight	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 `Report`, , `Dashboard`veya `Dataset`)
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	SubscriptionUser[]	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	PrincipalType	Sorumlu türü
profile	ServicePrincipalProfile	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ü.

Aracılığıyla paylaş