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.

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

Példák

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

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.
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.
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
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.
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.