Git - Get Status
Retorna o Git status de itens no espaço de trabalho que podem ser confirmados no Git.
Esta API suporta operações de longa duração (LRO).
O status indica alterações nos itens desde o último espaço de trabalho e sincronização de ramificação remota. Se os itens remoto e de espaço de trabalho foram modificados, a API sinaliza um conflito. A API não deve ser chamada enquanto a operação Update From Git está em execução.
Para usar essa API, as credenciais do Git do chamador devem ser configuradas usando Update My Git Credentials API. Você pode usar a API Get My Git Credentials para verificar a configuração das credenciais do Git.
Permissions
O chamador deve ter uma função de de espaço de trabalho de contribuidor ou superior.
Escopos delegados necessários
Workspace.GitUpdate.All ou Workspace.GitCommit.All
Limites de limitação
| Tipo de Limite | Value |
|---|---|
| Quota Unificada para APIs de Plataforma | 500 chamadas/min |
| Limite da API | 50 chamadas/min |
Identidades suportadas pelo Microsoft Entra
Esta API suporta as identidades do Microsoft listadas nesta secção.
| Identity | Support |
|---|---|
| User | Yes |
| Principal de serviço e identidades geridas | Yes |
Interface
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/status
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/status?includeFilesDetails={includeFilesDetails}
Parâmetros do URI
| Nome | Em | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
workspace
|
path | True |
string (uuid) |
O ID do espaço de trabalho. |
|
include
|
query |
boolean |
Quando verdade, cada alteração de item na resposta inclui um array de ficheirosAlterações com detalhes de alteração por ficheiro. |
Respostas
| Nome | Tipo | Descrição |
|---|---|---|
| 200 OK |
Pedido concluído com sucesso. |
|
| 202 Accepted |
Pedido aceite, obter o estado em curso. Cabeçalhos
|
|
| 429 Too Many Requests |
O limite de tarifa de serviço foi ultrapassado. O servidor devolve um Cabeçalhos Retry-After: integer |
|
| Other Status Codes |
Códigos de erro comuns:
|
Exemplos
| Get status example |
| Get status no changes example |
| Get status with conflict example |
| Get status with file details example |
Get status example
Pedido de amostra
GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/status
Resposta da amostra
{
"workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
"remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705",
"changes": [
{
"itemMetadata": {
"itemIdentifier": {
"objectId": "7753f3b4-dbb8-44c1-a94f-6ae4d776369e"
},
"itemType": "SemanticModel",
"displayName": "My new dataset in the workspace"
},
"workspaceChange": "Added",
"conflictType": "None"
},
{
"itemMetadata": {
"itemIdentifier": {
"logicalId": "1423f3b4-dba5-44c1-a94f-6ae4d776369a"
},
"itemType": "Report",
"displayName": "My deleted report in Git"
},
"remoteChange": "Deleted",
"conflictType": "None"
},
{
"itemMetadata": {
"itemIdentifier": {
"logicalId": "111e8d7b-4a95-4c02-8ccd-6faef5ba1bd1",
"objectId": "1153f3b4-dbb8-33c1-a84f-6ae4d776362d"
},
"itemType": "SemanticModel",
"displayName": "Modified dataset in the workspace"
},
"workspaceChange": "Modified",
"conflictType": "None"
}
]
}
Location: https://api.fabric.microsoft.com/v1/operations/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
x-ms-operation-id: 431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
Retry-After: 30
Get status no changes example
Pedido de amostra
GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/status
Resposta da amostra
{
"workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
"remoteCommitHash": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
"changes": []
}
Location: https://api.fabric.microsoft.com/v1/operations/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
x-ms-operation-id: 431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
Retry-After: 30
Get status with conflict example
Pedido de amostra
GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/status
Resposta da amostra
{
"workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
"remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705",
"changes": [
{
"itemMetadata": {
"itemIdentifier": {
"logicalId": "222e8d7b-4a95-4c02-8ccd-6faef5ba1bd2",
"objectId": "8853f3b4-dbb8-33c1-a84f-6ae4d776362a"
},
"itemType": "Report",
"displayName": "Modified report on both sides"
},
"remoteChange": "Modified",
"workspaceChange": "Modified",
"conflictType": "Conflict"
}
]
}
Location: https://api.fabric.microsoft.com/v1/operations/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
x-ms-operation-id: 431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
Retry-After: 30
Get status with file details example
Pedido de amostra
GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/status?includeFilesDetails=True
Resposta da amostra
{
"workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
"remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705",
"changes": [
{
"itemMetadata": {
"itemIdentifier": {
"objectId": "cfafbeb1-8037-4d0c-896e-28c4f2e65573"
},
"itemType": "Notebook",
"displayName": "MyNotebook"
},
"workspaceChange": "Modified",
"remoteChange": "Modified",
"conflictType": "Conflict",
"fileChanges": [
{
"path": "notebook-content.py",
"workspaceChange": "Modified",
"remoteChange": "Modified",
"conflictType": "Conflict"
},
{
"path": "metadata.json",
"workspaceChange": "Modified",
"conflictType": "None"
},
{
"path": "config/settings.json",
"remoteChange": "Added",
"conflictType": "None"
}
]
},
{
"itemMetadata": {
"itemIdentifier": {
"objectId": "d5a2b3c4-1234-5678-abcd-ef0123456789"
},
"itemType": "Report",
"displayName": "SalesReport"
},
"workspaceChange": "Modified",
"conflictType": "None",
"fileChanges": [
{
"path": "pages/page1.json",
"workspaceChange": "Modified",
"conflictType": "None"
}
]
}
]
}
Location: https://api.fabric.microsoft.com/v1/operations/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
x-ms-operation-id: 431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
Retry-After: 30
Definições
| Nome | Descrição |
|---|---|
|
Change |
Uma alteração de um item. Tipos alterados adicionais podem ser adicionados ao longo do tempo. |
|
Conflict |
Uma alteração de um item no espaço de trabalho e remoto. Tipos alterados adicionais podem ser adicionados ao longo do tempo. |
|
Error |
Um parâmetro estruturado que fornece contexto adicional legível por máquina sobre um erro. |
|
Error |
O objeto de detalhes do recurso relacionado ao erro. |
|
Error |
A resposta de erro. |
|
Error |
Os detalhes da resposta de erro. |
|
Git |
Contém informações sobre uma alteração ao nível do ficheiro dentro de um item. |
|
Git |
Contém a resposta de status. |
|
Item |
Contém as informações de alteração do item. |
|
Item |
Contém o identificador do item. Pelo menos uma das propriedades deve ser definida. |
|
Item |
Contém os metadados do item. |
|
Item |
O tipo do item. Tipos de itens adicionais podem ser adicionados ao longo do tempo. |
ChangeType
Uma alteração de um item. Tipos alterados adicionais podem ser adicionados ao longo do tempo.
| Valor | Descrição |
|---|---|
| Added |
Um item recém-criado. |
| Deleted |
O item foi excluído. |
| Modified |
O conteúdo do item foi modificado. |
ConflictType
Uma alteração de um item no espaço de trabalho e remoto. Tipos alterados adicionais podem ser adicionados ao longo do tempo.
| Valor | Descrição |
|---|---|
| None |
Não há alterações no item. |
| Conflict |
Há diferentes alterações no item no espaço de trabalho e no Git remoto. |
| SameChanges |
Há alterações idênticas no item no espaço de trabalho e no Git remoto. |
ErrorParameter
Um parâmetro estruturado que fornece contexto adicional legível por máquina sobre um erro.
| Nome | Tipo | Descrição |
|---|---|---|
| message |
string |
Uma descrição legível para humanos do significado do parâmetro. |
| name |
string |
O identificador de parâmetro. |
| value |
string |
O valor do parâmetro. |
ErrorRelatedResource
O objeto de detalhes do recurso relacionado ao erro.
| Nome | Tipo | Descrição |
|---|---|---|
| resourceId |
string |
A ID do recurso envolvida no erro. |
| resourceType |
string |
O tipo de recurso envolvido no erro. |
ErrorResponse
A resposta de erro.
| Nome | Tipo | Descrição |
|---|---|---|
| errorCode |
string |
Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários. |
| isRetriable |
boolean |
Quando confirmado, o pedido pode ser retentado. Use o |
| message |
string |
Uma representação legível por humanos do erro. |
| moreDetails |
Lista de detalhes de erro adicionais. |
|
| parameters |
Parâmetros estruturados que fornecem contexto adicional legível pela máquina sobre o erro. |
|
| relatedResource |
Os detalhes do recurso relacionados ao erro. |
|
| requestId |
string (uuid) |
ID da solicitação associada ao erro. |
ErrorResponseDetails
Os detalhes da resposta de erro.
| Nome | Tipo | Descrição |
|---|---|---|
| errorCode |
string |
Um identificador específico que fornece informações sobre uma condição de erro, permitindo uma comunicação padronizada entre nosso serviço e seus usuários. |
| message |
string |
Uma representação legível por humanos do erro. |
| parameters |
Parâmetros estruturados que fornecem contexto adicional legível pela máquina sobre o erro. |
|
| relatedResource |
Os detalhes do recurso relacionados ao erro. |
GitFileChange
Contém informações sobre uma alteração ao nível do ficheiro dentro de um item.
| Nome | Tipo | Descrição |
|---|---|---|
| conflictType |
O estado de conflito para este ficheiro. |
|
| path |
string |
O caminho do ficheiro relativo à raiz do item. Utiliza cortes para a frente e não tem corte para a frente. |
| remoteChange |
Mude no lado remoto do Git. |
|
| workspaceChange |
Altere no lado do espaço de trabalho. |
GitStatusResponse
Contém a resposta de status.
| Nome | Tipo | Descrição |
|---|---|---|
| changes |
Uma lista de alterações no Git remoto que não são aplicadas ao espaço de trabalho específico e alterações no espaço de trabalho que não são aplicadas ao Git remoto. |
|
| remoteCommitHash |
string |
Hash de confirmação SHA completo remoto. |
| workspaceHead |
string |
Hash SHA completo com o qual o espaço de trabalho está sincronizado. |
ItemChange
Contém as informações de alteração do item.
| Nome | Tipo | Descrição |
|---|---|---|
| conflictType |
Quando há alterações no lado do espaço de trabalho e no lado remoto do Git. |
|
| fileChanges |
Uma lista de alterações ao nível do ficheiro dentro do item. Só é preenchido quando o parâmetro de consulta includeFilesDetails está definido como true. |
|
| itemMetadata |
Os metadados do item. |
|
| remoteChange |
Mude no lado remoto do Git. |
|
| workspaceChange |
Altere no lado do espaço de trabalho. |
ItemIdentifier
Contém o identificador do item. Pelo menos uma das propriedades deve ser definida.
| Nome | Tipo | Descrição |
|---|---|---|
| logicalId |
string (uuid) |
A ID lógica do item. Quando a ID lógica não estiver disponível porque o item ainda não foi adicionado ao espaço de trabalho, você poderá usar a ID do objeto. |
| objectId |
string (uuid) |
A ID do objeto do item. Quando a ID do objeto não estiver disponível porque o item foi excluído do espaço de trabalho, você poderá usar a ID lógica. |
ItemMetadata
Contém os metadados do item.
| Nome | Tipo | Descrição |
|---|---|---|
| displayName |
string |
O nome para exibição do item. Prefere o nome de exibição do item de espaço de trabalho se ele existir, caso contrário, displayName usa o nome de exibição do item remoto. |
| itemIdentifier |
O identificador do item. |
|
| itemType |
O tipo de item. |
ItemType
O tipo do item. Tipos de itens adicionais podem ser adicionados ao longo do tempo.
| Valor | Descrição |
|---|---|
| Dashboard |
Painel do PowerBI. |
| Report |
Relatório do PowerBI. |
| SemanticModel |
Modelo semântico do PowerBI. |
| PaginatedReport |
Relatório paginado do PowerBI. |
| Datamart |
Datamart do PowerBI. |
| Lakehouse |
Uma casa no lago. |
| Eventhouse |
Uma casa de eventos. |
| Environment |
Um ambiente. |
| KQLDatabase |
Um banco de dados KQL. |
| KQLQueryset |
Um conjunto de consultas KQL. |
| KQLDashboard |
Um painel KQL. |
| DataPipeline |
Um pipeline de dados. |
| Notebook |
Um caderno. |
| SparkJobDefinition |
Uma definição de trabalho de faísca. |
| MLExperiment |
Uma experiência de aprendizagem automática. |
| MLModel |
Um modelo de aprendizagem automática. |
| Warehouse |
Um armazém. |
| Eventstream |
Um fluxo de eventos. |
| SQLEndpoint |
Um ponto de extremidade SQL. |
| MirroredWarehouse |
Um armazém espelhado. |
| MirroredDatabase |
Um banco de dados espelhado. |
| Reflex |
Um reflexo. |
| GraphQLApi |
Uma API para o item GraphQL. |
| MountedDataFactory |
Um MountedDataFactory. |
| SQLDatabase |
Um SQLDatabase. |
| CopyJob |
Um trabalho de cópia. |
| VariableLibrary |
Uma VariableLibrary. |
| Dataflow |
Um fluxo de dados. |
| ApacheAirflowJob |
Um ApacheAirflowJob. |
| WarehouseSnapshot |
Um instantâneo do Warehouse. |
| DigitalTwinBuilder |
Um DigitalTwinBuilder. |
| DigitalTwinBuilderFlow |
Um fluxo de construtor de gêmeos digitais. |
| MirroredAzureDatabricksCatalog |
Um catálogo de databricks azure espelhado. |
| Map |
Um mapa. |
| AnomalyDetector |
Um detetor de anomalias. |
| UserDataFunction |
Uma função de dados do usuário. |
| GraphModel |
Um GraphModel. |
| GraphQuerySet |
Um Graph QuerySet. |
| SnowflakeDatabase |
Uma base de dados Snowflake para armazenar tabelas Iceberg criadas a partir da conta Snowflake. |
| OperationsAgent |
Um Agente de Operações. |
| CosmosDBDatabase |
Uma base de dados Cosmos DB. |
| Ontology |
Uma ontologia. |
| EventSchemaSet |
Um EventoSchemaSet. |
| DataAgent |
Um DataAgent. |
| MirroredCatalog |
Um Catálogo Espelhado. |
| PolicySet |
Um Conjunto de Políticas. |
| AppBackend |
Um AppBackend. |
| OrgApp |
Uma aplicação de organização. |
| OrgAppAudience |
Uma audiência de Org App. |
| DataBuildToolJob |
Um DataBuildToolJob. |
| AzureDatabricksStorage |
Um item de armazenamento apoiado por OneLake para Azure Databricks. |
| Plan |
Um plano. |
| Monitoring |
Um item de monitorização. |
| DeploymentPlan |
Um plano de desdobramento. |
| ShareSubscription |
Uma subscrição de partilha. |
| Share |
Uma parte. |
| Playbook |
Um manual de jogadas. |
| MirroredOneLake |
Um item espelhado do OneLake. |
| PostgreSQLDatabase |
Um item da base de dados PostgreSQL no Microsoft Fabric. |
| CustomStreamConnector |
Um item de Conector de Fluxo Personalizado no Microsoft Fabric. |