Items - Update Item
Atualiza as propriedades do item especificado.
Essa API tem suporte para vários tipos de item, encontre os tipos de item com suporte e informações sobre sua estrutura de definição em Visão geral do gerenciamento de itens.
Permissões
O chamador deve ter função de colaborador ou superior no workspace.
Escopos delegados necessários
Para APIs de item, use estes tipos de escopo:
- Escopo genérico: Item.ReadWrite.All
- Escopo específico: itemType. ReadWrite.All (por exemplo: Notebook.ReadWrite.All)
para obter mais informações sobre escopos, consulte: artigo de escopos.
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 | Quando há suporte para o tipo de item na chamada. Verifique a API correspondente para o tipo de item que você está chamando para ver se a chamada tem suporte. Por exemplo, há suporte para modelos semânticos. |
Interface
PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
item
|
path | True |
string uuid |
A ID do item. |
|
workspace
|
path | True |
string uuid |
A ID do workspace. |
Corpo da solicitação
| Nome | Tipo | Description |
|---|---|---|
| description |
string |
A descrição do item. O comprimento máximo é de 256 caracteres. |
| displayName |
string |
O nome de exibição do item. 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 an item example
Solicitação de exemplo
PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715
{
"displayName": "Item's New name",
"description": "Item's New description"
}
Resposta de exemplo
{
"displayName": "Item's New name",
"description": "Item's New description",
"type": "Lakehouse",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715"
}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 |
Um objeto de item. |
|
Item |
O tipo do item. Tipos de item adicionais podem ser adicionados ao longo do tempo. |
|
Update |
Atualizar solicitação de item. |
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. |
Item
Um objeto de item.
| 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. |
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. |
UpdateItemRequest
Atualizar solicitação de item.
| Nome | Tipo | Description |
|---|---|---|
| description |
string |
A descrição do item. O comprimento máximo é de 256 caracteres. |
| displayName |
string |
O nome de exibição do item. O nome de exibição deve seguir regras de nomenclatura de acordo com o tipo de item. |