Compartilhar via

Git - Get Status

  • Referência
Serviço:
Core
Versão da API:
v1

Retorna o Git status de itens no workspace, que podem ser confirmados no Git.
Essa API dá suporte a LRO (operações de execução longa).

O status indica alterações nos itens desde o último workspace e a sincronização de ramificação remota. Se ambos os locais foram modificados, a API sinaliza um conflito.

Permissões

O chamador deve ter um colaborador ou uma função de workspace superior.

Escopos delegados necessários

Workspace.GitUpdate.All ou Workspace.GitCommit.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 Não

Interface

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/status

Parâmetros de URI

Nome Em Obrigatório Tipo Description
workspaceId
 path True

string

uuid

A ID do workspace.

Respostas

Nome Tipo Description
200 OK

GitStatusResponse

Solicitação concluída com êxito.
202 Accepted

Solicitação aceita, obter status em andamento.

Cabeçalhos

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Códigos de erro comuns:

  • WorkspaceNotConnectedToGit – O workspace não está conectado ao git.

  • WorkspaceHasNoCapacityAssigned – O workspace não está em capacidade.

  • InsufficientPrivileges - O chamador não tem permissões de workspace suficientes.

Exemplos

Get status example
Get status no changes example
Get status with conflict example

Get status example

Solicitação de exemplo

GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/status

Resposta de exemplo

Código de status:
200 
{
  "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"
    }
  ]
}
Código de status:
202 
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

Solicitação de exemplo

GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/status

Resposta de exemplo

Código de status:
200 
{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "changes": []
}
Código de status:
202 
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

Solicitação de exemplo

GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/status

Resposta de exemplo

Código de status:
200 
{
  "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"
    }
  ]
}
Código de status:
202 
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 Description
ChangeType

Uma alteração de um item. Tipos alterados adicionais podem ser adicionados ao longo do tempo.
ConflictType

Uma alteração de um item no workspace e no remoto. Tipos alterados adicionais podem ser adicionados ao longo do tempo.
ErrorRelatedResource

O objeto de detalhes do recurso relacionado ao erro.
ErrorResponse

A resposta de erro.
ErrorResponseDetails

Os detalhes da resposta de erro.
GitStatusResponse

Contém a resposta de status.
ItemChange

Contém as informações de alteração do item.
ItemIdentifier

Contém o identificador do item. Pelo menos uma das propriedades deve ser definida.
ItemMetadata

Contém os metadados do item.
ItemType

O tipo do item. Tipos de item adicionais podem ser adicionados ao longo do tempo.

ChangeType

Enumeração

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

Enumeração

Uma alteração de um item no workspace e no remoto. Tipos alterados adicionais podem ser adicionados ao longo do tempo.

Valor Description
Conflict

Há alterações diferentes no item no workspace e no Git remoto.
None

Não há alterações no item.
SameChanges

Há alterações idênticas no item no workspace e no Git remoto.

ErrorRelatedResource

Objeto

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

Objeto

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

ErrorResponseDetails[]

Lista de detalhes de erro adicionais.
relatedResource

ErrorRelatedResource

Os detalhes do recurso relacionado ao erro.
requestId

string

ID da solicitação associada ao erro.

ErrorResponseDetails

Objeto

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

ErrorRelatedResource

Os detalhes do recurso relacionado ao erro.

GitStatusResponse

Objeto

Contém a resposta de status.

Nome Tipo Description
changes

ItemChange[]

Uma lista de alterações no Git remoto que não são aplicadas ao workspace fornecido e alterações no workspace que não são aplicadas ao Git remoto.
remoteCommitHash

string

Hash de confirmação SHA completo remoto.
workspaceHead

string

Hash SHA completo ao qual o workspace está sincronizado.

ItemChange

Objeto

Contém as informações de alteração do item.

Nome Tipo Description
conflictType

ConflictType

Quando há alterações no lado do workspace e no lado remoto do Git.
itemMetadata

ItemMetadata

Os metadados do item.
remoteChange

ChangeType

Altere no lado remoto do Git.
workspaceChange

ChangeType

Alterar no lado do workspace.

ItemIdentifier

Objeto

Contém o identificador do item. Pelo menos uma das propriedades deve ser definida.

Nome 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 workspace, você poderá usar a ID do objeto.
objectId

string

uuid

A ID do objeto do item. Quando a ID do objeto não está disponível porque o item foi excluído do workspace, você pode usar a ID lógica.

ItemMetadata

Objeto

Contém os metadados do item.

Nome Tipo Description
displayName

string

O nome de exibição do item. Prefere o nome de exibição do item de workspace se ele existir, caso contrário, displayName usará o nome de exibição do item remoto.
itemIdentifier

ItemIdentifier

O identificador do item.
itemType

ItemType

O tipo de item.

ItemType

Enumeração

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.