Del via

Items - Update Item

  • Reference
Tjeneste:
Core
API-version:
v1

Opdaterer egenskaberne for det angivne element.
Denne API understøttes for en række elementtyper. Find de understøttede elementtyper og oplysninger om deres definitionsstruktur i oversigt over elementstyring.

Tilladelser

Den, der ringer op, skal have bidragyder eller en højere rolle i arbejdsområdet.

Påkrævede delegerede områder

For element-API'er skal du bruge disse områdetyper:

  • Standardområde: Item.ReadWrite.All
  • Bestemt område: itemType. ReadWrite.All (f.eks. Notebook.ReadWrite.All)

Du kan få flere oplysninger om områder i artiklen områder.

Microsoft Entra-understøttede identiteter

Denne API understøtter de Microsoft -identiteter, der angivet i dette afsnit.

Identitet Støtte
Bruger Ja
tjenesteprincipal og administrerede identiteter Når elementtypen i opkaldet understøttes. Kontrollér den tilsvarende API for den elementtype, du ringer til, for at se, om dit opkald understøttes. Semantiske modeller understøttes f.eks.

Grænseflade

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

URI-parametre

Name I Påkrævet Type Beskrivelse
itemId
 path True

string

uuid

Element-id'et.
workspaceId
 path True

string

uuid

Arbejdsområde-id'et.

Brødtekst for anmodning

Name Type Beskrivelse
description

string

Elementbeskrivelsen. Maksimumlængden er 256 tegn.
displayName

string

Det viste elementnavn. Det viste navn skal følge navngivningsreglerne i henhold til elementtypen.

Svar

Name Type Beskrivelse
200 OK

Item

Anmodningen blev fuldført.
Other Status Codes

ErrorResponse

Almindelige fejlkoder:

  • ItemNotFound – Det ønskede element blev ikke fundet.

  • InvalidRequest - Ugyldig opdateringsanmodning.

Eksempler

Update an item example

Eksempelanmodning

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

Eksempelsvar

Statuskode:
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 Beskrivelse
ErrorRelatedResource

Objektet med fejlrelaterede ressourceoplysninger.
ErrorResponse

Fejlsvaret.
ErrorResponseDetails

Oplysninger om fejlsvar.
Item

Et elementobjekt.
ItemType

Elementets type. Der kan tilføjes flere elementtyper over tid.
UpdateItemRequest

Opdater elementanmodning.

ErrorRelatedResource

Object

Objektet med fejlrelaterede ressourceoplysninger.

Name Type Beskrivelse
resourceId

string

Det ressource-id, der er involveret i fejlen.
resourceType

string

Typen af ressource, der er involveret i fejlen.

ErrorResponse

Object

Fejlsvaret.

Name Type Beskrivelse
errorCode

string

Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere.
message

string

En menneskelig læsbar gengivelse af fejlen.
moreDetails

ErrorResponseDetails[]

Liste over yderligere oplysninger om fejl.
relatedResource

ErrorRelatedResource

De fejlrelaterede ressourceoplysninger.
requestId

string

Id'et for den anmodning, der er knyttet til fejlen.

ErrorResponseDetails

Object

Oplysninger om fejlsvar.

Name Type Beskrivelse
errorCode

string

Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere.
message

string

En menneskelig læsbar gengivelse af fejlen.
relatedResource

ErrorRelatedResource

De fejlrelaterede ressourceoplysninger.

Item

Object

Et elementobjekt.

Name Type Beskrivelse
description

string

Elementbeskrivelsen.
displayName

string

Det viste elementnavn.
id

string

uuid

Element-id'et.
type

ItemType

Elementtypen.
workspaceId

string

uuid

Arbejdsområde-id'et.

ItemType

Optælling

Elementets type. Der kan tilføjes flere elementtyper over tid.

Værdi Beskrivelse
Dashboard

PowerBI-dashboard.
DataPipeline

En datapipeline.
Datamart

PowerBI-datamart.
Environment

Et miljø.
Eventhouse

Et eventhouse.
Eventstream

En hændelsesstream.
GraphQLApi

En API til GraphQL-element.
KQLDashboard

Et KQL-dashboard.
KQLDatabase

En KQL-database.
KQLQueryset

Et KQL-forespørgselssæt.
Lakehouse

Et søhus.
MLExperiment

Et maskinel indlæringseksperiment.
MLModel

En model til maskinel indlæring.
MirroredDatabase

En spejlet database.
MirroredWarehouse

Et spejlvendt lager.
MountedDataFactory

En MountedDataFactory.
Notebook

En notesbog.
PaginatedReport

Sideinddelt PowerBI-rapport.
Reflex

En refleks.
Report

PowerBI-rapport.
SQLDatabase

En SQLDatabase.
SQLEndpoint

Et SQL-slutpunkt.
SemanticModel

Semantisk PowerBI-model.
SparkJobDefinition

En spark jobdefinition.
Warehouse

Et lager.

UpdateItemRequest

Object

Opdater elementanmodning.

Name Type Beskrivelse
description

string

Elementbeskrivelsen. Maksimumlængden er 256 tegn.
displayName

string

Det viste elementnavn. Det viste navn skal følge navngivningsreglerne i henhold til elementtypen.