Items - Create Report

Hizmet:: Report

API Sürümü:: v1

Belirtilen çalışma alanında bir rapor oluşturur.
Bu API, uzun süre çalışan işlemleri (LRO)destekler.

Bu API, birtanımı gerektirir.

İzinler

Çağıranın katkıda bulunan çalışma alanı rolü olmalıdır.

Gerekli Temsilci Kapsamları

Report.ReadWrite.All veya Item.ReadWrite.All

Sınırlama

Rapor öğesi oluşturmak için kullanıcının uygun lisansa sahip olması gerekir. Daha fazla bilgi için bkz. Microsoft Fabric lisans türleri.

Microsoft Entra tarafından desteklenen kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Kimlik	Destek
Kullanıcı	Evet
Hizmet sorumlusu ve yönetilen kimlikler	Evet

Arayüz

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/reports

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
workspaceId	path	True	string (uuid)	Çalışma alanı kimliği.

İstek Gövdesi

Name	Gerekli	Tür	Description
definition	True	ReportDefinition	Rapor genel tanımı.
displayName	True	string	Raporun görünen adı. Görünen ad, öğe türüne göre adlandırma kurallarına uymalıdır.
description		string	Rapor açıklaması. Uzunluk üst sınırı 256 karakterdir.
folderId		string (uuid)	Klasör kimliği. Belirtilmezse veya null değilse, rapor çalışma alanı klasörü olarak oluşturulur.

Yanıtlar

Name	Tür	Description
201 Created	Report	Başarıyla oluşturuldu
202 Accepted		İstek kabul edildi, rapor sağlama devam ediyor. Üst Bilgiler Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Yaygın hata kodları: InvalidItemType - Öğe türü geçersiz. ItemDisplayNameAlreadyInUse - Öğe görünen adı zaten kullanılıyor. BozukPayload - Sağlanan yük bozuk. WorkspaceItemsLimitExceeded - Çalışma alanı öğe sınırı aşıldı.

Name

Tür

Description

201 Created

Report

Başarıyla oluşturuldu

202 Accepted

İstek kabul edildi, rapor sağlama devam ediyor.

Üst Bilgiler

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

Yaygın hata kodları:

InvalidItemType - Öğe türü geçersiz.
ItemDisplayNameAlreadyInUse - Öğe görünen adı zaten kullanılıyor.
BozukPayload - Sağlanan yük bozuk.
WorkspaceItemsLimitExceeded - Çalışma alanı öğe sınırı aşıldı.

Örnekler

Create a report example

Örnek isteği

HTTP

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"
      }
    ]
  }
}

Örnek yanıt

Durum kodu:: 201

