Items - Create Item

Service:

Core

API-versie:

v1

Hiermee maakt u een item in de opgegeven werkruimte.
Deze API wordt ondersteund voor een aantal itemtypen, zoek de ondersteunde itemtypen in Overzicht van itembeheer. U kunt itemdefinitie-API ophalen gebruiken om een itemdefinitie op te halen.

Deze API ondersteunt langlopende bewerkingen (LRO).

Machtigingen

De aanroeper moet inzender hebben of een hogere werkruimterol.

Vereiste gedelegeerde bereiken

Voor item-API's worden deze bereiktypen gebruikt:

• Algemeen bereik: Item.ReadWrite.All
• Specifiek bereik: itemType. ReadWrite.All (bijvoorbeeld: Notebook.ReadWrite.All)

Zie het artikel bereikenvoor meer informatie over bereiken.

Beperkingen

• Als u een niet-PowerBI Fabric-item wilt maken, moet de werkruimte zich in een ondersteunde infrastructuurcapaciteit bevinden. Zie Microsoft Fabric-licentietypenvoor meer informatie.
• Als u een PowerBI-item wilt maken, moet de gebruiker over de juiste licentie beschikken. Zie Microsoft Fabric-licentietypenvoor meer informatie.
• Wanneer u een item maakt, gebruikt u creationPayload of definition, maar gebruikt u beide niet tegelijkertijd.

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft -identiteiten vermeld in deze sectie.

Identiteit	Steunen
Gebruiker	Ja
service-principal en beheerde identiteiten	Wanneer het itemtype in de aanroep wordt ondersteund. Controleer de bijbehorende API voor het itemtype dat u aanroept om te zien of uw aanroep wordt ondersteund. Semantische modellen worden bijvoorbeeld ondersteund.

Interface

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

URI-parameters

Name	In	Vereist	Type	Description
workspaceId	path	True	string uuid	De werkruimte-id.

Aanvraagbody

Name	Vereist	Type	Description
displayName	True	string	De weergavenaam van het item. De weergavenaam moet de naamgevingsregels volgen op basis van het itemtype.
type	True	ItemType	Het itemtype.
creationPayload		object	Een set eigenschappen die worden gebruikt om het item te maken. De Pagina Item maken van het relevante type geeft aan of creationPayload wordt ondersteund en vermeldt de eigenschappen van het item. Gebruik creationPayload of definition. U kunt beide niet tegelijk gebruiken.
definition		ItemDefinition	De itemdefinitie. De Pagina Item maken van het relevante type geeft aan of de definitie wordt ondersteund en de structuur ervan wordt beschreven. Gebruik definition of creationPayload. U kunt beide niet tegelijk gebruiken.
description		string	De beschrijving van het item. De maximale lengte is 256 tekens.

Antwoorden

Name	Type	Description
201 Created	Item	Gemaakt
202 Accepted		Geaccepteerde aanvraag, iteminrichting wordt uitgevoerd Kopteksten Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Veelvoorkomende foutcodes: InvalidItemType - Itemtype is ongeldig. ItemDisplayNameAlreadyInUse - Weergavenaam van item wordt al gebruikt. CorruptedPayload - De opgegeven nettolading is beschadigd

Voorbeelden

Create an item example

Voorbeeldaanvraag

HTTP

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

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

Voorbeeldrespons

Statuscode:

201

{
  "displayName": "Item 1",
  "description": "",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Statuscode:

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

Definities

Name	Description
CreateItemRequest	Nettolading voor itemaanvragen maken.
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	Het foutbericht.
ErrorResponseDetails	De details van het foutbericht.
Item	Een itemobject.
ItemDefinition	Een itemdefinitieobject.
ItemDefinitionPart	Een itemdefinitieonderdeelobject.
ItemType	Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.
PayloadType	Het type nettolading van het definitieonderdeel. Er kunnen in de loop van de tijd extra typen nettoladingen worden toegevoegd.

CreateItemRequest

Object

Nettolading voor itemaanvragen maken.

Name	Type	Description
creationPayload	object	Een set eigenschappen die worden gebruikt om het item te maken. De Pagina Item maken van het relevante type geeft aan of creationPayload wordt ondersteund en vermeldt de eigenschappen van het item. Gebruik creationPayload of definition. U kunt beide niet tegelijk gebruiken.
definition	ItemDefinition	De itemdefinitie. De Pagina Item maken van het relevante type geeft aan of de definitie wordt ondersteund en de structuur ervan wordt beschreven. Gebruik definition of creationPayload. U kunt beide niet tegelijk gebruiken.
description	string	De beschrijving van het item. De maximale lengte is 256 tekens.
displayName	string	De weergavenaam van het item. De weergavenaam moet de naamgevingsregels volgen op basis van het itemtype.
type	ItemType	Het itemtype.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name	Type	Description
resourceId	string	De resource-id die betrokken is bij de fout.
resourceType	string	Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
moreDetails	ErrorResponseDetails[]	Lijst met aanvullende foutdetails.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.
requestId	string	Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.

Item

Object

Een itemobject.

Name	Type	Description
description	string	De beschrijving van het item.
displayName	string	De weergavenaam van het item.
id	string uuid	De item-id.
type	ItemType	Het itemtype.
workspaceId	string uuid	De werkruimte-id.

ItemDefinition

Object

Een itemdefinitieobject.

Name	Type	Description
format	string	De indeling van de itemdefinitie.
parts	ItemDefinitionPart[]	Een lijst met definitieonderdelen.

ItemDefinitionPart

Object

Een itemdefinitieonderdeelobject.

Name	Type	Description
path	string	Het pad van het itemonderdeel.
payload	string	De nettolading van het itemonderdeel.
payloadType	PayloadType	Het nettoladingstype.

ItemType

Inventarisatie

Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.

Waarde	Description
Dashboard	PowerBI-dashboard.
DataPipeline	Een gegevenspijplijn.
Datamart	PowerBI-datamart.
Environment	Een omgeving.
Eventhouse	Een eventhouse.
Eventstream	Een eventstream.
GraphQLApi	Een API voor GraphQL-item.
KQLDashboard	Een KQL-dashboard.
KQLDatabase	Een KQL-database.
KQLQueryset	Een KQL-queryset.
Lakehouse	Een lakehouse.
MLExperiment	Een machine learning-experiment.
MLModel	Een machine learning-model.
MirroredDatabase	Een gespiegelde database.
MirroredWarehouse	Een gespiegeld magazijn.
MountedDataFactory	Een MountedDataFactory.
Notebook	Een notitieblok.
PaginatedReport	Gepagineerd Power BI-rapport.
Reflex	Een reflex.
Report	PowerBI-rapport.
SQLDatabase	Een SQLDatabase.
SQLEndpoint	Een SQL-eindpunt.
SemanticModel	Semantisch Power BI-model.
SparkJobDefinition	Een Spark-taakdefinitie.
Warehouse	Een magazijn.

PayloadType

Inventarisatie

Het type nettolading van het definitieonderdeel. Er kunnen in de loop van de tijd extra typen nettoladingen worden toegevoegd.

Waarde	Description
InlineBase64	Inline base 64.