Del via

Items - Create Item

  • Reference
Tjeneste:
Core
API-version:
v1

Opretter et element i det angivne arbejdsområde.
Denne API understøttes for en række elementtyper. Find de understøttede elementtyper i Oversigt over elementstyring. Du kan bruge Get item definition API til at hente en elementdefinition.

Denne API understøtter LRO-handlinger (Long Running Operations).

Tilladelser

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

Påkrævede delegerede områder

For element-API'er skal du bruge disse områdetyper:

  • Standardområde: Item.ReadWrite.All
  • Bestemt område: itemType. ReadWrite.All (f.eks. Notebook.ReadWrite.All)

Du kan få flere oplysninger om områder i artiklen om områder.

Begrænsninger

  • Hvis du vil oprette et element, der ikke er PowerBI Fabric, skal arbejdsområdet være på en understøttet Fabric-kapacitet. Du kan få flere oplysninger under Microsoft Fabric-licenstyper.
  • Hvis du vil oprette et PowerBI-element, skal brugeren have den relevante licens. Du kan få flere oplysninger under Microsoft Fabric-licenstyper.
  • Når du opretter et element, skal du enten bruge creationPayload eller definition, men ikke bruge begge dele på samme tid.

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 Når elementtypen i opkaldet understøttes. Kontrollér den tilsvarende API for den elementtype, du ringer til, for at se, om dit opkald understøttes. Semantiske modeller understøttes f.eks.

Grænseflade

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

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
displayName True

string

Det viste elementnavn. Det viste navn skal følge navngivningsreglerne i henhold til elementtypen.
type True

ItemType

Elementtypen.
creationPayload

object

Et sæt egenskaber, der bruges til at oprette elementet. Siden Opret element af den relevante type angiver, om creationPayload understøttes, og viser elementets egenskaber. Brug creationPayload eller definition. Du kan ikke bruge begge dele på samme tid.
definition

ItemDefinition

Elementdefinitionen. Siden Opret element af den relevante type angiver, om definitionen understøttes, og angiver dens struktur. Brug definition eller creationPayload. Du kan ikke bruge begge dele på samme tid.
description

string

Elementbeskrivelsen. Maksimumlængden er 256 tegn.

Svar

Name Type Beskrivelse
201 Created

Item

Oprettet
202 Accepted

Anmodning accepteret, klargøring af elementer 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 an item example

Eksempelanmodning

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items

{
  "displayName": "Item 1",
  "type": "Lakehouse"
}

Eksempelsvar

Statuskode:
201 
{
  "displayName": "Item 1",
  "description": "",
  "type": "Lakehouse",
  "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
CreateItemRequest

Opret nyttedata for elementanmodning.
ErrorRelatedResource

Objektet med fejlrelaterede ressourceoplysninger.
ErrorResponse

Fejlsvaret.
ErrorResponseDetails

Oplysninger om fejlsvar.
Item

Et elementobjekt.
ItemDefinition

Et elementdefinitionsobjekt.
ItemDefinitionPart

Et elementdefinitionsdelobjekt.
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.

CreateItemRequest

Object

Opret nyttedata for elementanmodning.

Name Type Beskrivelse
creationPayload

object

Et sæt egenskaber, der bruges til at oprette elementet. Siden Opret element af den relevante type angiver, om creationPayload understøttes, og viser elementets egenskaber. Brug creationPayload eller definition. Du kan ikke bruge begge dele på samme tid.
definition

ItemDefinition

Elementdefinitionen. Siden Opret element af den relevante type angiver, om definitionen understøttes, og angiver dens struktur. Brug definition eller creationPayload. Du kan ikke bruge begge dele på samme tid.
description

string

Elementbeskrivelsen. Maksimumlængden er 256 tegn.
displayName

string

Det viste elementnavn. Det viste navn skal følge navngivningsreglerne i henhold til elementtypen.
type

ItemType

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.

Item

Object

Et elementobjekt.

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.

ItemDefinition

Object

Et elementdefinitionsobjekt.

Name Type Beskrivelse
format

string

Formatet af elementdefinitionen.
parts

ItemDefinitionPart[]

En liste over definitionsdele.

ItemDefinitionPart

Object

Et elementdefinitionsdelobjekt.

Name Type Beskrivelse
path

string

Stien til elementdelen.
payload

string

Nyttedata for elementdelen.
payloadType

PayloadType

Nyttedatatypen.

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.