Delen via

Items - Update Item

  • Referentie
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 beller moet inzender hebben of een hogere rol in de werkruimte.

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.

Interface

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

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

string

uuid

De item-id.
type

ItemType

Het itemtype.
workspaceId

string

uuid

De werkruimte-id.

ItemType

Inventarisatie

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

Waarde Description
Dashboard

PowerBI-dashboard.
DataPipeline

Een gegevenspijplijn.
Datamart

PowerBI-datamart.
Environment

Een omgeving.
Eventhouse

Een eventhouse.
Eventstream

Een eventstream.
GraphQLApi

Een API voor GraphQL-item.
KQLDashboard

Een KQL-dashboard.
KQLDatabase

Een KQL-database.
KQLQueryset

Een KQL-queryset.
Lakehouse

Een lakehouse.
MLExperiment

Een machine learning-experiment.
MLModel

Een machine learning-model.
MirroredDatabase

Een gespiegelde database.
MirroredWarehouse

Een gespiegeld magazijn.
MountedDataFactory

Een MountedDataFactory.
Notebook

Een notitieblok.
PaginatedReport

Gepagineerd Power BI-rapport.
Reflex

Een reflex.
Report

PowerBI-rapport.
SQLDatabase

Een SQLDatabase.
SQLEndpoint

Een SQL-eindpunt.
SemanticModel

Semantisch Power BI-model.
SparkJobDefinition

Een Spark-taakdefinitie.
Warehouse

Een magazijn.

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.