Items - Update Report

Služba:
Report
Verzia rozhrania API:
v1

Aktualizuje vlastnosti zadanej zostavy.

Povolenia

Volajúci musí mať povolenia na čítanie a zápis pre zostavu.

Povinné delegované rozsahy

Report.ReadWrite.All alebo Item.ReadWrite.All

podporované identity Microsoft Entra

Toto rozhranie API podporuje Microsoft identity uvedené v tejto časti.

Identita Podpora
Používateľ Áno
Objekt služby a spravované identity Áno

Rozhranie

PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/reports/{reportId}

Parametre URI

Name V Povinné Typ Description
reportId
 path True

string (uuid)

ID zostavy.
workspaceId
 path True

string (uuid)

ID pracovného priestoru.

Text požiadavky

Name Typ Description
description

string

Popis zostavy. Maximálna dĺžka je 256 znakov.
displayName

string

Zobrazovaný názov zostavy. Zobrazovaný názov musí postupovať podľa pravidiel pomenovania podľa typu položky.

Odpovede

Name Typ Description
200 OK

Report

Požiadavka sa úspešne dokončila.
429 Too Many Requests

ErrorResponse

Prekročil sa limit rýchlosti služby. Server vráti hlavičku Retry-After v sekundách, ako dlho musí klient počkať, kým odošle ďalšie požiadavky.

Hlavičky

Retry-After: integer
Other Status Codes

ErrorResponse

Bežné kódy chýb:

  • ItemNotFound – požadovaná položka sa nenašla.

  • InvalidRequest – neplatná požiadavka na aktualizáciu

Príklady

Update a report example

Vzorová požiadavka

PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff211/reports/5b218778-e7a5-4d73-8187-f10824047721

{
  "displayName": "Report's New name",
  "description": "A new description for report."
}

Vzorová odpoveď

Kód stavu:
200 
{
  "displayName": "Report's New name",
  "description": "A new description for report.",
  "type": "Report",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff211",
  "id": "5b218778-e7a5-4d73-8187-f10824047721"
}

Definície

Name Description
EntireTenantPrincipal

Predstavuje objekt nájomníka
ErrorRelatedResource

Objekt s podrobnosťami o zdroji súvisiacej s chybou.
ErrorResponse

Odpoveď na chybu.
ErrorResponseDetails

Podrobnosti o chybovej odpovedi.
GroupDetails

Podrobnosti špecifické pre skupinu. Platí, ak je Grouptyp objektu .
GroupPrincipal

Predstavuje skupinu zabezpečenia.
GroupType

Typ skupiny. V priebehu času je možné pridať ďalšie typy skupín.
ItemTag

Predstavuje značku použitú na položke.
ItemType

Typ položky. V priebehu času je možné pridať ďalšie typy položiek.
PrincipalType

Typ objektu. V priebehu času je možné pridať ďalšie typy objektov.
Report

Objekt zostavy.
SensitivityLabel

Predstavuje označenie citlivosti použité na položku.
ServicePrincipalDetails

Konkrétne podrobnosti objektu služby. Platí, ak je ServicePrincipaltyp objektu .
ServicePrincipalPrincipal

Predstavuje Microsoft Entra objekt služby.
ServicePrincipalProfileDetails

Podrobnosti o profile objektu služby. Platí, ak je ServicePrincipalProfiletyp objektu .
ServicePrincipalProfilePrincipal

Predstavuje profil objektu služby.
UpdateReportRequest

Aktualizovať žiadosť o zostavu.
UserDetails

Konkrétne podrobnosti o objekte používateľa. Platí, ak je Usertyp objektu .
UserPrincipal

Predstavuje Microsoft Entra hlavného používateľa.

EntireTenantPrincipal

Object

Predstavuje objekt nájomníka

Name Typ Description
displayName

string

Zobrazovaný názov objektu.
id

string (uuid)

ID objektu.
type string:

EntireTenant

Typ objektu. V priebehu času je možné pridať ďalšie typy objektov.

ErrorRelatedResource

Object

Objekt s podrobnosťami o zdroji súvisiacej s chybou.

Name Typ Description
resourceId

string

