Items - Update Item
Aktualisiert die Eigenschaften des angegebenen Elements.
Diese API wird für eine Reihe von Elementtypen unterstützt, finden Sie die unterstützten Elementtypen und Informationen zu ihrer Definitionsstruktur in Übersicht über die Elementverwaltung.
Erlaubnisse
Der Anrufer muss Mitwirkenden oder höherer Rolle im Arbeitsbereich 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.
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
PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
item
|
path | True |
string uuid |
Die Element-ID. |
workspace
|
path | True |
string uuid |
Die Arbeitsbereichs-ID. |
Anforderungstext
Name | Typ | Beschreibung |
---|---|---|
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. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Die Anforderung wurde erfolgreich abgeschlossen. |
|
Other Status Codes |
Häufige Fehlercodes:
|
Beispiele
Update an item example
Beispielanforderung
PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715
{
"displayName": "Item's New name",
"description": "Item's New description"
}
Beispiel für eine Antwort
{
"displayName": "Item's New name",
"description": "Item's New description",
"type": "Lakehouse",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Definitionen
Name | Beschreibung |
---|---|
Error |
Das Fehlerbezogene Ressourcendetails-Objekt. |
Error |
Die Fehlerantwort. |
Error |
Die Fehlerantwortdetails. |
Item |
Ein Elementobjekt. |
Item |
Der Typ des Elements. Zusätzliche Elementtypen können im Laufe der Zeit hinzugefügt werden. |
Update |
Elementanforderung aktualisieren. |
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. |
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. |
UpdateItemRequest
Elementanforderung aktualisieren.
Name | Typ | Beschreibung |
---|---|---|
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. |