Del via


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
workspaceId
path True

string

uuid

Arbeidsområde-ID-en.

Brødtekst for forespørsel

Navn Obligatorisk Type Beskrivelse
definition True

ReportDefinition

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

Report

Opprettet

202 Accepted

Forespørsel godtatt, rapportklargjøring pågår.

Overskrifter

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

ErrorResponse

Vanlige feilkoder:

  • InvalidItemType – elementtypen er ugyldig.

  • ItemDisplayNameAlreadyInUse – visningsnavnet for elementet er allerede brukt.

  • CorruptedPayload – den angitte nyttelasten er skadet.

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
CreateReportRequest

Opprett nyttelast for rapportforespørsel.

ErrorRelatedResource

Objektet for feilrelaterte ressursdetaljer.

ErrorResponse

Feilsvaret.

ErrorResponseDetails

Feilsvardetaljene.

ItemType

Typen element. Flere elementtyper kan legges til over tid.

PayloadType

Typen nyttelast for definisjonsdelen. Flere nyttelasttyper kan legges til over tid.

Report

Et rapportobjekt.

ReportDefinition

Offentlig rapportdefinisjonsobjekt. Se denne artikkelen for mer informasjon om hvordan du oppretter en offentlig rapportdefinisjon.

ReportDefinitionPart

Delobjekt for rapportdefinisjon.

CreateReportRequest

Opprett nyttelast for rapportforespørsel.

Navn Type Beskrivelse
definition

ReportDefinition

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

ErrorResponseDetails[]

Liste over flere feildetaljer.

relatedResource

ErrorRelatedResource

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

ErrorRelatedResource

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

ItemType

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

ReportDefinitionPart[]

En liste over definisjonsdeler.

ReportDefinitionPart

Delobjekt for rapportdefinisjon.

Navn Type Beskrivelse
path

string

Rapportdelbanen.

payload

string

Nyttelasten for rapportdelen.

payloadType

PayloadType

Nyttelasttypen.