Items - Update Item

Service:

Core

API-versie:

v1

Hiermee worden de eigenschappen van het opgegeven item bijgewerkt.
Deze API wordt ondersteund voor een aantal itemtypen, zoek de ondersteunde itemtypen en informatie over de definitiestructuur in Overzicht van itembeheer.

Machtigingen

De aanroeper moet lees- en schrijfmachtigingen voor het item hebben.

Vereiste gedelegeerde bereiken

Voor item-API's worden deze bereiktypen gebruikt:

• Algemeen bereik: Item.ReadWrite.All
• Specifiek bereik: itemType. ReadWrite.All (bijvoorbeeld: Notebook.ReadWrite.All)

Zie voor meer informatie over bereiken: artikel bereiken.

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft -identiteiten vermeld in deze sectie.

Identiteit	Steunen
Gebruiker	Ja
service-principal en beheerde identiteiten	Wanneer het itemtype in de aanroep wordt ondersteund. Controleer de bijbehorende API voor het itemtype dat u aanroept om te zien of uw aanroep wordt ondersteund. Semantische modellen worden bijvoorbeeld ondersteund.

gebruikersinterface

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

URI-parameters

Name	In	Vereist	Type	Description
itemId	path	True	string (uuid)	De item-id.
workspaceId	path	True	string (uuid)	De werkruimte-id.

Aanvraagbody

Name	Type	Description
description	string	De beschrijving van het item. De maximale lengte is 256 tekens.
displayName	string	De weergavenaam van het item. De weergavenaam moet de naamgevingsregels volgen op basis van het itemtype.

Antwoorden

Name	Type	Description
200 OK	Item	De aanvraag is voltooid.
Other Status Codes	ErrorResponse	Veelvoorkomende foutcodes: ItemNotFound : het aangevraagde item is niet gevonden. InvalidRequest - Ongeldige updateaanvraag.

Voorbeelden

Update an item example

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

Statuscode:

200

{
  "displayName": "Item's New name",
  "description": "Item's New description",
  "type": "Lakehouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

Definities

Name	Description
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	Het foutbericht.
ErrorResponseDetails	De details van het foutbericht.
Item	Een itemobject.
ItemTag	Vertegenwoordigt een tag die is toegepast op een item.
ItemType	Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.
UpdateItemRequest	Itemaanvraag bijwerken.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name	Type	Description
resourceId	string	De resource-id die betrokken is bij de fout.
resourceType	string	Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
moreDetails	ErrorResponseDetails[]	Lijst met aanvullende foutdetails.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.
requestId	string	Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.

Item

Object

Een itemobject.

Name	Type	Description
description	string	De beschrijving van het item.
displayName	string	De weergavenaam van het item.
folderId	string (uuid)	De map-id.
id	string (uuid)	De item-id.
tags	ItemTag[]	Lijst met toegepaste tags.
type	ItemType	Het itemtype.
workspaceId	string (uuid)	De werkruimte-id.

ItemTag

Object

Vertegenwoordigt een tag die is toegepast op een item.

Name	Type	Description
displayName	string	De naam van de tag.
id	string (uuid)	De tag-id.

ItemType

Opsomming

Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.

Waarde	Description
Dashboard	PowerBI-dashboard.
Report	PowerBI-rapport.
SemanticModel	Semantisch Power BI-model.
PaginatedReport	Gepagineerd Power BI-rapport.
Datamart	PowerBI-datamart.
Lakehouse	Een lakehouse.
Eventhouse	Een eventhouse.
Environment	Een omgeving.
KQLDatabase	Een KQL-database.
KQLQueryset	Een KQL-queryset.
KQLDashboard	Een KQL-dashboard.
DataPipeline	Een gegevenspijplijn.
Notebook	Een notitieblok.
SparkJobDefinition	Een Spark-taakdefinitie.
MLExperiment	Een machine learning-experiment.
MLModel	Een machine learning-model.
Warehouse	Een magazijn.
Eventstream	Een eventstream.
SQLEndpoint	Een SQL-eindpunt.
MirroredWarehouse	Een gespiegeld magazijn.
MirroredDatabase	Een gespiegelde database.
Reflex	Een reflex.
GraphQLApi	Een API voor GraphQL-item.
MountedDataFactory	Een MountedDataFactory.
SQLDatabase	Een SQLDatabase.
CopyJob	Een kopieertaak.
VariableLibrary	Een VariableLibrary.
Dataflow	Een gegevensstroom.
ApacheAirflowJob	Een ApacheAirflowJob.
WarehouseSnapshot	Een momentopname van een magazijn.
DigitalTwinBuilder	Een DigitalTwinBuilder.
DigitalTwinBuilderFlow	Een Digital Twin Builder Flow.
MirroredAzureDatabricksCatalog	Een gespiegelde Azure Databricks-catalogus.
Map	Een kaart.
AnomalyDetector	Een Anomaly Detector.
UserDataFunction	Een gebruikersgegevensfunctie.
GraphModel	Een GraphModel.
GraphQuerySet	Een Graph QuerySet.
SnowflakeDatabase	Een Snowflake-database voor het opslaan van Iceberg-tabellen die zijn gemaakt op basis van het Snowflake-account.
OperationsAgent	Een OperationsAgent.
CosmosDBDatabase	Een Cosmos DB-database.
Ontology	Een Ontologie.
EventSchemaSet	Een EventSchemaSet.

UpdateItemRequest

Object

Itemaanvraag bijwerken.

Name	Type	Description
description	string	De beschrijving van het item. De maximale lengte is 256 tekens.
displayName	string	De weergavenaam van het item. De weergavenaam moet de naamgevingsregels volgen op basis van het itemtype.