Items - Create Report
Membuat laporan di ruang kerja yang ditentukan.
API ini mendukung operasi jangka panjang (LRO).
Izin
Pemanggil harus memiliki kontributor atau peran ruang kerja yang lebih tinggi.
Cakupan yang Didelegasikan yang Diperlukan
Report.ReadWrite.All atau Item.ReadWrite.All
Keterbatasan
- Untuk membuat item laporan, pengguna harus memiliki lisensi yang sesuai. Untuk informasi selengkapnya, lihat: jenis lisensi Microsoft Fabric.
Identitas yang didukung Microsoft Entra
API ini mendukung identitas Microsoft yang tercantum di bagian ini.
Identitas | Dukung |
---|---|
Pengguna | Ya |
perwakilan Layanan dan identitas terkelola | Ya |
Antarmuka
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/reports
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
workspace
|
path | True |
string uuid |
ID ruang kerja. |
Isi Permintaan
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
definition | True |
Definisi publik laporan. |
|
displayName | True |
string |
Nama tampilan laporan. Nama tampilan harus mengikuti aturan penamaan sesuai dengan jenis item. |
description |
string |
Deskripsi laporan. Panjang maksimum adalah 256 karakter. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
201 Created |
Berhasil dibuat |
|
202 Accepted |
Permintaan diterima, laporkan provisi sedang berlangsung. Header
|
|
Other Status Codes |
Kode kesalahan umum:
|
Contoh
Create a report example
Permintaan sampel
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/reports
{
"displayName": "Report 1",
"description": "A report description.",
"definition": {
"parts": [
{
"path": "definition.pbir",
"payload": "ew0KICAidmVyc2lvbiI..sYVN0eWxlTGl2ZSINCiAgICB9DQogIH0NCn0=",
"payloadType": "InlineBase64"
},
{
"path": "report.json",
"payload": "ewogICJjb25maWciOiA..3aWR0aCI6IDEyODAuMDAKICAgIH0KICBdCn0=",
"payloadType": "InlineBase64"
},
{
"path": ".platform",
"payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
"payloadType": "InlineBase64"
}
]
}
}
Respon sampel
{
"displayName": "Report 1",
"description": "A report description.",
"type": "Report",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30
Definisi
Nama | Deskripsi |
---|---|
Create |
Buat payload permintaan laporan. |
Error |
Objek detail sumber daya terkait kesalahan. |
Error |
Respons kesalahan. |
Error |
Detail respons kesalahan. |
Item |
Jenis item. Jenis item tambahan dapat ditambahkan dari waktu ke waktu. |
Payload |
Jenis payload bagian definisi. Jenis payload tambahan dapat ditambahkan dari waktu ke waktu. |
Report |
Objek laporan. |
Report |
Laporkan objek definisi publik. Lihat artikel ini untuk detail selengkapnya tentang cara membuat definisi publik laporan. |
Report |
Laporkan objek bagian definisi. |
CreateReportRequest
Buat payload permintaan laporan.
Nama | Jenis | Deskripsi |
---|---|---|
definition |
Definisi publik laporan. |
|
description |
string |
Deskripsi laporan. Panjang maksimum adalah 256 karakter. |
displayName |
string |
Nama tampilan laporan. Nama tampilan harus mengikuti aturan penamaan sesuai dengan jenis item. |
ErrorRelatedResource
Objek detail sumber daya terkait kesalahan.
Nama | Jenis | Deskripsi |
---|---|---|
resourceId |
string |
ID sumber daya yang terlibat dalam kesalahan. |
resourceType |
string |
Jenis sumber daya yang terlibat dalam kesalahan. |
ErrorResponse
Respons kesalahan.
Nama | Jenis | Deskripsi |
---|---|---|
errorCode |
string |
Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya. |
message |
string |
Representasi kesalahan yang dapat dibaca manusia. |
moreDetails |
Daftar detail kesalahan tambahan. |
|
relatedResource |
Detail sumber daya terkait kesalahan. |
|
requestId |
string |
ID permintaan yang terkait dengan kesalahan. |
ErrorResponseDetails
Detail respons kesalahan.
Nama | Jenis | Deskripsi |
---|---|---|
errorCode |
string |
Pengidentifikasi tertentu yang menyediakan informasi tentang kondisi kesalahan, memungkinkan komunikasi standar antara layanan kami dan penggunanya. |
message |
string |
Representasi kesalahan yang dapat dibaca manusia. |
relatedResource |
Detail sumber daya terkait kesalahan. |
ItemType
Jenis item. Jenis item tambahan dapat ditambahkan dari waktu ke waktu.
Nilai | Deskripsi |
---|---|
Dashboard |
Dasbor PowerBI. |
DataPipeline |
Alur data. |
Datamart |
Datamart PowerBI. |
Environment |
Lingkungan. |
Eventhouse |
Sebuah rumah acara. |
Eventstream |
Eventstream. |
GraphQLApi |
API untuk item GraphQL. |
KQLDashboard |
Dasbor KQL. |
KQLDatabase |
Database KQL. |
KQLQueryset |
Set kueri KQL. |
Lakehouse |
Sebuah lakehouse. |
MLExperiment |
Eksperimen pembelajaran mesin. |
MLModel |
Model pembelajaran mesin. |
MirroredDatabase |
Database cermin. |
MirroredWarehouse |
Sebuah gudang cermin. |
MountedDataFactory |
A MountedDataFactory. |
Notebook |
Buku catatan. |
PaginatedReport |
Laporan paginasi PowerBI. |
Reflex |
Sebuah Refleks. |
Report |
Laporan PowerBI. |
SQLDatabase |
Sebuah SQLDatabase. |
SQLEndpoint |
Titik akhir SQL. |
SemanticModel |
Model semantik PowerBI. |
SparkJobDefinition |
Definisi pekerjaan spark. |
Warehouse |
Sebuah gudang. |
PayloadType
Jenis payload bagian definisi. Jenis payload tambahan dapat ditambahkan dari waktu ke waktu.
Nilai | Deskripsi |
---|---|
InlineBase64 |
Dasar Sebaris 64. |
Report
Objek laporan.
Nama | Jenis | Deskripsi |
---|---|---|
description |
string |
Deskripsi item. |
displayName |
string |
Nama tampilan item. |
id |
string uuid |
ID item. |
type |
Jenis item. |
|
workspaceId |
string uuid |
ID ruang kerja. |
ReportDefinition
Laporkan objek definisi publik. Lihat artikel ini untuk detail selengkapnya tentang cara membuat definisi publik laporan.
Nama | Jenis | Deskripsi |
---|---|---|
format |
string |
Format definisi item. |
parts |
Daftar bagian definisi. |
ReportDefinitionPart
Laporkan objek bagian definisi.
Nama | Jenis | Deskripsi |
---|---|---|
path |
string |
Jalur bagian laporan. |
payload |
string |
Payload bagian laporan. |
payloadType |
Jenis payload. |