Del via

Items - Create Item

  • Referanse
Tjeneste:
Core
API-versjon:
v1

Oppretter et element i det angitte arbeidsområdet.
Denne API-en støttes for en rekke elementtyper, og finner de støttede elementtypene i Oversikt over elementbehandling. Du kan bruke Hent elementdefinisjons-API-en for å få en elementdefinisjon.

Denne API-en støtter langvarige operasjoner (LRO).

Tillatelser

Innringeren må ha bidragsyter eller høyere arbeidsområderolle.

Nødvendige delegerte omfang

For element-API-er bruker du disse omfangstypene:

  • Generelt omfang: Item.ReadWrite.All
  • Bestemt omfang: itemType. ReadWrite.All (for eksempel: Notebook.ReadWrite.All)

Hvis du vil ha mer informasjon om omfang, kan du se omfangsartikkel.

Begrensninger

  • Hvis du vil opprette et ikke-PowerBI Fabric-element, må arbeidsområdet være på en støttet stoffkapasitet. Hvis du vil ha mer informasjon, kan du se Microsoft Fabric-lisenstyper.
  • Hvis du vil opprette et PowerBI-element, må brukeren ha riktig lisens. Hvis du vil ha mer informasjon, kan du se Microsoft Fabric-lisenstyper.
  • Når du oppretter et element, bruker du enten creationPayload eller definition, men ikke bruk begge samtidig.

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 Når elementtypen i samtalen støttes. Kontroller den tilsvarende API-en for elementtypen du ringer, for å se om samtalen støttes. Semantiske modeller støttes for eksempel.

Grensesnitt

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

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

string

Visningsnavnet for elementet. Visningsnavnet må følge navnereglene i henhold til elementtype.
type True

ItemType

Elementtypen.
creationPayload

object

Et sett med egenskaper som brukes til å opprette elementet. Siden Opprett element av den relevante typen angir om creationPayload støttes og viser egenskapene for elementet. Bruk creationPayload eller definition. Du kan ikke bruke begge samtidig.
definition

ItemDefinition

Elementdefinisjonen. Siden Opprett element av den relevante typen angir om definisjonen støttes og beskriver strukturen. Bruk definition eller creationPayload. Du kan ikke bruke begge samtidig.
description

string

Elementbeskrivelsen. Maksimal lengde er 256 tegn.

Svar

Navn Type Beskrivelse
201 Created

Item

Opprettet
202 Accepted

Forespørsel godtatt, klargjøring av element 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 an item example

Eksempelforespørsel

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

Definisjoner

Navn Beskrivelse
CreateItemRequest

Opprett nyttelast for vareforespørsel.
ErrorRelatedResource

Objektet for feilrelaterte ressursdetaljer.
ErrorResponse

Feilsvaret.
ErrorResponseDetails

Feilsvardetaljene.
Item

Et elementobjekt.
ItemDefinition

Et elementdefinisjonsobjekt.
ItemDefinitionPart

Et elementdefinisjonsdelobjekt.
ItemType

Typen element. Flere elementtyper kan legges til over tid.
PayloadType

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

CreateItemRequest

Object

Opprett nyttelast for vareforespørsel.

Navn Type Beskrivelse
creationPayload

object

Et sett med egenskaper som brukes til å opprette elementet. Siden Opprett element av den relevante typen angir om creationPayload støttes og viser egenskapene for elementet. Bruk creationPayload eller definition. Du kan ikke bruke begge samtidig.
definition

ItemDefinition

Elementdefinisjonen. Siden Opprett element av den relevante typen angir om definisjonen støttes og beskriver strukturen. Bruk definition eller creationPayload. Du kan ikke bruke begge samtidig.
description

string

Elementbeskrivelsen. Maksimal lengde er 256 tegn.
displayName

string

Visningsnavnet for elementet. Visningsnavnet må følge navnereglene i henhold til elementtype.
type

ItemType

Elementtypen.

ErrorRelatedResource

Object

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

Object

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

Object

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.

Item

Object

Et elementobjekt.

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.

ItemDefinition

Object

Et elementdefinisjonsobjekt.

Navn Type Beskrivelse
format

string

Formatet for elementdefinisjonen.
parts

ItemDefinitionPart[]

En liste over definisjonsdeler.

ItemDefinitionPart

Object

Et elementdefinisjonsdelobjekt.

Navn Type Beskrivelse
path

string

Elementdelbanen.
payload

string

Nyttelasten for elementdelen.
payloadType

PayloadType

Nyttelasttypen.

ItemType

Opplisting

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

Opplisting

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

Verdi Beskrivelse
InlineBase64

Innebygd grunntall 64.