Dela via

Items - Create Item

  • Referens
Tjänst:
Core
API-version:
v1

Skapar ett objekt på den angivna arbetsytan.
Det här API:et stöds för ett antal objekttyper och hittar de objekttyper som stöds i Översikt över objekthantering. Du kan använda Api för att hämta objektdefinition för att hämta en objektdefinition.

Det här API:et stöder tidskrävande åtgärder (LRO).

Behörigheter

Anroparen måste ha deltagare eller högre arbetsyteroll.

Obligatoriska delegerade omfång

För objekt-API:er använder du följande omfångstyper:

  • Allmänt omfång: Item.ReadWrite.All
  • Specifikt omfång: itemType. ReadWrite.All (till exempel: Notebook.ReadWrite.All)

Mer information om omfång finns i artikeln om omfång.

Begränsningar

  • Om du vill skapa ett icke-PowerBI Fabric-objekt måste arbetsytan finnas på en infrastrukturresurskapacitet som stöds. Mer information finns i Microsoft Fabric-licenstyper.
  • Om du vill skapa ett PowerBI-objekt måste användaren ha rätt licens. Mer information finns i Microsoft Fabric-licenstyper.
  • När du skapar ett objekt använder du antingen creationPayload eller definition, men använd inte båda samtidigt.

Identiteter som stöds av Microsoft Entra

Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.

Identitet Stöd
Användare Ja
Tjänstens huvudnamn och hanterade identiteter När objekttypen i anropet stöds. Kontrollera motsvarande API för den objekttyp som du anropar för att se om ditt anrop stöds. Semantiska modeller stöds till exempel.

Gränssnitt

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

URI-parametrar

Name I Obligatorisk Typ Description
workspaceId
 path True

string

uuid

Arbetsytans ID.

Begärandetext

Name Obligatorisk Typ Description
displayName True

string

Objektets visningsnamn. Visningsnamnet måste följa namngivningsreglerna efter objekttyp.
type True

ItemType

Objekttypen.
creationPayload

object

En uppsättning egenskaper som används för att skapa objektet. Sidan Skapa objekt av relevant typ anger om creationPayload stöds och listar objektets egenskaper. Använd creationPayload eller definition. Du kan inte använda båda samtidigt.
definition

ItemDefinition

Objektdefinitionen. Sidan Skapa objekt av relevant typ anger om definitionen stöds och beskriver dess struktur. Använd definition eller creationPayload. Du kan inte använda båda samtidigt.
description

string

Objektbeskrivningen. Maximal längd är 256 tecken.

Svar

Name Typ Description
201 Created

Item

Har skapats
202 Accepted

Begäran accepterad, objektetablering pågår

Sidhuvuden

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

ErrorResponse

Vanliga felkoder:

  • InvalidItemType – Objekttypen är ogiltig.

  • ItemDisplayNameAlreadyInUse – Objektets visningsnamn används redan.

  • CorruptedPayload – den angivna nyttolasten är skadad

Exempel

Create an item example

Exempelbegäran

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

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

Exempelsvar

Statuskod:
201 
{
  "displayName": "Item 1",
  "description": "",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Statuskod:
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 Description
CreateItemRequest

Skapa nyttolast för objektbegäran.
ErrorRelatedResource

Det felrelaterade resursinformationsobjektet.
ErrorResponse

Felsvaret.
ErrorResponseDetails

Information om felsvar.
Item

Ett objektobjekt.
ItemDefinition

Ett objektdefinitionsobjekt.
ItemDefinitionPart

Ett objektdefinitionsdelsobjekt.
ItemType

Typ av objekt. Ytterligare objekttyper kan läggas till över tid.
PayloadType

Typ av definitionsdelens nyttolast. Ytterligare nyttolasttyper kan läggas till över tid.

CreateItemRequest

Objekt

Skapa nyttolast för objektbegäran.

Name Typ Description
creationPayload

object

En uppsättning egenskaper som används för att skapa objektet. Sidan Skapa objekt av relevant typ anger om creationPayload stöds och listar objektets egenskaper. Använd creationPayload eller definition. Du kan inte använda båda samtidigt.
definition

ItemDefinition

Objektdefinitionen. Sidan Skapa objekt av relevant typ anger om definitionen stöds och beskriver dess struktur. Använd definition eller creationPayload. Du kan inte använda båda samtidigt.
description

string

Objektbeskrivningen. Maximal längd är 256 tecken.
displayName

string

Objektets visningsnamn. Visningsnamnet måste följa namngivningsreglerna efter objekttyp.
type

ItemType

Objekttypen.

ErrorRelatedResource

Objekt

Det felrelaterade resursinformationsobjektet.

Name Typ Description
resourceId

string

Det resurs-ID som ingår i felet.
resourceType

string

Typen av resurs som är inblandad i felet.

ErrorResponse

Objekt

Felsvaret.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message

string

En mänsklig läsbar representation av felet.
moreDetails

ErrorResponseDetails[]

Lista över ytterligare felinformation.
relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.
requestId

string

ID för den begäran som är associerad med felet.

ErrorResponseDetails

Objekt

Information om felsvar.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message

string

En mänsklig läsbar representation av felet.
relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.

Item

Objekt

Ett objektobjekt.

Name Typ Description
description

string

Objektbeskrivningen.
displayName

string

Objektets visningsnamn.
id

string

uuid

Objekt-ID:t.
type

ItemType

Objekttypen.
workspaceId

string

uuid

Arbetsytans ID.

ItemDefinition

Objekt

Ett objektdefinitionsobjekt.

Name Typ Description
format

string

Formatet för objektdefinitionen.
parts

ItemDefinitionPart[]

En lista över definitionsdelar.

ItemDefinitionPart

Objekt

Ett objektdefinitionsdelsobjekt.

Name Typ Description
path

string

Objektdelssökvägen.
payload

string

Nyttolasten för artikeldelen.
payloadType

PayloadType

Nyttolasttypen.

ItemType

Uppräkning

Typ av objekt. Ytterligare objekttyper kan läggas till över tid.

Värde Description
Dashboard

PowerBI-instrumentpanel.
DataPipeline

En datapipeline.
Datamart

PowerBI-datamart.
Environment

En miljö.
Eventhouse

Ett eventhouse.
Eventstream

En händelseström.
GraphQLApi

Ett API för GraphQL-objekt.
KQLDashboard

En KQL-instrumentpanel.
KQLDatabase

En KQL-databas.
KQLQueryset

En KQL-frågeuppsättning.
Lakehouse

Ett sjöhus.
MLExperiment

Ett maskininlärningsexperiment.
MLModel

En maskininlärningsmodell.
MirroredDatabase

En speglad databas.
MirroredWarehouse

Ett speglat lager.
MountedDataFactory

En MountedDataFactory.
Notebook

En notebook-fil.
PaginatedReport

Sidnumrerad PowerBI-rapport.
Reflex

En reflex.
Report

PowerBI-rapport.
SQLDatabase

En SQLDatabase.
SQLEndpoint

En SQL-slutpunkt.
SemanticModel

PowerBI-semantisk modell.
SparkJobDefinition

En definition för Spark-jobb.
Warehouse

Ett lager.

PayloadType

Uppräkning

Typ av definitionsdelens nyttolast. Ytterligare nyttolasttyper kan läggas till över tid.

Värde Description
InlineBase64

Infogad bas 64.