Items - Update Semantic Model Definition
Hiermee wordt de definitie voor het opgegeven semantische model overschreven.
Deze API ondersteunt langlopende bewerkingen (LRO).
Het bijwerken van de definitie van het semantische model heeft geen invloed op het vertrouwelijkheidslabel.
Machtigingen
De aanroeper moet lees- en schrijfmachtigingen hebben voor het semantische model.
Vereiste gedelegeerde bereiken
SemanticModel.ReadWrite.All of Item.ReadWrite.All
Door Microsoft Entra ondersteunde identiteiten
Deze API ondersteunt de Microsoft-identiteiten die in deze sectie worden vermeld.
| Identiteit | Ondersteuning |
|---|---|
| Gebruiker | Ja |
| serviceprincipal en beheerde identiteiten | Ja |
gebruikersinterface
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/semanticModels/{semanticModelId}/updateDefinition
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/semanticModels/{semanticModelId}/updateDefinition?updateMetadata={updateMetadata}
URI-parameters
| Naam | In | Vereist | Type | Description |
|---|---|---|---|---|
|
semantic
|
path | True |
string (uuid) |
De semantische model-id. |
|
workspace
|
path | True |
string (uuid) |
De werkruimte-ID. |
|
update
|
query |
boolean |
Als deze is ingesteld op true en het .platform-bestand wordt opgegeven als onderdeel van de definitie, worden de metagegevens van het item bijgewerkt met behulp van de metagegevens in het PLATFORM-bestand |
Aanvraagbody
| Naam | Vereist | Type | Description |
|---|---|---|---|
| definition | True |
openbare Semantische modeldefinitie object. Raadpleeg dit artikel voor meer informatie over de structuur van de Semantische modeldefinitie. |
|
| options |
Opties voor het semantische model waarvan de definitie wordt bijgewerkt. |
Antwoorden
| Naam | Type | Description |
|---|---|---|
| 200 OK |
De aanvraag is voltooid. |
|
| 202 Accepted |
Aanvraag geaccepteerd. De definitie van de update wordt uitgevoerd. Kopteksten
|
|
| 429 Too Many Requests |
De servicesnelheidslimiet is overschreden. De server retourneert een Kopteksten Retry-After: integer |
|
| Other Status Codes |
Veelvoorkomende foutcodes:
|
Voorbeelden
Update a semantic model definition example
Voorbeeldaanvraag
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/semanticModels/5b218778-e7a5-4d73-8187-f10824047715/updateDefinition?updateMetadata=True
{
"definition": {
"parts": [
{
"path": "model.bim",
"payload": "ewogICJjb21wYXRpYmlsaXR5TGV2ZW..GVzIjogWyBdDQogIH0NCn0",
"payloadType": "InlineBase64"
},
{
"path": "definition.pbism",
"payload": "ewogICJ2ZXJzaW9uIjogIjQuMC..HRpbmdzIjoge30KfQ==",
"payloadType": "InlineBase64"
},
{
"path": ".platform",
"payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
"payloadType": "InlineBase64"
}
]
}
}
Voorbeeldrespons
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
Definities
| Naam | Description |
|---|---|
|
Error |
Een gestructureerde parameter die extra machineleesbare context biedt over een fout. |
|
Error |
Het foutgerelateerde resourcedetailsobject. |
|
Error |
Het foutbericht. |
|
Error |
De details van het foutbericht. |
|
Payload |
Het type nettolading van het definitieonderdeel. Er kunnen in de loop van de tijd extra typen nettoladingen worden toegevoegd. |
|
Semantic |
openbare Semantische modeldefinitie object. Raadpleeg dit artikel voor meer informatie over de structuur van de Semantische modeldefinitie. |
|
Semantic |
Opties die van toepassing zijn bij het maken van een semantisch model met een definitie of het bijwerken van de definitie van een semantisch model. |
|
Semantic |
Semantisch modeldefinitieonderdeelobject. |
|
Update |
Werk de nettolading van openbare definitieaanvragen van het semantische model bij. |
ErrorParameter
Een gestructureerde parameter die extra machineleesbare context biedt over een fout.
| Naam | Type | Description |
|---|---|---|
| message |
string |
Een door mensen leesbare beschrijving van de betekenis van de parameter. |
| name |
string |
De parameter-id. |
| value |
string |
De waarde van de parameter. |
ErrorRelatedResource
Het foutgerelateerde resourcedetailsobject.
| Naam | 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
Het foutbericht.
| Naam | Type | Description |
|---|---|---|
| errorCode |
string |
Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is. |
| isRetriable |
boolean |
Wanneer waar, kan de aanvraag opnieuw worden geprobeerd. Gebruik de |
| message |
string |
Een leesbare weergave van de fout. |
| moreDetails |
Lijst met aanvullende foutdetails. |
|
| parameters |
Gestructureerde parameters die extra machineleesbare context bieden over de fout. |
|
| relatedResource |
De foutgerelateerde resourcedetails. |
|
| requestId |
string (uuid) |
Id van de aanvraag die is gekoppeld aan de fout. |
ErrorResponseDetails
De details van het foutbericht.
| Naam | 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. |
| parameters |
Gestructureerde parameters die extra machineleesbare context bieden over de fout. |
|
| relatedResource |
De foutgerelateerde resourcedetails. |
PayloadType
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. |
SemanticModelDefinition
openbare Semantische modeldefinitie object. Raadpleeg dit artikel voor meer informatie over de structuur van de Semantische modeldefinitie.
| Naam | Type | Description |
|---|---|---|
| format |
string |
De indeling van de definitie van het semantische model. |
| parts |
Een lijst met definitieonderdelen. |
SemanticModelDefinitionOptions
Opties die van toepassing zijn bij het maken van een semantisch model met een definitie of het bijwerken van de definitie van een semantisch model.
| Naam | Type | Description |
|---|---|---|
| allowPurgeData |
boolean |
Of u de bestaande gegevens van het semantische model wilt opschonen bij het toepassen van de bijgewerkte definitie. Voor sommige definitiewijzigingen moeten bestaande gegevens worden gewist; stel dit in op True om toe te staan dat deze wijzigingen worden voortgezet. In dat geval worden alle gegevens die niet kunnen worden bewaard onder de nieuwe definitie verwijderd. Nadat de bewerking is voltooid, vernieuwt u het semantische model om de gegevens opnieuw te laden. De standaardwaarde is onwaar. |
SemanticModelDefinitionPart
Semantisch modeldefinitieonderdeelobject.
| Naam | Type | Description |
|---|---|---|
| path |
string |
Het pad naar het semantische modelonderdeel. |
| payload |
string |
De nettolading van het semantische modelonderdeel. |
| payloadType |
Het nettoladingstype. |
UpdateSemanticModelDefinitionRequest
Werk de nettolading van openbare definitieaanvragen van het semantische model bij.
| Naam | Type | Description |
|---|---|---|
| definition |
openbare Semantische modeldefinitie object. Raadpleeg dit artikel voor meer informatie over de structuur van de Semantische modeldefinitie. |
|
| options |
Opties voor het semantische model waarvan de definitie wordt bijgewerkt. |