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 no(s) item(ns) desde o último espaço de trabalho e sincronização de ramificação remota. Se ambos os locais foram modificados, a API sinaliza um conflito.
Permissões
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
Identidades suportadas pelo Microsoft Entra
Esta API suporta as identidades do Microsoft listadas nesta secção.
Identidade | Suporte |
---|---|
Utilizador | Sim |
da entidade de serviço e identidades gerenciadas | Não |
Interface
GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/status
Parâmetros do URI
Name | Em | Necessário | Tipo | Description |
---|---|---|---|---|
workspace
|
path | True |
string uuid |
O ID do espaço de trabalho. |
Respostas
Name | Tipo | Description |
---|---|---|
200 OK |
Pedido concluído com sucesso. |
|
202 Accepted |
Pedido aceite, obter o estado em curso. Cabeçalhos
|
|
Other Status Codes |
Códigos de erro comuns:
|
Exemplos
Get status example |
Get status no changes example |
Get status with conflict 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
Definições
Name | Description |
---|---|
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 |
O objeto de detalhes do recurso relacionado ao erro. |
Error |
A resposta de erro. |
Error |
Os detalhes da resposta de erro. |
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 | Description |
---|---|
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 | Description |
---|---|
Conflict |
Há diferentes alterações no item no espaço de trabalho e no Git remoto. |
None |
Não há alterações no item. |
SameChanges |
Há alterações idênticas no item no espaço de trabalho e no Git remoto. |
ErrorRelatedResource
O objeto de detalhes do recurso relacionado ao erro.
Name | Tipo | Description |
---|---|---|
resourceId |
string |
A ID do recurso envolvida no erro. |
resourceType |
string |
O tipo de recurso envolvido no erro. |
ErrorResponse
A resposta de erro.
Name | Tipo | Description |
---|---|---|
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. |
moreDetails |
Lista de detalhes de erro adicionais. |
|
relatedResource |
Os detalhes do recurso relacionados ao erro. |
|
requestId |
string |
ID da solicitação associada ao erro. |
ErrorResponseDetails
Os detalhes da resposta de erro.
Name | Tipo | Description |
---|---|---|
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. |
relatedResource |
Os detalhes do recurso relacionados ao erro. |
GitStatusResponse
Contém a resposta de status.
Name | Tipo | Description |
---|---|---|
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.
Name | Tipo | Description |
---|---|---|
conflictType |
Quando há alterações no lado do espaço de trabalho e no lado remoto do Git. |
|
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.
Name | Tipo | Description |
---|---|---|
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.
Name | Tipo | Description |
---|---|---|
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 | 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 |
Uma API para o item GraphQL. |
KQLDashboard |
Um painel KQL. |
KQLDatabase |
Um banco de dados KQL. |
KQLQueryset |
Um conjunto de consultas KQL. |
Lakehouse |
Uma casa no lago. |
MLExperiment |
Uma experiência de aprendizagem automática. |
MLModel |
Um modelo de aprendizagem automática. |
MirroredDatabase |
Um banco de dados espelhado. |
MirroredWarehouse |
Um armazém espelhado. |
MountedDataFactory |
Um MountedDataFactory. |
Notebook |
Um caderno. |
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 de faísca. |
Warehouse |
Um armazém. |