Dela via

Items - Update Item

  • Referens
Tjänst:
Core
API-version:
v1

Uppdaterar egenskaperna för det angivna objektet.
Det här API:et stöds för ett antal objekttyper, hittar objekttyper som stöds och information om deras definitionsstruktur i Översikt över objekthantering.

Behörigheter

Anroparen måste ha deltagare eller högre roll på arbetsytan.

Obligatoriska delegerade omfång

För objekt-API:er använder du följande omfångstyper:

  • Allmänt omfång: Item.ReadWrite.All
  • Specifikt omfång: itemType. ReadWrite.All (till exempel: Notebook.ReadWrite.All)

Mer information om omfång finns i artikeln om omfång.

Identiteter som stöds av Microsoft Entra

Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.

Identitet Stöd
Användare Ja
Tjänstens huvudnamn och hanterade identiteter När objekttypen i anropet stöds. Kontrollera motsvarande API för den objekttyp som du anropar för att se om ditt anrop stöds. Semantiska modeller stöds till exempel.

Gränssnitt

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

URI-parametrar

Name I Obligatorisk Typ Description
itemId
 path True

string

uuid

Objekt-ID:t.
workspaceId
 path True

string

uuid

Arbetsytans ID.

Begärandetext

Name Typ Description
description

string

Objektbeskrivningen. Maximal längd är 256 tecken.
displayName

string

Objektets visningsnamn. Visningsnamnet måste följa namngivningsreglerna efter objekttyp.

Svar

Name Typ Description
200 OK

Item

Begäran har slutförts.
Other Status Codes

ErrorResponse

Vanliga felkoder:

  • ItemNotFound – Det begärda objektet hittades inte.

  • InvalidRequest – Ogiltig uppdateringsbegäran.

Exempel

Update an item example

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
ErrorRelatedResource

Det felrelaterade resursinformationsobjektet.
ErrorResponse

Felsvaret.
ErrorResponseDetails

Information om felsvar.
Item

Ett objektobjekt.
ItemType

Typ av objekt. Ytterligare objekttyper kan läggas till över tid.
UpdateItemRequest

Uppdatera objektbegäran.

ErrorRelatedResource

Objekt

Det felrelaterade resursinformationsobjektet.

Name Typ Description
resourceId

string

Det resurs-ID som ingår i felet.
resourceType

string

Typen av resurs som är inblandad i felet.

ErrorResponse

Objekt

Felsvaret.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message

string

En mänsklig läsbar representation av felet.
moreDetails

ErrorResponseDetails[]

Lista över ytterligare felinformation.
relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.
requestId

string

ID för den begäran som är associerad med felet.

ErrorResponseDetails

Objekt

Information om felsvar.

Name Typ Description
errorCode

string

En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare.
message

string

En mänsklig läsbar representation av felet.
relatedResource

ErrorRelatedResource

Felrelaterad resursinformation.

Item

Objekt

Ett objektobjekt.

Name Typ Description
description

string

Objektbeskrivningen.
displayName

string

Objektets visningsnamn.
id

string

uuid

Objekt-ID:t.
type

ItemType

Objekttypen.
workspaceId

string

uuid

Arbetsytans ID.

ItemType

Uppräkning

Typ av objekt. Ytterligare objekttyper kan läggas till över tid.

Värde Description
Dashboard

PowerBI-instrumentpanel.
DataPipeline

En datapipeline.
Datamart

PowerBI-datamart.
Environment

En miljö.
Eventhouse

Ett eventhouse.
Eventstream

En händelseström.
GraphQLApi

Ett API för GraphQL-objekt.
KQLDashboard

En KQL-instrumentpanel.
KQLDatabase

En KQL-databas.
KQLQueryset

En KQL-frågeuppsättning.
Lakehouse

Ett sjöhus.
MLExperiment

Ett maskininlärningsexperiment.
MLModel

En maskininlärningsmodell.
MirroredDatabase

En speglad databas.
MirroredWarehouse

Ett speglat lager.
MountedDataFactory

En MountedDataFactory.
Notebook

En notebook-fil.
PaginatedReport

Sidnumrerad PowerBI-rapport.
Reflex

En reflex.
Report

PowerBI-rapport.
SQLDatabase

En SQLDatabase.
SQLEndpoint

En SQL-slutpunkt.
SemanticModel

PowerBI-semantisk modell.
SparkJobDefinition

En definition för Spark-jobb.
Warehouse

Ett lager.

UpdateItemRequest

Objekt

Uppdatera objektbegäran.

Name Typ Description
description

string

Objektbeskrivningen. Maximal längd är 256 tecken.
displayName

string

Objektets visningsnamn. Visningsnamnet måste följa namngivningsreglerna efter objekttyp.