Megosztás a következőn keresztül:

Items - Create Item

  • Referencia
Szolgáltatás:
Core
API-verzió:
v1

Létrehoz egy elemet a megadott munkaterületen.
Ez az API számos elemtípus esetében támogatott, a támogatott elemtípusokat az Elemkezelés áttekintésecímű cikkben találja. Az Elemdefiníció lekérése API- használatával lekérheti az elemdefiníciót.

Ez az API támogatja hosszú ideig futó műveleteket (LRO).

Engedélyek

A hívónak közreműködői vagy magasabb munkaterületi szerepkört kell tartalmaznia.

Kötelező delegált hatókörök

Elem API-k esetén használja az alábbi hatókörtípusokat:

  • Általános hatókör: Item.ReadWrite.All
  • Konkrét hatókör: itemType. ReadWrite.All (például: Notebook.ReadWrite.All)

további információ a hatókörökről: hatókörökről szóló cikk.

Korlátozások

  • Nem PowerBI Fabric-elem létrehozásához a munkaterületnek támogatott Háló-kapacitáson kell lennie. További információ: Microsoft Fabric-licenctípusok.
  • PowerBI-elem létrehozásához a felhasználónak rendelkeznie kell a megfelelő licenccel. További információ: Microsoft Fabric-licenctípusok.
  • Elem létrehozásakor használjon creationPayload vagy definition, de ne használja egyszerre mindkettőt.

Microsoft Entra által támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft identitásokat.

Azonosság Támogat
Felhasználó Igen
szolgáltatásnév és felügyelt identitások Ha a hívás elemtípusa támogatott. Ellenőrizze a megfelelő API-t a hívandó elemtípushoz, és ellenőrizze, hogy a hívás támogatott-e. A szemantikai modellek például támogatottak.

Interfész

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

URI-paraméterek

Name In Kötelező Típus Description
workspaceId
 path True

string (uuid)

A munkaterület azonosítója.

Kérelem törzse

Name Kötelező Típus Description
displayName True

string

Az elem megjelenítendő neve. A megjelenítendő névnek az elemtípusnak megfelelő elnevezési szabályokat kell követnie.
type True

ItemType

Az elem típusa.
creationPayload

object

Az elem létrehozásához használt tulajdonságok halmaza. A megfelelő típusú Elem létrehozása lap jelzi, hogy támogatott-e creationPayload, és felsorolja-e az elem tulajdonságait. creationPayload vagy definitionhasználata. Egyszerre nem használhatja mindkettőt.
definition

ItemDefinition

Az elemdefiníció. A Elem létrehozása lap a megfelelő típushoz jelzi, hogy a definíció támogatott-e, és részletezi-e a szerkezetét. definition vagy creationPayloadhasználata. Egyszerre nem használhatja mindkettőt.
description

string

Az elem leírása. A maximális hossz 256 karakter.
folderId

string (uuid)

A mappa azonosítója. Ha nincs megadva vagy null, a rendszer a munkaterülettel hozza létre az elemet mappaként.

Válaszok

Name Típus Description
201 Created

Item

Sikeresen létrehozva
202 Accepted

A kérelem elfogadva, az elem kiépítése folyamatban van

Fejlécek

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

ErrorResponse

Gyakori hibakódok:

  • InvalidItemType – Az elem típusa érvénytelen.

  • ItemDisplayNameAlreadyInUse – Az elem megjelenítendő neve már használatban van.

  • CorruptedPayload – A megadott hasznos adatok sérültek.

  • FolderNotFound – Nem található a kért mappa.

  • WorkspaceItemsLimitExceeded – A munkaterület elemkorlátja túllépve.

Példák

Create an item example
Create an item in folder example

Create an item example

Mintakérelem

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

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

Mintaválasz

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

Mintakérelem

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"
}

Mintaválasz

Állapotkód:
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"
}
Állapotkód:
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

Definíciók

Name Description
CreateItemRequest

Elemkérés hasznos adatainak létrehozása.
ErrorRelatedResource

A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse

A hibaválasz.
ErrorResponseDetails

A hibaválasz részletei.
Item

Elemobjektum.
ItemDefinition

Elemdefiníciós objektum.
ItemDefinitionPart

Elemdefiníciós részobjektum.
ItemType

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.
PayloadType

A definíciórész hasznos adattípusa. Idővel további hasznos adattípusok is hozzáadhatók.

