Items - Update Semantic Model
Atualiza as propriedades do modelo semântico especificado.
Permissões
O chamador deve ter função de colaborador ou de espaço de trabalho superior.
Escopos delegados necessários
SemanticModel.ReadWrite.All ou Item.ReadWrite.All
Identidades com suporte do Microsoft Entra
Esta API dá suporte às identidades do Microsoft listadas nesta seção.
Identidade | Apoio |
---|---|
Utilizador | Sim |
entidade de serviço e identidades gerenciadas | Sim |
Interface
PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/semanticModels/{semanticModelId}
Parâmetros de URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
semantic
|
path | True |
string uuid |
A ID do modelo semântico. |
workspace
|
path | True |
string uuid |
A ID do workspace. |
Corpo da solicitação
Nome | Tipo | Description |
---|---|---|
description |
string |
A descrição do modelo semântico. O comprimento máximo é de 256 caracteres. |
displayName |
string |
O nome de exibição do modelo semântico. O nome de exibição deve seguir regras de nomenclatura de acordo com o tipo de item. |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
Solicitação concluída com êxito. |
|
Other Status Codes |
Códigos de erro comuns:
|
Exemplos
Update a semantic model example
Solicitação de exemplo
PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff255/semanticModels/5b218778-e7a5-4d73-8187-f10824047751
{
"displayName": "Semantic models's New name",
"description": "A new description for semantic model."
}
Resposta de exemplo
{
"displayName": "Semantic models's New name",
"description": "A new description for semantic model.",
"type": "SemanticModel",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff255",
"id": "5b218778-e7a5-4d73-8187-f10824047751"
}
Definições
Nome | Description |
---|---|
Error |
O objeto de detalhes do recurso relacionado ao erro. |
Error |
A resposta de erro. |
Error |
Os detalhes da resposta de erro. |
Item |
O tipo do item. Tipos de item adicionais podem ser adicionados ao longo do tempo. |
Semantic |
Um objeto de modelo semântico. |
Update |
Atualizar solicitação de modelo semântico. |
ErrorRelatedResource
O objeto de detalhes do recurso relacionado ao erro.
Nome | Tipo | Description |
---|---|---|
resourceId |
string |
A ID do recurso envolvida no erro. |
resourceType |
string |
O tipo do recurso envolvido no erro. |
ErrorResponse
A resposta de erro.
Nome | Tipo | Description |
---|---|---|
errorCode |
string |
Um identificador específico que fornece informações sobre uma condição de erro, permitindo a comunicação padronizada entre nosso serviço e seus usuários. |
message |
string |
Uma representação legível humana do erro. |
moreDetails |
Lista de detalhes de erro adicionais. |
|
relatedResource |
Os detalhes do recurso relacionado ao erro. |
|
requestId |
string |
ID da solicitação associada ao erro. |
ErrorResponseDetails
Os detalhes da resposta de erro.
Nome | Tipo | Description |
---|---|---|
errorCode |
string |
Um identificador específico que fornece informações sobre uma condição de erro, permitindo a comunicação padronizada entre nosso serviço e seus usuários. |
message |
string |
Uma representação legível humana do erro. |
relatedResource |
Os detalhes do recurso relacionado ao erro. |
ItemType
O tipo do item. Tipos de item adicionais podem ser adicionados ao longo do tempo.
Valor | Description |
---|---|
Dashboard |
Painel do PowerBI. |
DataPipeline |
Um pipeline de dados. |
Datamart |
Datamart do PowerBI. |
Environment |
Um ambiente. |
Eventhouse |
Uma casa de eventos. |
Eventstream |
Um fluxo de eventos. |
GraphQLApi |
Um item de API para GraphQL. |
KQLDashboard |
Um painel KQL. |
KQLDatabase |
Um banco de dados KQL. |
KQLQueryset |
Um conjunto de consultas KQL. |
Lakehouse |
Uma casa no lago. |
MLExperiment |
Um experimento de aprendizado de máquina. |
MLModel |
Um modelo de machine learning. |
MirroredDatabase |
Um banco de dados espelhado. |
MirroredWarehouse |
Um armazém espelhado. |
MountedDataFactory |
Um MountedDataFactory. |
Notebook |
Um bloco de anotações. |
PaginatedReport |
Relatório paginado do PowerBI. |
Reflex |
Um Reflexo. |
Report |
Relatório do PowerBI. |
SQLDatabase |
Um SQLDatabase. |
SQLEndpoint |
Um ponto de extremidade SQL. |
SemanticModel |
Modelo semântico do PowerBI. |
SparkJobDefinition |
Uma definição de trabalho do Spark. |
Warehouse |
Um armazém. |
SemanticModel
Um objeto de modelo semântico.
Nome | Tipo | Description |
---|---|---|
description |
string |
A descrição do item. |
displayName |
string |
O nome de exibição do item. |
id |
string uuid |
A ID do item. |
type |
O tipo de item. |
|
workspaceId |
string uuid |
A ID do workspace. |
UpdateSemanticModelRequest
Atualizar solicitação de modelo semântico.
Nome | Tipo | Description |
---|---|---|
description |
string |
A descrição do modelo semântico. O comprimento máximo é de 256 caracteres. |
displayName |
string |
O nome de exibição do modelo semântico. O nome de exibição deve seguir regras de nomenclatura de acordo com o tipo de item. |