Items - Create Graph Model

Service:: GraphModel

API-versie:: v1

Hiermee maakt u een GraphModel in de opgegeven werkruimte.

Opmerking

GraphModel-item is momenteel in preview (meer informatie).

Deze API ondersteunt langlopende bewerkingen (LRO).

Als u GraphModel wilt maken met een openbare definitie, raadpleegt u het artikel GraphModel .

Permissions

De aanroeper moet een werkruimterol inzender hebben.

Vereiste gedelegeerde bereiken

Item.ReadWrite.All

Beperkingen

Als u een GraphModel wilt maken, moet de werkruimte zich in een ondersteunde infrastructuurcapaciteit bevinden. Zie voor meer informatie: Microsoft Fabric licentietypen.

Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft-identiteiten die in deze sectie worden vermeld.

Identiteit	Support
User	Yes
serviceprincipal en beheerde identiteiten	Yes

gebruikersinterface

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

URI-parameters

Name	In	Vereist	Type	Description
workspaceId	path	True	string (uuid)	De werkruimte-ID.

Aanvraagbody

Name	Vereist	Type	Description
displayName	True	string	De weergavenaam van GraphModel. De weergavenaam moet de naamgevingsregels volgen op basis van het itemtype.
definition		GraphModelPublicDefinition	De openbare definitie van GraphModel.
description		string	De beschrijving van GraphModel. De maximale lengte is 256 tekens.
folderId		string (uuid)	De map-id. Als dit niet is opgegeven of null, wordt het GraphModel gemaakt met de werkruimte als map.
sensitivityLabelSettings		SensitivityLabelSettings	De instellingen voor vertrouwelijkheidslabels voor het GraphModel.

Antwoorden

Name	Type	Description
201 Created	GraphModel	Gemaakt
202 Accepted		Aanvraag geaccepteerd, GraphModel-inrichting wordt uitgevoerd. Kopteksten Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	De servicesnelheidslimiet is overschreden. De server retourneert een `Retry-After` header die in seconden aangeeft hoe lang de client moet wachten voordat extra aanvragen worden verzonden. Kopteksten Retry-After: integer
Other Status Codes	ErrorResponse	Veelvoorkomende foutcodes: InvalidItemType - Itemtype is ongeldig ItemDisplayNameAlreadyInUse - Weergavenaam van item wordt al gebruikt. CorruptedPayload: de opgegeven nettolading is beschadigd. WorkspaceItemsLimitExceeded - Limiet voor werkruimte-items is overschreden.

Voorbeelden

Create a GraphModel example

Create a GraphModel with public definition example

Create a GraphModel example

Voorbeeldaanvraag

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/graphModels

{
  "displayName": "GraphModel 1",
  "description": "A GraphModel description."
}

Voorbeeldrespons

Statuscode:: 201

{
  "displayName": "GraphModel 1",
  "description": "A GraphModel description.",
  "type": "GraphModel",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

Statuscode:: 202

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create a GraphModel with public definition example

Voorbeeldaanvraag

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/graphModels

{
  "displayName": "GraphModel 1",
  "description": "A GraphModel description.",
  "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"
      }
    ]
  }
}

Voorbeeldrespons

Statuscode:: 201

{
  "displayName": "GraphModel 1",
  "description": "A GraphModel description.",
  "type": "GraphModel",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715",
  "sensitivityLabel": {
    "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
  }
}

Statuscode:: 202

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Definities

