Items - Create Item
Erstellt ein Element im angegebenen Arbeitsbereich.
Diese API wird für eine Reihe von Elementtypen unterstützt, finden Sie die unterstützten Elementtypen in Elementverwaltungsübersicht. Sie können Elementdefinitions-API zum Abrufen einer Elementdefinition verwenden.
Diese API unterstützt LRO-.
Erlaubnisse
Der Anrufer muss Mitwirkender oder höherer Arbeitsbereichsrolle haben.
Erforderliche delegierte Bereiche
Verwenden Sie für Element-APIs die folgenden Bereichstypen:
- Allgemeiner Bereich: Item.ReadWrite.All
- Bestimmter Bereich: itemType-. ReadWrite.All (z. B.: Notebook.ReadWrite.All)
weitere Informationen zu Bereichen finden Sie im Artikel Bereiche.
Begrenzungen
- Um ein Nicht-PowerBI Fabric-Element zu erstellen, muss sich der Arbeitsbereich auf einer unterstützten Fabric-Kapazität befindet. Weitere Informationen finden Sie unter Microsoft Fabric-Lizenztypen.
- Um ein PowerBI-Element zu erstellen, muss der Benutzer über die entsprechende Lizenz verfügen. Weitere Informationen finden Sie unter Microsoft Fabric-Lizenztypen.
- Verwenden Sie beim Erstellen eines Elements entweder
creationPayload
oderdefinition
, verwenden Sie jedoch nicht beide gleichzeitig.
Von Microsoft Entra unterstützte Identitäten
Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.
Identität | Unterstützen |
---|---|
Benutzer | Ja |
Dienstprinzipal und verwaltete Identitäten | Wenn der Elementtyp im Anruf unterstützt wird. Überprüfen Sie die entsprechende API für den elementtyp, den Sie aufrufen, um festzustellen, ob Ihr Aufruf unterstützt wird. So werden z. B. semantische Modelle unterstützt. |
Schnittstelle
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
workspace
|
path | True |
string uuid |
Die Arbeitsbereichs-ID. |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
displayName | True |
string |
Der Anzeigename des Elements. Der Anzeigename muss den Benennungsregeln entsprechend dem Elementtyp entsprechen. |
type | True |
Der Elementtyp. |
|
creationPayload |
object |
Eine Reihe von Eigenschaften, die zum Erstellen des Elements verwendet werden. Die Seite "Element erstellen" des relevanten Typs gibt an, ob |
|
definition |
Die Elementdefinition. Die Seite "Element erstellen" des relevanten Typs gibt an, ob die Definition unterstützt wird, und zeigt die Struktur an. Verwenden Sie |
||
description |
string |
Die Elementbeschreibung. Die maximale Länge beträgt 256 Zeichen. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
201 Created |
Erfolgreich erstellt |
|
202 Accepted |
Akzeptierte Anforderung, Bereitstellung von Elementen in Bearbeitung Header
|
|
Other Status Codes |
Häufige Fehlercodes:
|
Beispiele
Create an item example
Beispielanforderung
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items
{
"displayName": "Item 1",
"type": "Lakehouse"
}
Beispiel für eine Antwort
{
"displayName": "Item 1",
"description": "",
"type": "Lakehouse",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715"
}
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
Definitionen
Name | Beschreibung |
---|---|
Create |
Elementanforderungsnutzlast erstellen. |
Error |
Das Fehlerbezogene Ressourcendetails-Objekt. |
Error |
Die Fehlerantwort. |
Error |
Die Fehlerantwortdetails. |
Item |
Ein Elementobjekt. |
Item |
Ein Elementdefinitionsobjekt. |
Item |
Ein Elementdefinitionsteilobjekt. |
Item |
Der Typ des Elements. Zusätzliche Elementtypen können im Laufe der Zeit hinzugefügt werden. |
Payload |
Der Typ der Definitionsteilnutzlast. Zusätzliche Nutzlasttypen können im Laufe der Zeit hinzugefügt werden. |
CreateItemRequest
Elementanforderungsnutzlast erstellen.
Name | Typ | Beschreibung |
---|---|---|
creationPayload |
object |
Eine Reihe von Eigenschaften, die zum Erstellen des Elements verwendet werden. Die Seite "Element erstellen" des relevanten Typs gibt an, ob |
definition |
Die Elementdefinition. Die Seite "Element erstellen" des relevanten Typs gibt an, ob die Definition unterstützt wird, und zeigt die Struktur an. Verwenden Sie |
|
description |
string |
Die Elementbeschreibung. Die maximale Länge beträgt 256 Zeichen. |
displayName |
string |
Der Anzeigename des Elements. Der Anzeigename muss den Benennungsregeln entsprechend dem Elementtyp entsprechen. |
type |
Der Elementtyp. |
ErrorRelatedResource
Das Fehlerbezogene Ressourcendetails-Objekt.
Name | Typ | Beschreibung |
---|---|---|
resourceId |
string |
Die Ressourcen-ID, die an dem Fehler beteiligt ist. |
resourceType |
string |
Der Typ der Ressource, die an dem Fehler beteiligt ist. |
ErrorResponse
Die Fehlerantwort.
Name | Typ | Beschreibung |
---|---|---|
errorCode |
string |
Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht. |
message |
string |
Eine lesbare Darstellung des Fehlers. |
moreDetails |
Liste der zusätzlichen Fehlerdetails. |
|
relatedResource |
Die fehlerbezogenen Ressourcendetails. |
|
requestId |
string |
ID der Anforderung, die dem Fehler zugeordnet ist. |
ErrorResponseDetails
Die Fehlerantwortdetails.
Name | Typ | Beschreibung |
---|---|---|
errorCode |
string |
Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht. |
message |
string |
Eine lesbare Darstellung des Fehlers. |
relatedResource |
Die fehlerbezogenen Ressourcendetails. |
Item
Ein Elementobjekt.
Name | Typ | Beschreibung |
---|---|---|
description |
string |
Die Elementbeschreibung. |
displayName |
string |
Der Anzeigename des Elements. |
id |
string uuid |
Die Element-ID. |
type |
Der Elementtyp. |
|
workspaceId |
string uuid |
Die Arbeitsbereichs-ID. |
ItemDefinition
Ein Elementdefinitionsobjekt.
Name | Typ | Beschreibung |
---|---|---|
format |
string |
Das Format der Elementdefinition. |
parts |
Eine Liste der Definitionsteile. |
ItemDefinitionPart
Ein Elementdefinitionsteilobjekt.
Name | Typ | Beschreibung |
---|---|---|
path |
string |
Der Elementteilpfad. |
payload |
string |
Die Nutzlast des Elementteils. |
payloadType |
Der Nutzlasttyp. |
ItemType
Der Typ des Elements. Zusätzliche Elementtypen können im Laufe der Zeit hinzugefügt werden.
Wert | Beschreibung |
---|---|
Dashboard |
PowerBI-Dashboard. |
DataPipeline |
Eine Datenpipeline. |
Datamart |
PowerBI datamart. |
Environment |
Eine Umgebung. |
Eventhouse |
Ein Eventhouse. |
Eventstream |
Ein Ereignisstream. |
GraphQLApi |
Eine API für GraphQL-Element. |
KQLDashboard |
Ein KQL-Dashboard. |
KQLDatabase |
Eine KQL-Datenbank. |
KQLQueryset |
Ein KQL-Abfrageset. |
Lakehouse |
Ein Seehaus. |
MLExperiment |
Ein Machine Learning-Experiment. |
MLModel |
Ein Machine Learning-Modell. |
MirroredDatabase |
Eine gespiegelte Datenbank. |
MirroredWarehouse |
Ein gespiegeltes Lager. |
MountedDataFactory |
Eine MountedDataFactory. |
Notebook |
Ein Notizbuch. |
PaginatedReport |
PowerBI-Paginated-Bericht. |
Reflex |
Ein Reflex. |
Report |
PowerBI-Bericht. |
SQLDatabase |
Eine SQLDatabase. |
SQLEndpoint |
Ein SQL-Endpunkt. |
SemanticModel |
PowerBI-Semantikmodell. |
SparkJobDefinition |
Eine Sparkauftragsdefinition. |
Warehouse |
Ein Lagerhaus. |
PayloadType
Der Typ der Definitionsteilnutzlast. Zusätzliche Nutzlasttypen können im Laufe der Zeit hinzugefügt werden.
Wert | Beschreibung |
---|---|
InlineBase64 |
Inlinebasis 64. |