ID prostriedku, ktoré je súčasťou chyby.
resourceType

string

Typ prostriedku, ktorý je zapojený do chyby.

ErrorResponse

Object

Odpoveď na chybu.

Name Typ Description
errorCode

string

Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
isRetriable

boolean

Ak je hodnota true, žiadosť sa môže zopakovať. Retry-After Ak je k dispozícii, oneskorenie môžete určiť pomocou hlavičky odpovede.
message

string

Zobrazenie chyby čitateľné ľuďmi.
moreDetails

ErrorResponseDetails[]

Zoznam ďalších podrobností o chybe.
relatedResource

ErrorRelatedResource

Podrobnosti o zdrojoch súvisiacich s chybou.
requestId

string (uuid)

ID požiadavky súvisiacej s chybou.

ErrorResponseDetails

Object

Podrobnosti o chybovej odpovedi.

Name Typ Description
errorCode

string

Konkrétny identifikátor, ktorý poskytuje informácie o chybovej podmienke a umožňuje štandardizovanú komunikáciu medzi našou službou a používateľmi.
message

string

Zobrazenie chyby čitateľné ľuďmi.
relatedResource

ErrorRelatedResource

Podrobnosti o zdrojoch súvisiacich s chybou.

GroupDetails

Object

Podrobnosti špecifické pre skupinu. Platí, ak je Grouptyp objektu .

Name Typ Description
groupType

GroupType

Typ skupiny. V priebehu času je možné pridať ďalšie typy skupín.

GroupPrincipal

Object

Predstavuje skupinu zabezpečenia.

Name Typ Description
displayName

string

Zobrazovaný názov objektu.
groupDetails

GroupDetails

Podrobnosti špecifické pre skupinu. Platí, ak je Grouptyp objektu .
id

string (uuid)

ID objektu.
type string:

Group

Typ objektu. V priebehu času je možné pridať ďalšie typy objektov.

GroupType

Enumerácia

Typ skupiny. V priebehu času je možné pridať ďalšie typy skupín.

Hodnota Description
Unknown

Typ hlavnej skupiny nie je známy.
SecurityGroup

Principal je skupina zabezpečenia.
DistributionList

Principal je distribučný zoznam.

ItemTag

Object

Predstavuje značku použitú na položke.

Name Typ Description
displayName

string

Názov značky.
id

string (uuid)

ID značky.

ItemType

Enumerácia

Typ položky. V priebehu času je možné pridať ďalšie typy položiek.

Hodnota Description
Dashboard

Tabuľa služby PowerBI.
Report

Zostava PowerBI.
SemanticModel

Sémantický model PowerBI.
PaginatedReport

Stránkovaná zostava služby PowerBI.
Datamart

Údajový diagram služby PowerBI.
Lakehouse

Jazero.
Eventhouse

Eventhouse.
Environment

Prostredie.
KQLDatabase

Databáza KQL.
KQLQueryset

Množina dotazov KQL.
KQLDashboard

Tabuľa KQL.
DataPipeline

Kanál údajov.
Notebook

Poznámkový blok.
SparkJobDefinition

Definícia úlohy iskry.
MLExperiment

Experiment strojového učenia.
MLModel

Model strojového učenia.
Warehouse

Sklad.
Eventstream

Udalosť eventstream.
SQLEndpoint

Koncový bod SQL.
MirroredWarehouse

Zrkadlový sklad.
MirroredDatabase

Zrkadlová databáza.
Reflex

A Reflex.
GraphQLApi

Rozhranie API pre položku GraphQL.
MountedDataFactory

A MountedDataFactory.
SQLDatabase

Databáza SQLDatabase.
CopyJob

Kopírovať úlohu.
VariableLibrary

A VariableLibrary.
Dataflow

Tok údajov.
ApacheAirflowJob

An ApacheAirflowJob.
WarehouseSnapshot

Snímka skladu.
DigitalTwinBuilder

A DigitalTwinBuilder.
DigitalTwinBuilderFlow

Digitálny postup Twin Buildera.
MirroredAzureDatabricksCatalog

Zrkadlový katalóg Azure databricks.
Map

Mapa.
AnomalyDetector

