Items - Update Graph Model Definition

Služba:: GraphModel

Verzia rozhrania API:: v1

Prepíše definíciu pre zadaný model GraphModel.

Poznámka

Položka GraphModel je momentálne v režime ukážky (ďalšie informácie).

Toto rozhranie API podporuje dlhotrvajúce operácie (LRO).

Aktualizácia definície GraphModel neovplyvňuje jeho označenie citlivosti.

Povolenia

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

Povinné delegované rozsahy

Item.ReadWrite.All

podporované identity Microsoft Entra

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

Identita	Podpora
User	Áno
Objekt služby a spravované identity	Áno

Rozhranie

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/graphModels/{graphModelId}/updateDefinition

S voliteľnými parametrami:

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/graphModels/{graphModelId}/updateDefinition?updateMetadata={updateMetadata}

Parametre URI

Name	V	Povinné	Typ	Description
graphModelId	path	True	string (uuid)	Id modelu GraphModel.
workspaceId	path	True	string (uuid)	ID pracovného priestoru.
updateMetadata	query		boolean	Keď je hodnota nastavená na true a súbor .platform sa poskytne ako súčasť definície, metaúdaje položky sa aktualizujú pomocou metaúdajov v súbore .platform

Text požiadavky

Name	Povinné	Typ	Description
definition	True	GraphModelPublicDefinition	Objekt verejnej definície GraphModel. V tomto článku nájdete ďalšie podrobnosti o štruktúre definície GraphModel.

Odpovede

Name	Typ	Description
200 OK		Požiadavka sa úspešne dokončila.
202 Accepted		Žiadosť prijatá. Prebieha definícia aktualizácie. Hlavičky Location: string x-ms-operation-id: string Retry-After: integer
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: OperationNotSupportedForItem – Operácia nie je podporovaná pre požadovanú položku. CorruptedPayload – poskytnutá údajová časť je poškodená.

Príklady

Update a GraphModel public definition example

Vzorová požiadavka

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/graphModels/5b218778-e7a5-4d73-8187-f10824047715/updateDefinition?updateMetadata=True

{
  "definition": {
    "format": "json",
    "parts": [
      {
        "path": "graphType.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": "graphDefinition.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": "dataSources.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": "stylingConfiguration.json",
        "payload": "eyJleGVjdXRhYmxlRm..OWRmNDhhY2ZmZTgifQ==",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Vzorová odpoveď

Kód stavu:: 200

Kód stavu:: 202

Location: https://api.fabric.microsoft.com/v1/operations/427f6c34-b64e-4ee4-8ea5-b533c0e203ef
x-ms-operation-id: 427f6c34-b64e-4ee4-8ea5-b533c0e203ef
Retry-After: 30

Definície

Name	Description
ErrorRelatedResource	Objekt s podrobnosťami o zdroji súvisiacej s chybou.
ErrorResponse	Odpoveď na chybu.
ErrorResponseDetails	Podrobnosti o chybovej odpovedi.
GraphModelDefinitionFormat	Formát definície modelu grafu. V priebehu času je možné pridať ďalšie typy #D0.
GraphModelPublicDefinition	Objekt verejnej definície GraphModel. V tomto článku nájdete ďalšie podrobnosti o štruktúre definície GraphModel.
GraphModelPublicDefinitionPart	Časť objektu definície GraphModel.
PayloadType	Typ údajovej časti definície. V priebehu času je možné pridať ďalšie typy údajovej časti.
UpdateGraphModelDefinitionRequest	Aktualizujte údajovú časť požiadavky verejnej definície GraphModel.

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.

GraphModelDefinitionFormat

Enumerácia

Formát definície modelu grafu. V priebehu času je možné pridať ďalšie typy #D0.

Hodnota	Description
json	Formát JSON pre verejnú definíciu GraphModel, špeciálne navrhnutú na podporu scenárov CI/CD v službe Fabric.

GraphModelPublicDefinition

Object

Objekt verejnej definície GraphModel. V tomto článku nájdete ďalšie podrobnosti o štruktúre definície GraphModel.

Name	Typ	Description
format	GraphModelDefinitionFormat	Formát definície modelu grafu. V priebehu času je možné pridať ďalšie typy #D0.
parts	GraphModelPublicDefinitionPart[]	Zoznam častí definície.

GraphModelPublicDefinitionPart

Object

Časť objektu definície GraphModel.

Name	Typ	Description
path	string	Cesta k verejnej definícii GraphModel.
payload	string	Časť údajovej časti služby GraphModel – verejná definícia.
payloadType	PayloadType	Typ údajovej časti.

PayloadType

Enumerácia

Typ údajovej časti definície. V priebehu času je možné pridať ďalšie typy údajovej časti.

Hodnota	Description
InlineBase64	Inline Base 64.

UpdateGraphModelDefinitionRequest

Object

Aktualizujte údajovú časť požiadavky verejnej definície GraphModel.

Name	Typ	Description
definition	GraphModelPublicDefinition	Objekt verejnej definície GraphModel. V tomto článku nájdete ďalšie podrobnosti o štruktúre definície GraphModel.