Items - Create Semantic Model
Skapar en semantisk modell på den angivna arbetsytan.
Det här API:et stöder tidskrävande åtgärder (LRO).
Det här API:et kräver en definition.
Behörigheter
Anroparen måste ha deltagare eller högre arbetsyteroll.
Obligatoriska delegerade omfång
SemanticModel.ReadWrite.All eller Item.ReadWrite.All
Begränsningar
- Om du vill skapa en semantisk modell måste användaren ha rätt licens. Mer information finns i: Microsoft Fabric-licenstyper.
Identiteter som stöds av Microsoft Entra
Det här API:et stöder Microsoft identiteter som anges i det här avsnittet.
Identitet | Stöd |
---|---|
Användare | Ja |
Tjänstens huvudnamn och hanterade identiteter | Ja |
Gränssnitt
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/semanticModels
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
workspace
|
path | True |
string uuid |
Arbetsytans ID. |
Begärandetext
Name | Obligatorisk | Typ | Description |
---|---|---|---|
definition | True |
Den offentliga definitionen för semantikmodellen. |
|
displayName | True |
string |
Visningsnamnet för den semantiska modellen. Visningsnamnet måste följa namngivningsreglerna efter objekttyp. |
description |
string |
Beskrivning av semantisk modell. Maximal längd är 256 tecken. |
Svar
Name | Typ | Description |
---|---|---|
201 Created |
Har skapats |
|
202 Accepted |
Begäran accepterad, semantisk modelletablering pågår. Sidhuvuden
|
|
Other Status Codes |
Vanliga felkoder:
|
Exempel
Create a semantic model example
Exempelbegäran
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/semanticModels
{
"displayName": "SemanticModel 1",
"description": "A semantic model description.",
"definition": {
"parts": [
{
"path": "model.bim",
"payload": "ew0KICAiY29tcGF0a..GVzIjogWyBdDQogIH0NCn0=",
"payloadType": "InlineBase64"
},
{
"path": "definition.pbism",
"payload": "ewogICJ2ZXJzaW9uI..NldHRpbmdzIjoge30KfQ==",
"payloadType": "InlineBase64"
},
{
"path": ".platform",
"payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
"payloadType": "InlineBase64"
}
]
}
}
Exempelsvar
{
"displayName": "SemanticModel 1",
"description": "A semantic model description.",
"type": "SemanticModel",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715"
}
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
Definitioner
Name | Description |
---|---|
Create |
Skapa nyttolasten för semantisk modellbegäran. |
Error |
Det felrelaterade resursinformationsobjektet. |
Error |
Felsvaret. |
Error |
Information om felsvar. |
Item |
Typ av objekt. Ytterligare objekttyper kan läggas till över tid. |
Payload |
Typ av definitionsdelens nyttolast. Ytterligare nyttolasttyper kan läggas till över tid. |
Semantic |
Ett semantiskt modellobjekt. |
Semantic |
|
Semantic |
Delobjekt för semantisk modelldefinition. |
CreateSemanticModelRequest
Skapa nyttolasten för semantisk modellbegäran.
Name | Typ | Description |
---|---|---|
definition |
Den offentliga definitionen för semantikmodellen. |
|
description |
string |
Beskrivning av semantisk modell. Maximal längd är 256 tecken. |
displayName |
string |
Visningsnamnet för den semantiska modellen. Visningsnamnet måste följa namngivningsreglerna efter objekttyp. |
ErrorRelatedResource
Det felrelaterade resursinformationsobjektet.
Name | Typ | Description |
---|---|---|
resourceId |
string |
Det resurs-ID som ingår i felet. |
resourceType |
string |
Typen av resurs som är inblandad i felet. |
ErrorResponse
Felsvaret.
Name | Typ | Description |
---|---|---|
errorCode |
string |
En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare. |
message |
string |
En mänsklig läsbar representation av felet. |
moreDetails |
Lista över ytterligare felinformation. |
|
relatedResource |
Felrelaterad resursinformation. |
|
requestId |
string |
ID för den begäran som är associerad med felet. |
ErrorResponseDetails
Information om felsvar.
Name | Typ | Description |
---|---|---|
errorCode |
string |
En specifik identifierare som ger information om ett feltillstånd, vilket möjliggör standardiserad kommunikation mellan vår tjänst och dess användare. |
message |
string |
En mänsklig läsbar representation av felet. |
relatedResource |
Felrelaterad resursinformation. |
ItemType
Typ av objekt. Ytterligare objekttyper kan läggas till över tid.
Värde | Description |
---|---|
Dashboard |
PowerBI-instrumentpanel. |
DataPipeline |
En datapipeline. |
Datamart |
PowerBI-datamart. |
Environment |
En miljö. |
Eventhouse |
Ett eventhouse. |
Eventstream |
En händelseström. |
GraphQLApi |
Ett API för GraphQL-objekt. |
KQLDashboard |
En KQL-instrumentpanel. |
KQLDatabase |
En KQL-databas. |
KQLQueryset |
En KQL-frågeuppsättning. |
Lakehouse |
Ett sjöhus. |
MLExperiment |
Ett maskininlärningsexperiment. |
MLModel |
En maskininlärningsmodell. |
MirroredDatabase |
En speglad databas. |
MirroredWarehouse |
Ett speglat lager. |
MountedDataFactory |
En MountedDataFactory. |
Notebook |
En notebook-fil. |
PaginatedReport |
Sidnumrerad PowerBI-rapport. |
Reflex |
En reflex. |
Report |
PowerBI-rapport. |
SQLDatabase |
En SQLDatabase. |
SQLEndpoint |
En SQL-slutpunkt. |
SemanticModel |
PowerBI-semantisk modell. |
SparkJobDefinition |
En definition för Spark-jobb. |
Warehouse |
Ett lager. |
PayloadType
Typ av definitionsdelens nyttolast. Ytterligare nyttolasttyper kan läggas till över tid.
Värde | Description |
---|---|
InlineBase64 |
Infogad bas 64. |
SemanticModel
Ett semantiskt modellobjekt.
Name | Typ | Description |
---|---|---|
description |
string |
Objektbeskrivningen. |
displayName |
string |
Objektets visningsnamn. |
id |
string uuid |
Objekt-ID:t. |
type |
Objekttypen. |
|
workspaceId |
string uuid |
Arbetsytans ID. |
SemanticModelDefinition
offentlig definition av semantisk modell objekt.
Name | Typ | Description |
---|---|---|
format |
string |
Formatet för objektdefinitionen. |
parts |
En lista över definitionsdelar. |
SemanticModelDefinitionPart
Delobjekt för semantisk modelldefinition.
Name | Typ | Description |
---|---|---|
path |
string |
Den semantiska modelldelssökvägen. |
payload |
string |
Den semantiska modelldelens nyttolast. |
payloadType |
Nyttolasttypen. |