Items - Create Item

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 en bidragyderarbejdsområderolle.

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.
folderId		string (uuid)	Mappe-id'et. Hvis det ikke er angivet eller null, oprettes elementet med arbejdsområdet som mappe.

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. FolderNotFound - Den ønskede mappe blev ikke fundet. WorkspaceItemsLimitExceeded – Grænsen for arbejdsområdeelement er overskredet.

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.
FolderNotFound - Den ønskede mappe blev ikke fundet.
WorkspaceItemsLimitExceeded – Grænsen for arbejdsområdeelement er overskredet.

Eksempler

Create an item example

Create an item in folder example

Create an item example

Eksempelanmodning

HTTP

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

Create an item in folder example

Eksempelanmodning

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/items

{
  "displayName": "Item 1",
  "type": "Lakehouse",
  "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc"
}

Eksempelsvar

Statuskode:: 201

{
  "displayName": "Item 1",
  "description": "",
  "type": "Lakehouse",
  "folderId": "bbbbbbbb-1111-2222-3333-cccccccccccc",
  "workspaceId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "id": "cccccccc-2222-3333-4444-dddddddddddd"
}

Statuskode:: 202

Location: https://api.fabric.microsoft.com/v1/operations/0000aaaa-11bb-cccc-dd22-eeeeee333333
x-ms-operation-id: 0000aaaa-11bb-cccc-dd22-eeeeee333333
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.
ItemTag	Repræsenterer et mærke, der er anvendt på et element.
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

Objekt

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.
folderId	string (uuid)	Mappe-id'et. Hvis det ikke er angivet eller null, oprettes elementet med arbejdsområdet som mappe.
type	ItemType	Elementtypen.

ErrorRelatedResource

Objekt

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

Objekt

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

Objekt

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

Objekt

Et elementobjekt.

Name	Type	Beskrivelse
description	string	Elementbeskrivelsen.
displayName	string	Det viste elementnavn.
folderId	string (uuid)	Mappe-id'et.
id	string (uuid)	Element-id'et.
tags	ItemTag[]	Liste over anvendte mærker.
type	ItemType	Elementtypen.
workspaceId	string (uuid)	Arbejdsområde-id'et.

ItemDefinition

Objekt

Et elementdefinitionsobjekt.

Name	Type	Beskrivelse
format	string	Formatet af elementdefinitionen.
parts	ItemDefinitionPart[]	En liste over definitionsdele.

ItemDefinitionPart

Objekt

Et elementdefinitionsdelobjekt.

Name	Type	Beskrivelse
path	string	Stien til elementdelen.
payload	string	Nyttedata for elementdelen.
payloadType	PayloadType	Nyttedatatypen.

ItemTag

Objekt

Repræsenterer et mærke, der er anvendt på et element.

Name	Type	Beskrivelse
displayName	string	Navnet på mærket.
id	string (uuid)	Tag-id'et.

ItemType

Optælling

Elementets type. Der kan tilføjes flere elementtyper over tid.

Værdi	Beskrivelse
Dashboard	PowerBI-dashboard.
Report	PowerBI-rapport.
SemanticModel	Semantisk PowerBI-model.
PaginatedReport	Sideinddelt PowerBI-rapport.
Datamart	PowerBI-datamart.
Lakehouse	Et søhus.
Eventhouse	Et eventhouse.
Environment	Et miljø.
KQLDatabase	En KQL-database.
KQLQueryset	Et KQL-forespørgselssæt.
KQLDashboard	Et KQL-dashboard.
DataPipeline	En datapipeline.
Notebook	En notesbog.
SparkJobDefinition	En spark jobdefinition.
MLExperiment	Et maskinel indlæringseksperiment.
MLModel	En model til maskinel indlæring.
Warehouse	Et lager.
Eventstream	En hændelsesstream.
SQLEndpoint	Et SQL-slutpunkt.
MirroredWarehouse	Et spejlvendt lager.
MirroredDatabase	En spejlet database.
Reflex	En refleks.
GraphQLApi	En API til GraphQL-element.
MountedDataFactory	En MountedDataFactory.
SQLDatabase	En SQLDatabase.
CopyJob	Et kopijob.
VariableLibrary	En VariabelLibrary.
Dataflow	Et dataflow.
ApacheAirflowJob	En ApacheAirflowJob.
WarehouseSnapshot	Et lagersnapshot.
DigitalTwinBuilder	En DigitalTwinBuilder.
DigitalTwinBuilderFlow	Et Digital Twin Builder-flow.
MirroredAzureDatabricksCatalog	Et spejlet Azure Databricks-katalog.
Map	Et kort.
AnomalyDetector	En uregelmæssighedsregistrering.
UserDataFunction	En brugerdatafunktion.
GraphModel	En GraphModel.
GraphQuerySet	Et Graph QuerySet.
SnowflakeDatabase	En Snowflake-database til lagring af Iceberg-tabeller, der er oprettet fra Snowflake-konto.
OperationsAgent	En OperationsAgent.
CosmosDBDatabase	En Cosmos DB-database.
Ontology	En ontologi.
EventSchemaSet	Et EventSchemaSet.

PayloadType

Optælling

Typen af nyttedata for definitionsdelen. Der kan tilføjes flere nyttedatatyper over tid.

Værdi	Beskrivelse
InlineBase64	Indbygget grundlinje 64.

Del via

Items - Create Item

Tilladelser

Påkrævede delegerede områder

Begrænsninger

Microsoft Entra-understøttede identiteter

Grænseflade

URI-parametre

Brødtekst for anmodning

Svar

Eksempler

Create an item example

Eksempelanmodning

Eksempelsvar

Create an item in folder example

Eksempelanmodning

Eksempelsvar

Definitioner

CreateItemRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

Item

ItemDefinition

ItemDefinitionPart

ItemTag

ItemType

PayloadType