Detektor anomálií.
UserDataFunction

Funkcia user data function.
GraphModel

A GraphModel.
GraphQuerySet

Množina dotazov Graphu.
SnowflakeDatabase

Databáza Snowflake na ukladanie tabuliek ľadovec vytvorených z konta Snowflake.
OperationsAgent

OperationsAgent (Operácia).
CosmosDBDatabase

Databáza Cosmos DB.
Ontology

Ontológia.
EventSchemaSet

Množina schém udalosti.
DataAgent

DataAgent (Údajovýgens).
MirroredCatalog

Zrkadlovýcatalog.
AppBackend

An AppBackend.

PrincipalType

Enumerácia

Typ objektu. V priebehu času je možné pridať ďalšie typy objektov.

Hodnota Description
User

Principal je Microsoft Entra objektom používateľa.
ServicePrincipal

Principal je Microsoft Entra objekt služby.
Group

Principal je skupina zabezpečenia.
ServicePrincipalProfile

Principal je profil objektu služby.
EntireTenant

Možnosť Principal predstavuje všetkých používateľov nájomníka.

Report

Object

Objekt zostavy.

Name Typ Description
defaultIdentity Principal:

Predvolená identita položky.
description

string

Popis položky.
displayName

string

Zobrazovaný názov položky.
folderId

string (uuid)

ID priečinka.
id

string (uuid)

ID položky.
sensitivityLabel

SensitivityLabel

Označenie citlivosti položky.
tags

ItemTag[]

Zoznam použitých značiek.
type

ItemType

Typ položky.
workspaceId

string (uuid)

ID pracovného priestoru.

SensitivityLabel

Object

Predstavuje označenie citlivosti použité na položku.

Name Typ Description
id

string (uuid)

ID označenia citlivosti.

ServicePrincipalDetails

Object

Konkrétne podrobnosti objektu služby. Platí, ak je ServicePrincipaltyp objektu .

Name Typ Description
aadAppId

string (uuid)

Microsoft Entra id objektu služby.

ServicePrincipalPrincipal

Object

Predstavuje Microsoft Entra objekt služby.

Name Typ Description
displayName

string

Zobrazovaný názov objektu.
id

string (uuid)

ID objektu.
servicePrincipalDetails

ServicePrincipalDetails

Konkrétne podrobnosti objektu služby. Platí, ak je ServicePrincipaltyp objektu .
type string:

ServicePrincipal

Typ objektu. V priebehu času je možné pridať ďalšie typy objektov.

ServicePrincipalProfileDetails

Object

Podrobnosti o profile objektu služby. Platí, ak je ServicePrincipalProfiletyp objektu .

Name Typ Description
parentPrincipal Principal:

Nadradený objekt profilu služby.

ServicePrincipalProfilePrincipal

Object

Predstavuje profil objektu služby.

Name Typ Description
displayName

string

Zobrazovaný názov objektu.
id

string (uuid)

ID objektu.
servicePrincipalProfileDetails

ServicePrincipalProfileDetails

Podrobnosti o profile objektu služby. Platí, ak je ServicePrincipalProfiletyp objektu .
type string:

ServicePrincipalProfile

Typ objektu. V priebehu času je možné pridať ďalšie typy objektov.

UpdateReportRequest

Object

Aktualizovať žiadosť o zostavu.

Name Typ Description
description

string

Popis zostavy. Maximálna dĺžka je 256 znakov.
displayName

string

Zobrazovaný názov zostavy. Zobrazovaný názov musí postupovať podľa pravidiel pomenovania podľa typu položky.

UserDetails

Object

Konkrétne podrobnosti o objekte používateľa. Platí, ak je Usertyp objektu .

Name Typ Description
userPrincipalName

string

Hlavné meno používateľa.

UserPrincipal

Object

Predstavuje Microsoft Entra hlavného používateľa.

Name Typ Description
displayName

string

Zobrazovaný názov objektu.
id

string (uuid)

ID objektu.
type string:

User

Typ objektu. V priebehu času je možné pridať ďalšie typy objektov.
userDetails

UserDetails

Konkrétne podrobnosti o objekte používateľa. Platí, ak je Usertyp objektu .