Megosztás a következőn keresztül:

Items - Create Report

  • Referencia
Szolgáltatás:
Report
API-verzió:
v1

Létrehoz egy jelentést a megadott munkaterületen.
Ez az API támogatja hosszú ideig futó műveleteket (LRO).

Ehhez az API-hoz definíciósszükséges.

Engedélyek

A hívónak közreműködői vagy magasabb munkaterületi szerepkört kell tartalmaznia.

Kötelező delegált hatókörök

Report.ReadWrite.All vagy Item.ReadWrite.All

Korlátozások

Microsoft Entra által támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft identitásokat.

Azonosság Támogat
Felhasználó Igen
szolgáltatásnév és felügyelt identitások Igen

Interfész

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

URI-paraméterek

Name In Kötelező Típus Description
workspaceId
 path True

string

uuid

A munkaterület azonosítója.

Kérelem törzse

Name Kötelező Típus Description
definition True

ReportDefinition

A jelentés nyilvános definíciója.
displayName True

string

A jelentés megjelenítendő neve. A megjelenítendő névnek az elemtípusnak megfelelő elnevezési szabályokat kell követnie.
description

string

A jelentés leírása. A maximális hossz 256 karakter.

Válaszok

Name Típus Description
201 Created

Report

Sikeresen létrehozva
202 Accepted

A kérelem elfogadva, a jelentés kiépítése folyamatban van.

Fejlécek

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Gyakori hibakódok:

  • InvalidItemType – Az elem típusa érvénytelen.

  • ItemDisplayNameAlreadyInUse – Az elem megjelenítendő neve már használatban van.

  • CorruptedPayload – A megadott hasznos adatok sérültek.

Példák

Create a report example

Mintakérelem

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

Mintaválasz

Állapotkód:
201 
{
  "displayName": "Report 1",
  "description": "A report description.",
  "type": "Report",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Állapotkód:
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

Definíciók

Name Description
CreateReportRequest

Jelentéskérés hasznos adatainak létrehozása.
ErrorRelatedResource

A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse

A hibaválasz.
ErrorResponseDetails

A hibaválasz részletei.
ItemType

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.
PayloadType

A definíciórész hasznos adattípusa. Idővel további hasznos adattípusok is hozzáadhatók.
Report

Jelentésobjektum.
ReportDefinition

Jelentés nyilvános definíciós objektuma. Ebben a cikkben további információt a jelentések nyilvános definíciójának elkészítéséről.
ReportDefinitionPart

Jelentésdefiníció részobjektuma.

CreateReportRequest

Objektum

Jelentéskérés hasznos adatainak létrehozása.

Name Típus Description
definition

ReportDefinition

A jelentés nyilvános definíciója.
description

string

A jelentés leírása. A maximális hossz 256 karakter.
displayName

string

A jelentés megjelenítendő neve. A megjelenítendő névnek az elemtípusnak megfelelő elnevezési szabályokat kell követnie.

ErrorRelatedResource

Objektum

A hibával kapcsolatos erőforrás-részletek objektum.

Name Típus Description
resourceId

string

A hibában érintett erőforrás-azonosító.
resourceType

string

A hibában érintett erőforrás típusa.

ErrorResponse

Objektum

A hibaválasz.

Name Típus Description
errorCode

string

Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message

string

A hiba emberi olvasható ábrázolása.
moreDetails

ErrorResponseDetails[]

További hibaadatok listája.
relatedResource

ErrorRelatedResource

A hibával kapcsolatos erőforrásadatok.
requestId

string

A hibához társított kérés azonosítója.

ErrorResponseDetails

Objektum

A hibaválasz részletei.

Name Típus Description
errorCode

string

Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message

string

A hiba emberi olvasható ábrázolása.
relatedResource

ErrorRelatedResource

A hibával kapcsolatos erőforrásadatok.

ItemType

Enumerálás

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.

Érték Description
Dashboard

PowerBI-irányítópult.
DataPipeline

Egy adatfolyam.
Datamart

PowerBI datamart.
Environment

Egy környezet.
Eventhouse

Egy rendezvényház.
Eventstream

Eseménystream.
GraphQLApi

Api a GraphQL-elemhez.
KQLDashboard

KQL-irányítópult.
KQLDatabase

KQL-adatbázis.
KQLQueryset

KQL-lekérdezéskészlet.
Lakehouse

Egy tóház.
MLExperiment

Gépi tanulási kísérlet.
MLModel

Gépi tanulási modell.
MirroredDatabase

Tükrözött adatbázis.
MirroredWarehouse

Egy tükrözött raktár.
MountedDataFactory

A MountedDataFactory.
Notebook

Egy jegyzetfüzet.
PaginatedReport

Többoldalas PowerBI-jelentés.
Reflex

Egy reflex.
Report

PowerBI-jelentés.
SQLDatabase

A SQLDatabase.
SQLEndpoint

EGY SQL-végpont.
SemanticModel

PowerBI szemantikai modell.
SparkJobDefinition

Spark-feladat definíciója.
Warehouse

Egy raktár.

PayloadType

Enumerálás

A definíciórész hasznos adattípusa. Idővel további hasznos adattípusok is hozzáadhatók.

Érték Description
InlineBase64

Beágyazott 64-es alap.

Report

Objektum

Jelentésobjektum.

Name Típus Description
description

string

Az elem leírása.
displayName

string

Az elem megjelenítendő neve.
id

string

uuid

Az elem azonosítója.
type

ItemType

Az elem típusa.
workspaceId

string

uuid

A munkaterület azonosítója.

ReportDefinition

Objektum

Jelentés nyilvános definíciós objektuma. Ebben a cikkben további információt a jelentések nyilvános definíciójának elkészítéséről.

Name Típus Description
format

string

Az elemdefiníció formátuma.
parts

ReportDefinitionPart[]

Definíciórészek listája.

ReportDefinitionPart

Objektum

Jelentésdefiníció részobjektuma.

Name Típus Description
path

string

A jelentésrész elérési útja.
payload

string

A jelentésrész hasznos adatai.
payloadType

PayloadType

A hasznos adat típusa.