Items - Create Report
Oppretter en rapport i det angitte arbeidsområdet.
Denne API-en støtter langvarige operasjoner (LRO).
Denne API-en krever en definisjon.
Tillatelser
Innringeren må ha bidragsyter eller høyere arbeidsområderolle.
Nødvendige delegerte omfang
Report.ReadWrite.All eller Item.ReadWrite.All
Begrensninger
- Hvis du vil opprette et rapportelement, må brukeren ha riktig lisens. Hvis du vil ha mer informasjon, kan du se: Microsoft Fabric-lisenstyper.
Microsoft Entra-støttede identiteter
Denne API-en støtter Microsoft -identiteter oppført i denne delen.
Identitet | Støtte |
---|---|
Bruker | Ja |
tjenestekontohaver og administrerte identiteter | Ja |
Grensesnitt
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/reports
URI-parametere
Navn | I | Obligatorisk | Type | Beskrivelse |
---|---|---|---|---|
workspace
|
path | True |
string uuid |
Arbeidsområde-ID-en. |
Brødtekst for forespørsel
Navn | Obligatorisk | Type | Beskrivelse |
---|---|---|---|
definition | True |
Den offentlige definisjonen for rapporten. |
|
displayName | True |
string |
Visningsnavnet for rapporten. Visningsnavnet må følge navnereglene i henhold til elementtype. |
description |
string |
Rapportbeskrivelsen. Maksimal lengde er 256 tegn. |
Svar
Navn | Type | Beskrivelse |
---|---|---|
201 Created |
Opprettet |
|
202 Accepted |
Forespørsel godtatt, rapportklargjøring pågår. Overskrifter
|
|
Other Status Codes |
Vanlige feilkoder:
|
Eksempler
Create a report example
Eksempelforespørsel
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
{
"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
Definisjoner
Navn | Beskrivelse |
---|---|
Create |
Opprett nyttelast for rapportforespørsel. |
Error |
Objektet for feilrelaterte ressursdetaljer. |
Error |
Feilsvaret. |
Error |
Feilsvardetaljene. |
Item |
Typen element. Flere elementtyper kan legges til over tid. |
Payload |
Typen nyttelast for definisjonsdelen. Flere nyttelasttyper kan legges til over tid. |
Report |
Et rapportobjekt. |
Report |
Offentlig rapportdefinisjonsobjekt. Se denne artikkelen for mer informasjon om hvordan du oppretter en offentlig rapportdefinisjon. |
Report |
Delobjekt for rapportdefinisjon. |
CreateReportRequest
Opprett nyttelast for rapportforespørsel.
Navn | Type | Beskrivelse |
---|---|---|
definition |
Den offentlige definisjonen for rapporten. |
|
description |
string |
Rapportbeskrivelsen. Maksimal lengde er 256 tegn. |
displayName |
string |
Visningsnavnet for rapporten. Visningsnavnet må følge navnereglene i henhold til elementtype. |
ErrorRelatedResource
Objektet for feilrelaterte ressursdetaljer.
Navn | Type | Beskrivelse |
---|---|---|
resourceId |
string |
Ressurs-ID-en som er involvert i feilen. |
resourceType |
string |
Typen ressurs som er involvert i feilen. |
ErrorResponse
Feilsvaret.
Navn | Type | Beskrivelse |
---|---|---|
errorCode |
string |
En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne. |
message |
string |
En menneskelig lesbar representasjon av feilen. |
moreDetails |
Liste over flere feildetaljer. |
|
relatedResource |
Feilrelaterte ressursdetaljer. |
|
requestId |
string |
ID for forespørselen som er knyttet til feilen. |
ErrorResponseDetails
Feilsvardetaljene.
Navn | Type | Beskrivelse |
---|---|---|
errorCode |
string |
En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne. |
message |
string |
En menneskelig lesbar representasjon av feilen. |
relatedResource |
Feilrelaterte ressursdetaljer. |
ItemType
Typen element. Flere elementtyper kan legges til over tid.
Verdi | Beskrivelse |
---|---|
Dashboard |
PowerBI-instrumentbord. |
DataPipeline |
Et datasamlebånd. |
Datamart |
PowerBI-datamart. |
Environment |
Et miljø. |
Eventhouse |
Et arrangementshus. |
Eventstream |
En hendelsesstrøm. |
GraphQLApi |
En API for GraphQL-element. |
KQLDashboard |
Et KQL-instrumentbord. |
KQLDatabase |
En KQL-database. |
KQLQueryset |
Et KQL-spørringssett. |
Lakehouse |
Et innsjøhus. |
MLExperiment |
Et maskinlæringseksperiment. |
MLModel |
En maskinlæringsmodell. |
MirroredDatabase |
En speilvendt database. |
MirroredWarehouse |
Et speilvendt lager. |
MountedDataFactory |
En MountedDataFactory. |
Notebook |
En notatblokk. |
PaginatedReport |
Paginert powerbi-rapport. |
Reflex |
En refleks. |
Report |
PowerBI-rapport. |
SQLDatabase |
En SQLDatabase. |
SQLEndpoint |
Et SQL-endepunkt. |
SemanticModel |
Semantisk PowerBI-modell. |
SparkJobDefinition |
En spark-jobbdefinisjon. |
Warehouse |
Et lager. |
PayloadType
Typen nyttelast for definisjonsdelen. Flere nyttelasttyper kan legges til over tid.
Verdi | Beskrivelse |
---|---|
InlineBase64 |
Innebygd grunntall 64. |
Report
Et rapportobjekt.
Navn | Type | Beskrivelse |
---|---|---|
description |
string |
Elementbeskrivelsen. |
displayName |
string |
Visningsnavnet for elementet. |
id |
string uuid |
Element-ID-en. |
type |
Elementtypen. |
|
workspaceId |
string uuid |
Arbeidsområde-ID-en. |
ReportDefinition
Offentlig rapportdefinisjonsobjekt. Se denne artikkelen for mer informasjon om hvordan du oppretter en offentlig rapportdefinisjon.
Navn | Type | Beskrivelse |
---|---|---|
format |
string |
Formatet for elementdefinisjonen. |
parts |
En liste over definisjonsdeler. |
ReportDefinitionPart
Delobjekt for rapportdefinisjon.
Navn | Type | Beskrivelse |
---|---|---|
path |
string |
Rapportdelbanen. |
payload |
string |
Nyttelasten for rapportdelen. |
payloadType |
Nyttelasttypen. |