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.

API iki oluşturma modunu destekler: (1) rapor yapısı üzerinde tam denetim sağlar definition veya (2) mevcut bir anlam modeline bağlı boş bir rapor oluşturmak için ile bir semanticModelReference sağlarcreationPayload. veya definitioncreationPayload gereklidir. İkisini de aynı anda kullanamazsınız.

İzinler

Çağıranın katkıda bulunan çalışma alanı rolü olmalıdır. aracılığıyla semanticModelReferencebir anlam modeline başvuran bir creationPayload rapor oluştururken, çağıranın, bu semantik modelin farklı bir çalışma alanında bulunması (çalışma alanları arası başvuru) dahil olmak üzere başvuruda bulunılan semantik modele okuma erişimine de sahip olması gerekir.

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.

Desteklenen kimlikleri Microsoft Entra

Bu API, bu bölümde listelenen Microsoft identities 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

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

İstek Gövdesi

Veri Akışı Adı	Gerekli	Tür	Description
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.
creationPayload		ReportCreationPayload	Mevcut bir anlam modeline bağlı bir rapor oluşturmaya yönelik oluşturma yükü. veya `definitioncreationPayload` gereklidir. İkisini de aynı anda kullanamazsınız.
definition		ReportDefinition	Rapor genel tanımı. veya `definitioncreationPayload` gereklidir. İkisini de aynı anda kullanamazsınız.
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.
sensitivityLabelSettings		SensitivityLabelSettings	Raporun duyarlılık etiketi ayarları.

Yanıtlar

Veri Akışı Adı	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
429 Too Many Requests	ErrorResponse	Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir `Retry-After` üst bilgi döndürür. Üst Bilgiler Retry-After: integer
Other Status Codes	ErrorResponse	Yaygın hata kodları: ItemDisplayNameAlreadyInUse - Öğe görünen adı zaten kullanılıyor. BozukPayload - Sağlanan yük bozuk. MutuallyExclusiveProperties - `definition` ve `creationPayload` her ikisi de sağlanamaz. MissingRequiredProperty - Sağlanmalıdır `definition` veya `creationPayload` sağlanmalıdır. SemanticModelNotFound - Başvuruda bulunılan semantik model yok veya erişilebilir değil.

Örnekler

Create a report example

Create a report with creation payload example

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",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

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

Create a report with creation payload example

Örnek isteği

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/reports