Name	Description
CreateGraphModelRequest	Nettolading voor GraphModel-aanvragen maken.
ErrorRelatedResource	Het foutgerelateerde resourcedetailsobject.
ErrorResponse	Het foutbericht.
ErrorResponseDetails	De details van het foutbericht.
GraphModel	Een GraphModel-object.
GraphModelDefinitionFormat	De indeling van de itemdefinitie. Er kunnen in de loop van de tijd extra `format` typen worden toegevoegd.
GraphModelPublicDefinition	GraphModel public definition object. Raadpleeg dit artikel voor meer informatie over de structuur van de GraphModel-definitie.
GraphModelPublicDefinitionPart	GraphModel definition part object.
ItemTag	Vertegenwoordigt een tag die is toegepast op een item.
ItemType	Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.
PayloadType	Het type nettolading van het definitieonderdeel. Er kunnen in de loop van de tijd extra typen nettoladingen worden toegevoegd.
SensitivityLabel	Vertegenwoordigt een vertrouwelijkheidslabel dat is toegepast op een item.
SensitivityLabelApplyStrategy	De strategie voor het toepassen van het gevoeligheidslabel. De standaardwaarde is ApplyOrFail. Er kunnen in de loop van de tijd extra typen worden toegevoegd.
SensitivityLabelSettings	De instellingen voor vertrouwelijkheidslabels.

CreateGraphModelRequest

Object

Nettolading voor GraphModel-aanvragen maken.

Name	Type	Description
definition	GraphModelPublicDefinition	De openbare definitie van GraphModel.
description	string	De beschrijving van GraphModel. De maximale lengte is 256 tekens.
displayName	string	De weergavenaam van GraphModel. De weergavenaam moet de naamgevingsregels volgen op basis van het itemtype.
folderId	string (uuid)	De map-id. Als dit niet is opgegeven of null, wordt het GraphModel gemaakt met de werkruimte als map.
sensitivityLabelSettings	SensitivityLabelSettings	De instellingen voor vertrouwelijkheidslabels voor het GraphModel.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name	Type	Description
resourceId	string	De resource-id die betrokken is bij de fout.
resourceType	string	Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
moreDetails	ErrorResponseDetails[]	Lijst met aanvullende foutdetails.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.
requestId	string (uuid)	Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name	Type	Description
errorCode	string	Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message	string	Een leesbare weergave van de fout.
relatedResource	ErrorRelatedResource	De foutgerelateerde resourcedetails.

GraphModel

Object

Een GraphModel-object.

Name	Type	Description
description	string	De beschrijving van het item.
displayName	string	De weergavenaam van het item.
folderId	string (uuid)	De map-id.
id	string (uuid)	De item-id.
sensitivityLabel	SensitivityLabel	Het vertrouwelijkheidslabel voor items.
tags	ItemTag[]	Lijst met toegepaste tags.
type	ItemType	Het itemtype.
workspaceId	string (uuid)	De werkruimte-ID.

GraphModelDefinitionFormat

Opsomming

De indeling van de itemdefinitie. Er kunnen in de loop van de tijd extra format typen worden toegevoegd.

Waarde	Description
json	JSON-indeling voor de openbare definitie van GraphModel, speciaal ontworpen ter ondersteuning van CI/CD-scenario's in Fabric.

GraphModelPublicDefinition

Object

GraphModel public definition object. Raadpleeg dit artikel voor meer informatie over de structuur van de GraphModel-definitie.

Name	Type	Description
format	GraphModelDefinitionFormat	De indeling van de itemdefinitie. Er kunnen in de loop van de tijd extra `format` typen worden toegevoegd.
parts	GraphModelPublicDefinitionPart[]	Een lijst met definitieonderdelen.

GraphModelPublicDefinitionPart

Object

GraphModel definition part object.

Name	Type	Description
path	string	Het pad van het onderdeel openbare definitie van GraphModel.
payload	string	De nettolading van het openbare definitieonderdeel GraphModel.
payloadType	PayloadType	Het nettoladingstype.

ItemTag

Object

Vertegenwoordigt een tag die is toegepast op een item.

Name	Type	Description
displayName	string	De naam van de tag.
id	string (uuid)	De tag-id.

ItemType

Opsomming

Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.

