Jaa

Items - Update Item

  • Viite
Palvelu:
Core
Ohjelmointirajapinnan versio:
v1

Päivittää määritetyn kohteen ominaisuudet.
Tätä ohjelmointirajapintaa tuetaan useissa kohdetyypeissä. Se etsii tuettuja kohdetyyppejä ja tietoja niiden määritysrakenteesta kohdasta Kohdehallinnan yleiskatsaus.

Käyttöoikeudet

Kutsujalla on oltava osallistujan tai suurempi rooli työtilassa.

Vaaditut delegoidut vaikutusalueet

Kohteiden ohjelmointirajapinnoilla voit käyttää seuraavia vaikutusaluetyyppejä:

  • Yleinen vaikutusalue: Item.ReadWrite.All
  • Tietty vaikutusalue: itemType. ReadWrite.All (esimerkiksi: Notebook.ReadWrite.All)

Lisätietoja vaikutusalueista on artikkelissa vaikutusalueet.

Microsoft Entran tukemat käyttäjätiedot

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft -käyttäjätietoja.

Identiteetti Tuki
Käyttäjä Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen Kun kutsun kohdetyyppiä tuetaan. Tarkista vastaava ohjelmointirajapinta kohdetyypille, jota kutsut, ja tarkista, tuetaanko kutsuasi. Esimerkiksi semanttisia malleja tuetaan.

Rajapinta

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

URI-parametrit

Nimi Kohteessa Pakollinen Tyyppi Description
itemId
 path True

string

uuid

Kohdetunnus.
workspaceId
 path True

string

uuid

Työtilan tunnus.

Pyynnön leipäteksti

Nimi Tyyppi Description
description

string

Kohteen kuvaus. Enimmäispituus on 256 merkkiä.
displayName

string

Kohteen näyttönimi. Näyttönimen on noudatettava nimeämissääntöjä kohdetyypin mukaan.

Vastaukset

Nimi Tyyppi Description
200 OK

Item

Pyynnön valmistuttua.
Other Status Codes

ErrorResponse

Yleiset virhekoodit:

  • ItemNotFound – Pyydettyä kohdetta ei löytynyt.

  • InvalidRequest – Virheellinen päivityspyyntö.

Esimerkit

Update an item example

Mallipyyntö

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

Mallivastaus

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

Määritelmät

Nimi Description
ErrorRelatedResource

Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse

Virhevastaus.
ErrorResponseDetails

Virheen vastauksen tiedot.
Item

Kohdeobjekti.
ItemType

Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.
UpdateItemRequest

Päivitä kohdepyyntö.

ErrorRelatedResource

Object

Virheeseen liittyvä resurssitieto-objekti.

Nimi Tyyppi Description
resourceId

string

Virheestä liittyvä resurssitunnus.
resourceType

string

Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Object

Virhevastaus.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message

string

Ihmisen luettavissa oleva esitys virheestä.
moreDetails

ErrorResponseDetails[]

Luettelo virheiden lisätiedoista.
relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.
requestId

string

Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Object

Virheen vastauksen tiedot.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message

string

Ihmisen luettavissa oleva esitys virheestä.
relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.

Item

Object

Kohdeobjekti.

Nimi Tyyppi Description
description

string

Kohteen kuvaus.
displayName

string

Kohteen näyttönimi.
id

string

uuid

Kohdetunnus.
type

ItemType

Kohdetyyppi.
workspaceId

string

uuid

Työtilan tunnus.

ItemType

Luettelointi

Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.

Arvo Description
Dashboard

Power BI -koontinäyttö.
DataPipeline

Tietoputki.
Datamart

PowerBI -tietomarssi.
Environment

Ympäristö.
Eventhouse

Tapahtumatalo.
Eventstream

Tapahtumavirta.
GraphQLApi

Ohjelmointirajapinta GraphQL-kohteelle.
KQLDashboard

KQL-koontinäyttö.
KQLDatabase

KQL-tietokanta.
KQLQueryset

KQL-kyselyjoukko.
Lakehouse

Tämä on lakehouse.
MLExperiment

Koneoppimisen kokeilu.
MLModel

Koneoppimismalli.
MirroredDatabase

Peilattu tietokanta.
MirroredWarehouse

Peilattu varasto.
MountedDataFactory

A MountedDataFactory.
Notebook

Muistikirja.
PaginatedReport

PowerBI:n sivutettu raportti.
Reflex

Refleksi.
Report

PowerBI -raportti.
SQLDatabase

A SQLDatabase.
SQLEndpoint

SQL-päätepiste.
SemanticModel

PowerBI:n semanttinen malli.
SparkJobDefinition

Spark-työn määritelmä.
Warehouse

Varasto.

UpdateItemRequest

Object

Päivitä kohdepyyntö.

Nimi Tyyppi Description
description

string

Kohteen kuvaus. Enimmäispituus on 256 merkkiä.
displayName

string

Kohteen näyttönimi. Näyttönimen on noudatettava nimeämissääntöjä kohdetyypin mukaan.