CreateItemRequest

Objektum

Elemkérés hasznos adatainak létrehozása.

Name Típus Description
creationPayload

object

Az elem létrehozásához használt tulajdonságok halmaza. A megfelelő típusú Elem létrehozása lap jelzi, hogy támogatott-e creationPayload, és felsorolja-e az elem tulajdonságait. creationPayload vagy definitionhasználata. Egyszerre nem használhatja mindkettőt.
definition

ItemDefinition

Az elemdefiníció. A Elem létrehozása lap a megfelelő típushoz jelzi, hogy a definíció támogatott-e, és részletezi-e a szerkezetét. definition vagy creationPayloadhasználata. Egyszerre nem használhatja mindkettőt.
description

string

Az elem leírása. A maximális hossz 256 karakter.
displayName

string

Az elem megjelenítendő neve. A megjelenítendő névnek az elemtípusnak megfelelő elnevezési szabályokat kell követnie.
folderId

string (uuid)

A mappa azonosítója. Ha nincs megadva vagy null, a rendszer a munkaterülettel hozza létre az elemet mappaként.
type

ItemType

Az elem típusa.

ErrorRelatedResource

Objektum

A hibával kapcsolatos erőforrás-részletek objektum.

Name Típus Description
resourceId

string

A hibában érintett erőforrás-azonosító.
resourceType

string

A hibában érintett erőforrás típusa.

ErrorResponse

Objektum

A hibaválasz.

Name Típus Description
errorCode

string

Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message

string

A hiba emberi olvasható ábrázolása.
moreDetails

ErrorResponseDetails[]

További hibaadatok listája.
relatedResource

ErrorRelatedResource

A hibával kapcsolatos erőforrásadatok.
requestId

string

A hibához társított kérés azonosítója.

ErrorResponseDetails

Objektum

A hibaválasz részletei.

Name Típus Description
errorCode

string

Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message

string

A hiba emberi olvasható ábrázolása.
relatedResource

ErrorRelatedResource

A hibával kapcsolatos erőforrásadatok.

Item

Objektum

Elemobjektum.

Name Típus Description
description

string

Az elem leírása.
displayName

string

Az elem megjelenítendő neve.
folderId

string (uuid)

A mappa azonosítója.
id

string (uuid)

Az elem azonosítója.
type

ItemType

Az elem típusa.
workspaceId

string (uuid)

A munkaterület azonosítója.

ItemDefinition

Objektum

Elemdefiníciós objektum.

Name Típus Description
format

string

Az elemdefiníció formátuma.
parts

ItemDefinitionPart[]

Definíciórészek listája.

ItemDefinitionPart

Objektum

Elemdefiníciós részobjektum.

Name Típus Description
path

string

Az elemrész elérési útja.
payload

string

Az elemrész hasznos adatai.
payloadType

PayloadType

A hasznos adat típusa.

ItemType

Enumerálás

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.

Érték Description
CopyJob

Másolási feladat.
Dashboard

PowerBI-irányítópult.
DataPipeline

Egy adatfolyam.
Datamart

PowerBI datamart.
Environment

Egy környezet.
Eventhouse

Egy rendezvényház.
Eventstream

Eseménystream.
GraphQLApi

Api a GraphQL-elemhez.
KQLDashboard

KQL-irányítópult.
KQLDatabase

KQL-adatbázis.
KQLQueryset

KQL-lekérdezéskészlet.
Lakehouse

Egy tóház.
MLExperiment

Gépi tanulási kísérlet.
MLModel

Gépi tanulási modell.
MirroredDatabase

Tükrözött adatbázis.
MirroredWarehouse

Egy tükrözött raktár.
MountedDataFactory

A MountedDataFactory.
Notebook

Egy jegyzetfüzet.
PaginatedReport

Többoldalas PowerBI-jelentés.
Reflex

Egy reflex.
Report

PowerBI-jelentés.
SQLDatabase

A SQLDatabase.
SQLEndpoint

EGY SQL-végpont.
SemanticModel

PowerBI szemantikai modell.
SparkJobDefinition

Spark-feladat definíciója.
VariableLibrary

Egy VariableLibrary.
Warehouse

Egy raktár.

PayloadType

Enumerálás

A definíciórész hasznos adattípusa. Idővel további hasznos adattípusok is hozzáadhatók.

Érték Description
InlineBase64

Beágyazott 64-es alap.