Sdílet prostřednictvím

Items - Update Item

  • Reference
Služba:
Core
Verze rozhraní API:
v1

Aktualizuje vlastnosti zadané položky.
Toto rozhraní API je podporováno pro řadu typů položek, vyhledání podporovaných typů položek a informace o jejich definiční struktuře v přehledu správy položek .

Dovolení

Volající musí mít přispěvatele nebo vyšší roli v pracovním prostoru.

Požadované delegovaná rozsahy

Pro rozhraní API položek se používají tyto typy oborů:

  • Obecný obor: Item.ReadWrite.All
  • Specifický obor: itemType. ReadWrite.All (například Notebook.ReadWrite.All)

Další informace o oborech naleznete v článku obory .

Podporované identity Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita Podpora
Uživatel Ano
instančního objektu a spravované identity Je-li podporován typ položky ve volání. Zkontrolujte odpovídající rozhraní API pro typ položky, který voláte, a zjistěte, jestli je volání podporované. Podporují se například sémantické modely.

Rozhraní

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
itemId
 path True

string

uuid

ID položky.
workspaceId
 path True

string

uuid

ID pracovního prostoru.

Text požadavku

Name Typ Description
description

string

Popis položky. Maximální délka je 256 znaků.
displayName

string

Zobrazovaný název položky. Zobrazovaný název musí odpovídat pravidlům pojmenování podle typu položky.

Odpovědi

Name Typ Description
200 OK

Item

Žádost byla úspěšně dokončena.
Other Status Codes

ErrorResponse

Běžné kódy chyb:

  • ItemNotFound – Požadovaná položka nebyla nalezena.

  • InvalidRequest – Neplatný požadavek na aktualizaci

Příklady

Update an item example

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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"
}

Definice

Name Description
ErrorRelatedResource

Chyba související s objektem podrobností o prostředku.
ErrorResponse

Odpověď na chybu.
ErrorResponseDetails

Podrobnosti o odpovědi na chybu.
Item

Objekt položky.
ItemType

Typ položky. V průběhu času je možné přidat další typy položek.
UpdateItemRequest

Aktualizujte požadavek na položku.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name Typ Description
resourceId

string

ID prostředku, které je součástí chyby.
resourceType

string

Typ prostředku, který je součástí chyby.

ErrorResponse

Objekt

Odpověď na chybu.

Name Typ Description
errorCode

string

Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message

string

Lidské čitelné vyjádření chyby.
moreDetails

ErrorResponseDetails[]

Seznam dalších podrobností o chybě
relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou
requestId

string

ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name Typ Description
errorCode

string

Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message

string

Lidské čitelné vyjádření chyby.
relatedResource

ErrorRelatedResource

Podrobnosti o prostředku souvisejícím s chybou

Item

Objekt

Objekt položky.

Name Typ Description
description

string

Popis položky.
displayName

string

Zobrazovaný název položky.
id

string

uuid

ID položky.
type

ItemType

Typ položky.
workspaceId

string

uuid

ID pracovního prostoru.

ItemType

Výčet

Typ položky. V průběhu času je možné přidat další typy položek.

Hodnota Description
Dashboard

Řídicí panel PowerBI
DataPipeline

Datový kanál.
Datamart

Datový diagram PowerBI
Environment

Prostředí.
Eventhouse

Eventhouse.
Eventstream

Eventstream.
GraphQLApi

Rozhraní API pro položku GraphQL
KQLDashboard

Řídicí panel KQL.
KQLDatabase

Databáze KQL.
KQLQueryset

Sada dotazů KQL.
Lakehouse

Jezero.
MLExperiment

Experiment strojového učení.
MLModel

Model strojového učení.
MirroredDatabase

Zrcadlené databáze.
MirroredWarehouse

Zrcadlený sklad.
MountedDataFactory

A MountedDataFactory.
Notebook

Poznámkový blok.
PaginatedReport

Stránkovaná sestava PowerBI
Reflex

A Reflex.
Report

Sestava PowerBI
SQLDatabase

Databáze SQLDatabase.
SQLEndpoint

Koncový bod SQL.
SemanticModel

Sémantický model PowerBI
SparkJobDefinition

Definice úlohy Sparku.
Warehouse

Sklad.

UpdateItemRequest

Objekt

Aktualizujte požadavek na položku.

Name Typ Description
description

string

Popis položky. Maximální délka je 256 znaků.
displayName

string

Zobrazovaný název položky. Zobrazovaný název musí odpovídat pravidlům pojmenování podle typu položky.