Items - Update Graph Model Definition

Palvelu:

GraphModel

Ohjelmointirajapinnan versio:

v1

Ohittaa määritetyn GraphModel-määrityksen.

Note

GraphModel-kohde on tällä hetkellä esikatselussa (lisätietoja).

Tämä ohjelmointirajapinta tukee pitkäkestoisia toimintoja.

GraphModelin määrityksen päivittäminen ei vaikuta sen luottamuksellisuustunnistetta.

Oikeudet

Soittajalla on oltava GraphModel-mittarin luku- ja kirjoitusoikeudet .

Vaaditut delegoidut vaikutusalueet

Item.ReadWrite.All

tuettujen käyttäjätietojen Microsoft Entra

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

Käyttäjätiedot	Tuki
Käyttäjä	Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen	Kyllä

Liittymä

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

Valinnaisilla parametreilla:

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

URI-parametrit

Nimi	Kohteessa	Pakollinen	Tyyppi	Description
graphModelId	path	True	string (uuid)	GraphModel-tunnus.
workspaceId	path	True	string (uuid)	Työtilan tunnus.
updateMetadata	query		boolean	Kun asetuksena on tosi ja .platform-tiedosto annetaan osana määritystä, kohteen metatiedot päivitetään käyttämällä .platform-tiedoston metatietoja.

Pyynnön leipäteksti

Nimi	Pakollinen	Tyyppi	Description
definition	True	GraphModelPublicDefinition	GraphModelin julkinen määritelmäobjekti. Katso tästä artikkelista lisätietoja GraphModelin julkisen määrityksen luomisesta.

Vastaukset

Nimi	Tyyppi	Description
200 OK		Pyynnön valmistuttua.
202 Accepted		Pyyntö hyväksytty. Päivitysmääritys on meneillään. Otsikot Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	Palveluhinnan raja ylitettiin. Palvelin palauttaa otsikon, joka Retry-After ilmaisee sekunteina, kuinka kauan asiakkaan on odotettava, ennen kuin lisäpyynnöt lähetetään. Otsikot Retry-After: integer
Other Status Codes	ErrorResponse	Yleiset virhekoodit: OperationNotSupportedForItem – Toimintoa ei tueta pyydetylle kohteelle. VioittunutPayload – Annetut tiedot ovat vioittuneet.

Esimerkit

Update a GraphModel public definition example

Mallipyyntö

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

Mallivastaus

Tilakoodi:

200

Tilakoodi:

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

Määritelmät

Nimi	Description
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
GraphModelDefinitionFormat	Kohteen määrityksen muoto. Muita format tyyppejä voidaan lisätä ajan kuluessa.
GraphModelPublicDefinition	GraphModelin julkinen määritelmäobjekti. Katso tästä artikkelista lisätietoja GraphModelin julkisen määrityksen luomisesta.
GraphModelPublicDefinitionPart	GraphModel-määritelmäosaobjekti.
PayloadType	Määritelmäosan hyötykuorman tyyppi. Lisää hyötykuormitustyyppejä voidaan lisätä ajan kuluessa.
UpdateGraphModelDefinitionRequest	Päivitä GraphModelin julkisen määritelmän pyynnön tiedot.

ErrorRelatedResource

Kohde

Virheeseen liittyvä resurssitieto-objekti.

Nimi	Tyyppi	Description
resourceId	string	Virheestä liittyvä resurssitunnus.
resourceType	string	Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Kohde

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 (uuid)	Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Kohde

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.

GraphModelDefinitionFormat

Luettelointi

Kohteen määrityksen muoto. Muita format tyyppejä voidaan lisätä ajan kuluessa.

Arvo	Description
json	GraphModelin julkisen määrityksen JSON-muoto, joka on suunniteltu erityisesti tukemaan Ci/CD-skenaarioita Fabricissa.

GraphModelPublicDefinition

Kohde

GraphModelin julkinen määritelmäobjekti. Katso tästä artikkelista lisätietoja GraphModelin julkisen määrityksen luomisesta.

Nimi	Tyyppi	Description
format	GraphModelDefinitionFormat	Kohteen määrityksen muoto. Muita format tyyppejä voidaan lisätä ajan kuluessa.
parts	GraphModelPublicDefinitionPart[]	Luettelo määritysosista.

GraphModelPublicDefinitionPart

Kohde

GraphModel-määritelmäosaobjekti.

Nimi	Tyyppi	Description
path	string	GraphModelin julkisen määrityksen osan polku.
payload	string	GraphModelin julkisen määritelmän osakuormitus.
payloadType	PayloadType	Hyötykuorman tyyppi.

PayloadType

Luettelointi

Määritelmäosan hyötykuorman tyyppi. Lisää hyötykuormitustyyppejä voidaan lisätä ajan kuluessa.

Arvo	Description
InlineBase64	Inline Base 64.

UpdateGraphModelDefinitionRequest

Kohde

Päivitä GraphModelin julkisen määritelmän pyynnön tiedot.

Nimi	Tyyppi	Description
definition	GraphModelPublicDefinition	GraphModelin julkinen määritelmäobjekti. Katso tästä artikkelista lisätietoja GraphModelin julkisen määrityksen luomisesta.