Reports - Clone Report In Group

Referensi

Service:: Power BI REST APIs

API Version:: v1.0

Mengkloning laporan yang ditentukan dari ruang kerja yang ditentukan.

Jika himpunan data untuk laporan kloning berada di dua ruang kerja yang berbeda atau di Ruang kerja saya, himpunan data bersama akan dibuat di ruang kerja laporan.
Saat dikloning, laporan dengan koneksi langsung akan kehilangan koneksi tersebut dan sebaliknya memiliki pengikatan langsung ke himpunan data target.

Izin

Pengguna harus memiliki semua hal berikut, kecuali persyaratan tidak berlaku:
- Izin tulis pada laporan yang ditentukan.
- Izin build pada himpunan data target, diperlukan jika targetModelId parameter digunakan.
Panggilan API ini dapat dipanggil oleh profil perwakilan layanan. Untuk informasi selengkapnya lihat: Profil perwakilan layanan di Power BI Embedded.

Cakupan yang Diperlukan

Konten. Create

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/reports/{reportId}/Clone

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
groupId	path	True	string uuid	ID ruang kerja
reportId	path	True	string uuid	ID laporan

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
name	True	string	Nama laporan baru
targetModelId		string	Pilihan. Parameter untuk menentukan ID himpunan data terkait target. Jika tidak disediakan, laporan baru akan dikaitkan dengan himpunan data yang sama dengan laporan sumber.
targetWorkspaceId		string	Opsional. Parameter untuk menentukan ID ruang kerja target. GUID kosong (`00000000-0000-0000-0000-000000000000`) menunjukkan Ruang kerja saya. Jika parameter ini tidak disediakan, laporan baru akan dikloning dalam ruang kerja yang sama dengan laporan sumber.

Respons

Nama	Jenis	Deskripsi
200 OK	Report	OK

Contoh

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/reports/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Clone

Request Body

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

Sample Response

Status code:: 200

Definisi

Nama	Deskripsi
CloneReportRequest	Permintaan laporan kloning Power BI
PrincipalType	Jenis utama
Report	Laporan Power BI. API mengembalikan subset dari daftar properti laporan berikut. Subset bergantung pada API yang disebut, izin pemanggil, dan ketersediaan data dalam database Power BI.
ReportUser	Entri kanan akses pengguna Power BI untuk laporan
ReportUserAccessRight	Hak akses yang dimiliki pengguna untuk laporan (tingkat izin)
ServicePrincipalProfile	Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded.
Subscription	Langganan email untuk item Power BI (seperti laporan atau dasbor)
SubscriptionUser	Pengguna langganan email Power BI

CloneReportRequest

Permintaan laporan kloning Power BI

Nama	Jenis	Deskripsi
name	string	Nama laporan baru
targetModelId	string	Pilihan. Parameter untuk menentukan ID himpunan data terkait target. Jika tidak disediakan, laporan baru akan dikaitkan dengan himpunan data yang sama dengan laporan sumber.
targetWorkspaceId	string	Opsional. Parameter untuk menentukan ID ruang kerja target. GUID kosong (`00000000-0000-0000-0000-000000000000`) menunjukkan Ruang kerja saya. Jika parameter ini tidak disediakan, laporan baru akan dikloning dalam ruang kerja yang sama dengan laporan sumber.

PrincipalType

Jenis utama

Nama	Jenis	Deskripsi
App	string	Jenis perwakilan layanan
Group	string	Jenis prinsipal grup
None	string	Tidak ada jenis utama. Gunakan untuk akses tingkat seluruh organisasi.
User	string	Jenis prinsipal pengguna

Report

Laporan Power BI. API mengembalikan subset dari daftar properti laporan berikut. Subset bergantung pada API yang disebut, izin pemanggil, dan ketersediaan data dalam database Power BI.

