Del via

Items - Create Report

  • Reference
Tjeneste:
Report
API-version:
v1

Opretter en rapport i det angivne arbejdsområde.
Denne API understøtter LRO-handlinger (Long Running Operations).

Denne API kræver en definition.

Tilladelser

Den, der ringer op, skal have bidragyder eller en højere rolle i arbejdsområdet.

Påkrævede delegerede områder

Report.ReadWrite.All eller Item.ReadWrite.All

Begrænsninger

  • Hvis du vil oprette et rapportelement, skal brugeren have den relevante licens. Du kan få flere oplysninger under: Microsoft Fabric-licenstyper.

Microsoft Entra-understøttede identiteter

Denne API understøtter de Microsoft -identiteter, der angivet i dette afsnit.

Identitet Støtte
Bruger Ja
tjenesteprincipal og administrerede identiteter Ja

Grænseflade

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

URI-parametre

Name I Påkrævet Type Beskrivelse
workspaceId
 path True

string

uuid

Arbejdsområde-id'et.

Brødtekst for anmodning

Name Påkrævet Type Beskrivelse
definition True

ReportDefinition

Den offentlige definition af rapporten.
displayName True

string

Det viste navn på rapporten. Det viste navn skal følge navngivningsreglerne i henhold til elementtypen.
description

string

Beskrivelsen af rapporten. Maksimumlængden er 256 tegn.

Svar

Name Type Beskrivelse
201 Created

Report

Oprettet
202 Accepted

Anmodning accepteret, klargøring af rapport er i gang.

Headere

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

ErrorResponse

Almindelige fejlkoder:

  • InvalidItemType – Elementtypen er ugyldig.

  • ItemDisplayNameAlreadyInUse – Det viste navn på elementet bruges allerede.

  • CorruptedPayload – Den angivne nyttedata er beskadiget.

Eksempler

Create a report example

Eksempelanmodning

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

Eksempelsvar

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

Definitioner

Name Beskrivelse
CreateReportRequest

Opret nyttedata for rapportanmodninger.
ErrorRelatedResource

Objektet med fejlrelaterede ressourceoplysninger.
ErrorResponse

Fejlsvaret.
ErrorResponseDetails

Oplysninger om fejlsvar.
ItemType

Elementets type. Der kan tilføjes flere elementtyper over tid.
PayloadType

Typen af nyttedata for definitionsdelen. Der kan tilføjes flere nyttedatatyper over tid.
Report

Et rapportobjekt.
ReportDefinition

Rapportér objekt til offentlig definition. Se denne artikel for at få flere oplysninger om, hvordan du udformer en offentlig rapportdefinition.
ReportDefinitionPart

Objekt for rapportdefinitionsdel.

CreateReportRequest

Object

Opret nyttedata for rapportanmodninger.

Name Type Beskrivelse
definition

ReportDefinition

Den offentlige definition af rapporten.
description

string

Beskrivelsen af rapporten. Maksimumlængden er 256 tegn.
displayName

string

Det viste navn på rapporten. Det viste navn skal følge navngivningsreglerne i henhold til elementtypen.

ErrorRelatedResource

Object

Objektet med fejlrelaterede ressourceoplysninger.

Name Type Beskrivelse
resourceId

string

Det ressource-id, der er involveret i fejlen.
resourceType

string

Typen af ressource, der er involveret i fejlen.

ErrorResponse

Object

Fejlsvaret.

Name Type Beskrivelse
errorCode

string

Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere.
message

string

En menneskelig læsbar gengivelse af fejlen.
moreDetails

ErrorResponseDetails[]

Liste over yderligere oplysninger om fejl.
relatedResource

ErrorRelatedResource

De fejlrelaterede ressourceoplysninger.
requestId

string

Id'et for den anmodning, der er knyttet til fejlen.

ErrorResponseDetails

Object

Oplysninger om fejlsvar.

Name Type Beskrivelse
errorCode

string

Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere.
message

string

En menneskelig læsbar gengivelse af fejlen.
relatedResource

ErrorRelatedResource

De fejlrelaterede ressourceoplysninger.

ItemType

Optælling

Elementets type. Der kan tilføjes flere elementtyper over tid.

Værdi Beskrivelse
Dashboard

PowerBI-dashboard.
DataPipeline

En datapipeline.
Datamart

PowerBI-datamart.
Environment

Et miljø.
Eventhouse

Et eventhouse.
Eventstream

En hændelsesstream.
GraphQLApi

En API til GraphQL-element.
KQLDashboard

Et KQL-dashboard.
KQLDatabase

En KQL-database.
KQLQueryset

Et KQL-forespørgselssæt.
Lakehouse

Et søhus.
MLExperiment

Et maskinel indlæringseksperiment.
MLModel

En model til maskinel indlæring.
MirroredDatabase

En spejlet database.
MirroredWarehouse

Et spejlvendt lager.
MountedDataFactory

En MountedDataFactory.
Notebook

En notesbog.
PaginatedReport

Sideinddelt PowerBI-rapport.
Reflex

En refleks.
Report

PowerBI-rapport.
SQLDatabase

En SQLDatabase.
SQLEndpoint

Et SQL-slutpunkt.
SemanticModel

Semantisk PowerBI-model.
SparkJobDefinition

En spark jobdefinition.
Warehouse

Et lager.

PayloadType

Optælling

Typen af nyttedata for definitionsdelen. Der kan tilføjes flere nyttedatatyper over tid.

Værdi Beskrivelse
InlineBase64

Indbygget grundlinje 64.

Report

Object

Et rapportobjekt.

Name Type Beskrivelse
description

string

Elementbeskrivelsen.
displayName

string

Det viste elementnavn.
id

string

uuid

Element-id'et.
type

ItemType

Elementtypen.
workspaceId

string

uuid

Arbejdsområde-id'et.

ReportDefinition

Object

Rapportér objekt til offentlig definition. Se denne artikel for at få flere oplysninger om, hvordan du udformer en offentlig rapportdefinition.

Name Type Beskrivelse
format

string

Formatet af elementdefinitionen.
parts

ReportDefinitionPart[]

En liste over definitionsdele.

ReportDefinitionPart

Object

Objekt for rapportdefinitionsdel.

Name Type Beskrivelse
path

string

Stien til rapportdelen.
payload

string

Nyttedata for rapportdelen.
payloadType

PayloadType

Nyttedatatypen.