Jaa

Items - Create Report

  • Viite
Palvelu:
Report
Ohjelmointirajapinnan versio:
v1

Luo raportin määritettyyn työtilaan.
Tämä ohjelmointirajapinta tukee pitkäkestoisia toimintoja.

Tämä ohjelmointirajapinta edellyttää määritystä.

Käyttöoikeudet

Kutsujalla on oltava osallistujan tai suurempi työtilarooli.

Vaaditut delegoidut vaikutusalueet

Report.ReadWrite.All tai Item.ReadWrite.All

Rajoitukset

Microsoft Entran tukemat käyttäjätiedot

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft -käyttäjätietoja.

Identiteetti Tuki
Käyttäjä Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen Kyllä

Rajapinta

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

URI-parametrit

Nimi Kohteessa Pakollinen Tyyppi Description
workspaceId
 path True

string

uuid

Työtilan tunnus.

Pyynnön leipäteksti

Nimi Pakollinen Tyyppi Description
definition True

ReportDefinition

Raportin julkinen määritys.
displayName True

string

Raportin näyttönimi. Näyttönimen on noudatettava nimeämissääntöjä kohdetyypin mukaan.
description

string

Raportin kuvaus. Enimmäispituus on 256 merkkiä.

Vastaukset

Nimi Tyyppi Description
201 Created

Report

Luonti onnistui
202 Accepted

Pyyntö hyväksytty, raportin valmistelu on meneillään.

Otsikot

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

ErrorResponse

Yleiset virhekoodit:

  • InvalidItemType – Kohdetyyppi on virheellinen.

  • ItemDisplayNameAlreadyInUse – Kohteen näyttönimi on jo käytössä.

  • VioittunutPayload – Annetut tiedot ovat vioittuneet.

Esimerkit

Create a report example

Mallipyyntö

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

Mallivastaus

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

Määritelmät

Nimi Description
CreateReportRequest

Raporttipyyntöjen tietojen luominen.
ErrorRelatedResource

Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse

Virhevastaus.
ErrorResponseDetails

Virheen vastauksen tiedot.
ItemType

Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.
PayloadType

Määritelmäosan hyötykuorman tyyppi. Lisää hyötykuormitustyyppejä voidaan lisätä ajan kuluessa.
Report

Raporttiobjekti.
ReportDefinition

Raportin julkisen määrityksen objekti. Lisätietoja raportin julkisen määrityksen luomisesta saat tämän artikkelin.
ReportDefinitionPart

Raportin määritysosan objekti.

CreateReportRequest

Object

Raporttipyyntöjen tietojen luominen.

Nimi Tyyppi Description
definition

ReportDefinition

Raportin julkinen määritys.
description

string

Raportin kuvaus. Enimmäispituus on 256 merkkiä.
displayName

string

Raportin näyttönimi. Näyttönimen on noudatettava nimeämissääntöjä kohdetyypin mukaan.

ErrorRelatedResource

Object

Virheeseen liittyvä resurssitieto-objekti.

Nimi Tyyppi Description
resourceId

string

Virheestä liittyvä resurssitunnus.
resourceType

string

Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Object

Virhevastaus.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message

string

Ihmisen luettavissa oleva esitys virheestä.
moreDetails

ErrorResponseDetails[]

Luettelo virheiden lisätiedoista.
relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.
requestId

string

Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Object

Virheen vastauksen tiedot.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message

string

Ihmisen luettavissa oleva esitys virheestä.
relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.

ItemType

Luettelointi

Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.

Arvo Description
Dashboard

Power BI -koontinäyttö.
DataPipeline

Tietoputki.
Datamart

PowerBI -tietomarssi.
Environment

Ympäristö.
Eventhouse

Tapahtumatalo.
Eventstream

Tapahtumavirta.
GraphQLApi

Ohjelmointirajapinta GraphQL-kohteelle.
KQLDashboard

KQL-koontinäyttö.
KQLDatabase

KQL-tietokanta.
KQLQueryset

KQL-kyselyjoukko.
Lakehouse

Tämä on lakehouse.
MLExperiment

Koneoppimisen kokeilu.
MLModel

Koneoppimismalli.
MirroredDatabase

Peilattu tietokanta.
MirroredWarehouse

Peilattu varasto.
MountedDataFactory

A MountedDataFactory.
Notebook

Muistikirja.
PaginatedReport

PowerBI:n sivutettu raportti.
Reflex

Refleksi.
Report

PowerBI -raportti.
SQLDatabase

A SQLDatabase.
SQLEndpoint

SQL-päätepiste.
SemanticModel

PowerBI:n semanttinen malli.
SparkJobDefinition

Spark-työn määritelmä.
Warehouse

Varasto.

PayloadType

Luettelointi

Määritelmäosan hyötykuorman tyyppi. Lisää hyötykuormitustyyppejä voidaan lisätä ajan kuluessa.

Arvo Description
InlineBase64

Inline Base 64.

Report

Object

Raporttiobjekti.

Nimi Tyyppi Description
description

string

Kohteen kuvaus.
displayName

string

Kohteen näyttönimi.
id

string

uuid

Kohdetunnus.
type

ItemType

Kohdetyyppi.
workspaceId

string

uuid

Työtilan tunnus.

ReportDefinition

Object

Raportin julkisen määrityksen objekti. Lisätietoja raportin julkisen määrityksen luomisesta saat tämän artikkelin.

Nimi Tyyppi Description
format

string

Kohteen määrityksen muoto.
parts

ReportDefinitionPart[]

Luettelo määritysosista.

ReportDefinitionPart

Object

Raportin määritysosan objekti.

Nimi Tyyppi Description
path

string

Raporttiosan polku.
payload

string

Raportin osakuormitus.
payloadType

PayloadType

Hyötykuorman tyyppi.