Nama	Jenis	Deskripsi
appId	string	ID aplikasi, dikembalikan hanya jika laporan milik aplikasi
datasetId	string	ID himpunan data laporan
description	string	Deskripsi laporan
embedUrl	string	URL laporan yang disematkan
id	string	ID laporan
isOwnedByMe	boolean	Tentukan apakah laporan dibuat oleh pengguna saat ini.
name	string	Nama laporan
originalReportId	string	ID laporan aktual saat ruang kerja diterbitkan sebagai aplikasi.
reportType	enum: PaginatedReport PowerBIReport	Jenis laporan
subscriptions	Subscription[]	(Nilai Kosong) Detail langganan untuk item Power BI (seperti laporan atau dasbor). Properti ini akan dihapus dari respons payload dalam rilis mendatang. Anda bisa mengambil informasi langganan untuk laporan Power BI dengan menggunakan Dapatkan Langganan Laporan sebagai Admin panggilan API.
users	ReportUser[]	(Nilai kosong) Detail akses pengguna untuk laporan Power BI. Properti ini akan dihapus dari respons payload dalam rilis mendatang. Anda dapat mengambil informasi pengguna pada laporan Power BI dengan menggunakan panggilan Get Report Users as Admin API, atau panggilan POSTWorkspaceInfo API dengan `getArtifactUsers` parameter .
webUrl	string	URL web laporan

ReportUser

Entri kanan akses pengguna Power BI untuk laporan

Nama	Jenis	Deskripsi
displayName	string	Nama tampilan utama
emailAddress	string	Alamat email pengguna
graphId	string	Pengidentifikasi utama di Microsoft Graph. Hanya tersedia untuk API admin.
identifier	string	Pengidentifikasi utama
principalType	PrincipalType	Jenis utama
profile	ServicePrincipalProfile	Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded.
reportUserAccessRight	ReportUserAccessRight	Hak akses yang dimiliki pengguna untuk laporan (tingkat izin)
userType	string	Jenis pengguna.

ReportUserAccessRight

Hak akses yang dimiliki pengguna untuk laporan (tingkat izin)

Nama	Jenis	Deskripsi
None	string	Tidak ada izin untuk konten dalam laporan
Owner	string	Memberikan akses Baca, Tulis, dan Buat Ulang ke konten dalam laporan
Read	string	Memberikan akses Baca ke konten dalam laporan
ReadCopy	string	Memberikan akses Baca dan Salin ke konten dalam laporan
ReadReshare	string	Memberikan akses Baca dan Buat Ulang ke konten dalam laporan
ReadWrite	string	Memberikan akses Baca dan Tulis ke konten dalam laporan

ServicePrincipalProfile

Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded.

Nama	Jenis	Deskripsi
displayName	string	Nama profil perwakilan layanan
id	string	ID profil perwakilan layanan

Subscription

Langganan email untuk item Power BI (seperti laporan atau dasbor)

Nama	Jenis	Deskripsi
artifactDisplayName	string	Nama item Power BI langganan (seperti laporan atau dasbor)
artifactId	string	ID item Power BI langganan (seperti laporan atau dasbor)
artifactType	string	Jenis item Power BI (misalnya `Report`, , `Dashboard`atau `Dataset`)
attachmentFormat	string	Format laporan yang dilampirkan dalam langganan email
endDate	string	Tanggal dan waktu akhir langganan email
frequency	string	Frekuensi langganan email
id	string	ID langganan
isEnabled	boolean	Apakah langganan email diaktifkan
linkToContent	boolean	Apakah tautan langganan ada di langganan email
previewImage	boolean	Apakah cuplikan layar laporan ada di langganan email
startDate	string	Tanggal dan waktu mulai langganan email
subArtifactDisplayName	string	Nama halaman item Power BI langganan, jika merupakan laporan.
title	string	Nama aplikasi
users	SubscriptionUser[]	Detail setiap pelanggan email. Saat menggunakan panggilan Get User Subscriptions As Admin API, nilai yang dikembalikan adalah array kosong (null). Properti ini akan dihapus dari respons payload dalam rilis mendatang. Anda bisa mengambil informasi langganan pada laporan atau dasbor Power BI dengan menggunakan panggilan Dapatkan Langganan Laporan Sebagai Admin atau Dapatkan Langganan Dasbor Sebagai Admin API.

SubscriptionUser

Pengguna langganan email Power BI

Nama	Jenis	Deskripsi
displayName	string	Nama tampilan utama
emailAddress	string	Alamat email pengguna
graphId	string	Pengidentifikasi utama di Microsoft Graph. Hanya tersedia untuk API admin.
identifier	string	Pengidentifikasi utama
principalType	PrincipalType	Jenis utama
profile	ServicePrincipalProfile	Profil utama layanan Power BI. Hanya relevan untuk solusi multi-penyewaan Power BI Embedded.
userType	string	Jenis pengguna.

Bagikan melalui