{
  "displayName": "Sales Dashboard",
  "description": "An empty report connected to a semantic model.",
  "creationPayload": {
    "semanticModelReference": {
      "referenceType": "ById",
      "itemId": "5b218778-e7a5-4d73-8187-f10824047715",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  }
}

Örnek yanıt

Durum kodu:: 201

{
  "displayName": "Sales Dashboard",
  "description": "An empty report connected to a semantic model.",
  "type": "Report",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

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

Veri Akışı Adı	Description
CreateReportRequest	Rapor isteği yükü oluşturun.
EntireTenantPrincipal	Kiracı sorumlusunu temsil eder
ErrorParameter	Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
GroupDetails	Belirli ayrıntıları gruplandırma. Sorumlu türü `Group`olduğunda geçerlidir.
GroupPrincipal	Bir güvenlik grubunu temsil eder.
GroupType	Grubun türü. Zaman içinde ek grup türleri eklenebilir.
ItemReferenceById	Kimlik nesnesine göre bir öğe başvurusu.
ItemReferenceType	Öğe başvuru türü. Zaman içinde ek `ItemReferenceType` türleri eklenebilir.
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.
PrincipalType	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.
Report	Bir rapor nesnesi.
ReportCreationPayload	Tanım olmadan rapor oluşturmak için oluşturma yükü.
ReportDefinition	Rapor genel tanımı nesnesi. Rapor tanımının yapısı hakkında daha fazla bilgi için bu makaleye bakın.
ReportDefinitionPart	Rapor tanımı parça nesnesi.
SensitivityLabel	Bir öğeye uygulanan duyarlılık etiketini temsil eder.
SensitivityLabelApplyStrategy	Duyarlılık etiketini uygulama stratejisi. Varsayılan değer ApplyOrFail'dir. Zaman içinde ek türler eklenebilir.
SensitivityLabelSettings	Duyarlılık etiketi ayarları.
ServicePrincipalDetails	Hizmet sorumlusuna özgü ayrıntılar. Sorumlu türü `ServicePrincipal`olduğunda geçerlidir.
ServicePrincipalPrincipal	Microsoft Entra hizmet sorumlusunu temsil eder.
ServicePrincipalProfileDetails	Hizmet sorumlusu profili ayrıntıları. Sorumlu türü `ServicePrincipalProfile`olduğunda geçerlidir.
ServicePrincipalProfilePrincipal	Hizmet sorumlusu profilini temsil eder.
UserDetails	Kullanıcı sorumlusuna özgü ayrıntılar. Sorumlu türü `User`olduğunda geçerlidir.
UserPrincipal	Microsoft Entra kullanıcı sorumlusunu temsil eder.

CreateReportRequest

Nesne

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

Veri Akışı Adı	Tür	Description
creationPayload	ReportCreationPayload	Mevcut bir anlam modeline bağlı bir rapor oluşturmaya yönelik oluşturma yükü. veya `definitioncreationPayload` gereklidir. İkisini de aynı anda kullanamazsınız.
definition	ReportDefinition	Rapor genel tanımı. veya `definitioncreationPayload` gereklidir. İkisini de aynı anda kullanamazsınız.
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.
sensitivityLabelSettings	SensitivityLabelSettings	Raporun duyarlılık etiketi ayarları.

EntireTenantPrincipal

Nesne

Kiracı sorumlusunu temsil eder

Veri Akışı Adı	Tür	Description
displayName	string	Sorumlunun görünen adı.
id	string (uuid)	Sorumlunun kimliği.
type	string: EntireTenant	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

ErrorParameter

Nesne

Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.

Veri Akışı Adı	Tür	Description
message	string	Parametrenin anlamının insan tarafından okunabilen açıklaması.
name	string	Parametre tanımlayıcısı.
value	string	Parametre değeridir.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Veri Akışı Adı	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ı.

Veri Akışı Adı	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ı.
isRetriable	boolean	True olduğunda istek yeniden denenebilir. Varsa gecikmeyi `Retry-After` belirlemek için yanıt üst bilgisini kullanın.
message	string	Hatanın okunabilir bir gösterimi.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
parameters	ErrorParameter[]	Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string (uuid)	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

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

Veri Akışı Adı	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.
parameters	ErrorParameter[]	Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

GroupDetails

Nesne

Belirli ayrıntıları gruplandırma. Sorumlu türü Groupolduğunda geçerlidir.

Veri Akışı Adı	Tür	Description
groupType	GroupType	Grubun türü. Zaman içinde ek grup türleri eklenebilir.

GroupPrincipal

Nesne

Bir güvenlik grubunu temsil eder.

Veri Akışı Adı	Tür	Description
displayName	string	Sorumlunun görünen adı.
groupDetails	GroupDetails	Belirli ayrıntıları gruplandırma. Sorumlu türü `Group`olduğunda geçerlidir.
id	string (uuid)	Sorumlunun kimliği.
type	string: Group	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

GroupType

Numaralandırma

Grubun türü. Zaman içinde ek grup türleri eklenebilir.

Değer	Description
Unknown	Asıl grup türü bilinmiyor.
SecurityGroup	Sorumlu bir güvenlik grubudur.
DistributionList	Sorumlu bir dağıtım listesidir.

ItemReferenceById

Nesne

Kimlik nesnesine göre bir öğe başvurusu.

Veri Akışı Adı	Tür	Description
itemId	string (uuid)	Öğenin kimliği.
referenceType	string: ById	Öğe başvuru türü.
workspaceId	string (uuid)	Öğenin çalışma alanı kimliği.

ItemReferenceType

Numaralandırma

Öğe başvuru türü. Zaman içinde ek ItemReferenceType türleri eklenebilir.

Değer	Description
ById	Öğeye kimliği tarafından başvurulur.
ByVariable	Öğeye bir değişken tarafından başvurulur.

ItemTag

Nesne

Bir öğeye uygulanan etiketi temsil eder.

Veri Akışı Adı	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.
DataAgent	A DataAgent.
MirroredCatalog	A MirroredCatalog.
PolicySet	İlke Kümesi.
AppBackend	An AppBackend.
OrgApp	Kuruluş uygulaması.
OrgAppAudience	Kuruluş Uygulaması Hedef Kitlesi.
DataBuildToolJob	A DataBuildToolJob.
AzureDatabricksStorage	Azure Databricks için OneLake destekli bir depolama öğesi.
Plan	Bir plan.
Monitoring	İzleme öğesi.
DeploymentPlan	Dağıtım planı.

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.

PrincipalType

Numaralandırma

Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

Değer	Description
User	Sorumlu, Microsoft Entra kullanıcı sorumlusudur.
ServicePrincipal	Sorumlu bir Microsoft Entra hizmet sorumlusudur.
Group	Sorumlu bir güvenlik grubudur.
ServicePrincipalProfile	Sorumlu bir hizmet sorumlusu profilidir.
EntireTenant	Sorumlu, tüm kiracı kullanıcılarını temsil eder.

Report

Nesne

Bir rapor nesnesi.

Veri Akışı Adı	Tür	Description
defaultIdentity	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Öğenin varsayılan kimliği.
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.
logicalId	string (uuid)	Öğenin mantıksal tanımlayıcısı. Karşılık gelen öğe örnekleri aynı mantıksal kimliği paylaşır. Hiçbir mantıksal kimlik atanmadığında değer null olur.
sensitivityLabel	SensitivityLabel	Öğe duyarlılığı etiketi.
tags	ItemTag[]	Uygulanan etiketlerin listesi.
type	ItemType	Öğe türü.
workspaceId	string (uuid)	Çalışma alanı kimliği.

ReportCreationPayload

Nesne

Tanım olmadan rapor oluşturmak için oluşturma yükü.

Veri Akışı Adı	Tür	Description
semanticModelReference	ItemReferenceById	Raporun bağlanacak anlam modeline başvuru. Semantik modeli çağıran tarafından erişilebilir olmalıdır.

ReportDefinition

Nesne

Rapor genel tanımı nesnesi. Rapor tanımının yapısı hakkında daha fazla bilgi için bu makaleye bakın.

Veri Akışı Adı	Tür	Description
format	string	Rapor tanımının biçimi.
parts	ReportDefinitionPart[]	Tanım bölümlerinin listesi.

ReportDefinitionPart

Nesne

Rapor tanımı parça nesnesi.

Veri Akışı Adı	Tür	Description
path	string	Rapor bölümü yolu.
payload	string	Rapor bölümü yükü.
payloadType	PayloadType	Yük türü.

SensitivityLabel

Nesne

Bir öğeye uygulanan duyarlılık etiketini temsil eder.

Veri Akışı Adı	Tür	Description
id	string (uuid)	Duyarlılık etiketi kimliği.

SensitivityLabelApplyStrategy

Numaralandırma

Duyarlılık etiketini uygulama stratejisi. Varsayılan değer ApplyOrFail'dir. Zaman içinde ek türler eklenebilir.

Değer	Description
ApplyOrFail	Duyarlılık etiketini uygulayın veya uygulanamıyorsa işlem başarısız olur.
Ignore	Uygulanamıyorsa duyarlılık etiketini yoksayın ve etiketi uygulamadan işleme devam edin.

SensitivityLabelSettings

Nesne

Duyarlılık etiketi ayarları.

Veri Akışı Adı	Tür	Description
labelId	string (uuid)	Duyarlılık etiketi kimliği.
sensitivityLabelApplyStrategy	SensitivityLabelApplyStrategy	Duyarlılık etiketini uygulama stratejisi.

ServicePrincipalDetails

Nesne

Hizmet sorumlusuna özgü ayrıntılar. Sorumlu türü ServicePrincipalolduğunda geçerlidir.

Veri Akışı Adı	Tür	Description
aadAppId	string (uuid)	Hizmet sorumlusunun Microsoft Entra AppId değeri.

ServicePrincipalPrincipal

Nesne

Microsoft Entra hizmet sorumlusunu temsil eder.

Veri Akışı Adı	Tür	Description
displayName	string	Sorumlunun görünen adı.
id	string (uuid)	Sorumlunun kimliği.
servicePrincipalDetails	ServicePrincipalDetails	Hizmet sorumlusuna özgü ayrıntılar. Sorumlu türü `ServicePrincipal`olduğunda geçerlidir.
type	string: ServicePrincipal	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

ServicePrincipalProfileDetails

Nesne

Hizmet sorumlusu profili ayrıntıları. Sorumlu türü ServicePrincipalProfileolduğunda geçerlidir.

Veri Akışı Adı	Tür	Description
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Hizmet sorumlusu profilinin üst sorumlusu.

ServicePrincipalProfilePrincipal

Nesne

Hizmet sorumlusu profilini temsil eder.

Veri Akışı Adı	Tür	Description
displayName	string	Sorumlunun görünen adı.
id	string (uuid)	Sorumlunun kimliği.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Hizmet sorumlusu profili ayrıntıları. Sorumlu türü `ServicePrincipalProfile`olduğunda geçerlidir.
type	string: ServicePrincipalProfile	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.

UserDetails

Nesne

Kullanıcı sorumlusuna özgü ayrıntılar. Sorumlu türü Userolduğunda geçerlidir.

Veri Akışı Adı	Tür	Description
userPrincipalName	string	Kullanıcı asıl adı.

UserPrincipal

Nesne

Microsoft Entra kullanıcı sorumlusunu temsil eder.

Veri Akışı Adı	Tür	Description
displayName	string	Sorumlunun görünen adı.
id	string (uuid)	Sorumlunun kimliği.
type	string: User	Sorumlunun türü. Zaman içinde ek sorumlu türleri eklenebilir.
userDetails	UserDetails	Kullanıcı sorumlusuna özgü ayrıntılar. Sorumlu türü `User`olduğunda geçerlidir.