{
  "displayName": "Report 1",
  "description": "A report description.",
  "type": "Report",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Durum kodu:: 202

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

Tanımlar

Name	Description
CreateReportRequest	Rapor isteği yükü oluşturun.
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
ItemTag	Bir öğeye uygulanan etiketi temsil eder.
ItemType	Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.
PayloadType	Tanım parçası yükünün türü. Zaman içinde ek yük türleri eklenebilir.
Report	Bir rapor nesnesi.
ReportDefinition	Rapor genel tanımı nesnesi. Rapor genel tanımı oluşturma hakkında daha fazla bilgi için bu makale bakın.
ReportDefinitionPart	Rapor tanımı parça nesnesi.

CreateReportRequest

Nesne

Rapor isteği yükü oluşturun.

Name	Tür	Description
definition	ReportDefinition	Rapor genel tanımı.
description	string	Rapor açıklaması. Uzunluk üst sınırı 256 karakterdir.
displayName	string	Raporun görünen adı. Görünen ad, öğe türüne göre adlandırma kurallarına uymalıdır.
folderId	string (uuid)	Klasör kimliği. Belirtilmezse veya null değilse, rapor çalışma alanı klasörü olarak oluşturulur.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name	Tür	Description
resourceId	string	Hataya dahil olan kaynak kimliği.
resourceType	string	Hataya dahil olan kaynağın türü.

ErrorResponse

Nesne

Hata yanıtı.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

Hata yanıtı ayrıntıları.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

ItemTag

Nesne

Bir öğeye uygulanan etiketi temsil eder.

Name	Tür	Description
displayName	string	Etiketin adı.
id	string (uuid)	Etiket kimliği.

ItemType

Numaralandırma

Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.

Değer	Description
Dashboard	PowerBI panosu.
Report	PowerBI raporu.
SemanticModel	PowerBI anlam modeli.
PaginatedReport	PowerBI sayfalandırılmış raporu.
Datamart	PowerBI datamart.
Lakehouse	Göl evi.
Eventhouse	Bir olay evi.
Environment	Bir ortam.
KQLDatabase	KQL veritabanı.
KQLQueryset	KQL sorgu kümesi.
KQLDashboard	KQL panosu.
DataPipeline	Veri işlem hattı.
Notebook	Bir not defteri.
SparkJobDefinition	Spark iş tanımı.
MLExperiment	Makine öğrenmesi denemesi.
MLModel	Makine öğrenmesi modeli.
Warehouse	Bir depo.
Eventstream	Bir olay akışı.
SQLEndpoint	Bir SQL uç noktası.
MirroredWarehouse	Aynalı bir depo.
MirroredDatabase	Yansıtılmış veritabanı.
Reflex	Bir refleks.
GraphQLApi	GraphQL öğesi için bir API.
MountedDataFactory	Bir MountedDataFactory.
SQLDatabase	A SQLDatabase.
CopyJob	Kopyalama işi.
VariableLibrary	Bir VariableLibrary.
Dataflow	Veri akışı.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Ambar anlık görüntüsü.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Dijital İkiz Oluşturucu Akışı.
MirroredAzureDatabricksCatalog	Yansıtılmış azure databricks kataloğu.
Map	Bir harita.
AnomalyDetector	Anomali Algılayıcısı.
UserDataFunction	Kullanıcı Verileri İşlevi.
GraphModel	A GraphModel.
GraphQuerySet	A Graph QuerySet.
SnowflakeDatabase	Snowflake hesabından oluşturulan Iceberg tablolarını depolamak için bir Snowflake Veritabanı.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Cosmos DB Veritabanı.
Ontology	Bir Ontoloji.
EventSchemaSet	Bir EventSchemaSet.

PayloadType

Numaralandırma

Tanım parçası yükünün türü. Zaman içinde ek yük türleri eklenebilir.

Değer	Description
InlineBase64	Satır içi Temel 64.

Report

Nesne

Bir rapor nesnesi.

Name	Tür	Description
description	string	Öğe açıklaması.
displayName	string	Öğenin görünen adı.
folderId	string (uuid)	Klasör kimliği.
id	string (uuid)	Öğe kimliği.
tags	ItemTag[]	Uygulanan etiketlerin listesi.
type	ItemType	Öğe türü.
workspaceId	string (uuid)	Çalışma alanı kimliği.

ReportDefinition

Nesne

Rapor genel tanımı nesnesi. Rapor genel tanımı oluşturma hakkında daha fazla bilgi için bu makale bakın.

Name	Tür	Description
format	string	Öğe tanımının biçimi.
parts	ReportDefinitionPart[]	Tanım bölümlerinin listesi.

ReportDefinitionPart

Nesne

Rapor tanımı parça nesnesi.

Name	Tür	Description
path	string	Rapor bölümü yolu.
payload	string	Rapor bölümü yükü.
payloadType	PayloadType	Yük türü.

Aracılığıyla paylaş

Items - Create Report

İzinler

Gerekli Temsilci Kapsamları

Sınırlama

Microsoft Entra tarafından desteklenen kimlikler

Arayüz

URI Parametreleri

İstek Gövdesi

Yanıtlar

Örnekler

Create a report example

Örnek isteği

Örnek yanıt

Tanımlar

CreateReportRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemTag

ItemType

PayloadType

Report

ReportDefinition

ReportDefinitionPart