Waarde	Description
Dashboard	PowerBI-dashboard.
Report	PowerBI-rapport.
SemanticModel	Semantisch Power BI-model.
PaginatedReport	Gepagineerd Power BI-rapport.
Datamart	PowerBI-datamart.
Lakehouse	Een lakehouse.
Eventhouse	Een eventhouse.
Environment	Een omgeving.
KQLDatabase	Een KQL-database.
KQLQueryset	Een KQL-queryset.
KQLDashboard	Een KQL-dashboard.
DataPipeline	Een gegevenspijplijn.
Notebook	Een notitieblok.
SparkJobDefinition	Een Spark-taakdefinitie.
MLExperiment	Een machine learning-experiment.
MLModel	Een machine learning-model.
Warehouse	Een magazijn.
Eventstream	Een eventstream.
SQLEndpoint	Een SQL-eindpunt.
MirroredWarehouse	Een gespiegeld magazijn.
MirroredDatabase	Een gespiegelde database.
Reflex	Een reflex.
GraphQLApi	Een API voor GraphQL-item.
MountedDataFactory	Een MountedDataFactory.
SQLDatabase	Een SQLDatabase.
CopyJob	Een kopieertaak.
VariableLibrary	Een VariableLibrary.
Dataflow	Een gegevensstroom.
ApacheAirflowJob	Een ApacheAirflowJob.
WarehouseSnapshot	Een momentopname van een magazijn.
DigitalTwinBuilder	Een DigitalTwinBuilder.
DigitalTwinBuilderFlow	Een Digital Twin Builder Flow.
MirroredAzureDatabricksCatalog	Een gespiegelde Azure Databricks-catalogus.
Map	Een kaart.
AnomalyDetector	Een Anomaly Detector.
UserDataFunction	Een gebruikersgegevensfunctie.
GraphModel	Een GraphModel.
GraphQuerySet	Een Graph QuerySet.
SnowflakeDatabase	Een Snowflake-database voor het opslaan van Iceberg-tabellen die zijn gemaakt op basis van het Snowflake-account.
OperationsAgent	Een OperationsAgent.
CosmosDBDatabase	Een Cosmos DB-database.
Ontology	Een Ontologie.
EventSchemaSet	Een EventSchemaSet.
DataAgent	Een DataAgent.

PayloadType

Opsomming

Het type nettolading van het definitieonderdeel. Er kunnen in de loop van de tijd extra typen nettoladingen worden toegevoegd.

Waarde	Description
InlineBase64	Inline base 64.

SensitivityLabel

Object

Vertegenwoordigt een vertrouwelijkheidslabel dat is toegepast op een item.

Name	Type	Description
id	string (uuid)	De vertrouwelijkheidslabel-id.

SensitivityLabelApplyStrategy

Opsomming

De strategie voor het toepassen van het gevoeligheidslabel. De standaardwaarde is ApplyOrFail. Er kunnen in de loop van de tijd extra typen worden toegevoegd.

Waarde	Description
ApplyOrFail	Pas het vertrouwelijkheidslabel toe of mislukt de bewerking als deze niet kan worden toegepast.
Ignore	Negeer het vertrouwelijkheidslabel als het niet kan worden toegepast en ga door met de bewerking zonder het label toe te passen.

SensitivityLabelSettings

Object

De instellingen voor vertrouwelijkheidslabels.

Name	Type	Description
labelId	string (uuid)	De vertrouwelijkheidslabel-id.
sensitivityLabelApplyStrategy	SensitivityLabelApplyStrategy	De strategie voor het toepassen van het gevoeligheidslabel.

Delen via

Items - Create Graph Model

Permissions

Vereiste gedelegeerde bereiken

Beperkingen

Microsoft Entra ondersteunde identiteiten

gebruikersinterface

URI-parameters

Aanvraagbody

Antwoorden

Voorbeelden

Create a GraphModel example

Voorbeeldaanvraag

Voorbeeldrespons

Create a GraphModel with public definition example

Voorbeeldaanvraag

Voorbeeldrespons

Definities

CreateGraphModelRequest

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GraphModel

GraphModelDefinitionFormat

GraphModelPublicDefinition

GraphModelPublicDefinitionPart

ItemTag

ItemType

PayloadType

SensitivityLabel

SensitivityLabelApplyStrategy

SensitivityLabelSettings