Git - Get Status

Servizio:: Core

Versione API:: v1

Restituisce il Git status di elementi nell'area di lavoro, di cui è possibile eseguire il commit in Git.
Questa API supporta operazioni con esecuzione prolungata (LRO).

Lo stato indica le modifiche apportate agli elementi dall'ultima area di lavoro e dalla sincronizzazione remota dei rami. Se gli elementi remoti e dell'area di lavoro sono stati modificati entrambi, l'API contrassegna un conflitto.

Per usare questa API, è necessario configurare le credenziali Git del chiamante usando l'API Aggiorna credenziali Git personali. È possibile usare l'API Get My Git Credentials (Ottieni credenziali Git personali ) per controllare la configurazione delle credenziali Git.

Permissions

Il chiamante deve avere un ruolo di collaboratore o superiore dell'area di lavoro.

Ambiti delegati obbligatori

Workspace.GitUpdate.All o Workspace.GitCommit.All

Identità supportate da Microsoft Entra

Questa API supporta le identità di Microsoft elencate in questa sezione.

Identity	Support
User	Yes
Principale del servizio e Identità gestite	Yes

Interface

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
workspaceId	path	True	string (uuid)	ID dell'area di lavoro.

Risposte

Nome	Tipo	Descrizione
200 OK	GitStatusResponse	Richiesta completata correttamente.
202 Accepted		Richiesta accettata, ottenere lo stato in corso. Intestazioni Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Codici di errore comuni: WorkspaceNotConnectedToGit: l'area di lavoro non è connessa a Git. WorkspaceHasNoCapacityAssigned: l'area di lavoro non è in capacità. InsufficientPrivileges: il chiamante non dispone di autorizzazioni sufficienti per l'area di lavoro. PrincipalTypeNotSupported: il tipo di identità del chiamante non è supportato.

Nome

Tipo

Descrizione

200 OK

GitStatusResponse

Richiesta completata correttamente.

202 Accepted

Richiesta accettata, ottenere lo stato in corso.

Intestazioni

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

Codici di errore comuni:

WorkspaceNotConnectedToGit: l'area di lavoro non è connessa a Git.
WorkspaceHasNoCapacityAssigned: l'area di lavoro non è in capacità.
InsufficientPrivileges: il chiamante non dispone di autorizzazioni sufficienti per l'area di lavoro.
PrincipalTypeNotSupported: il tipo di identità del chiamante non è supportato.

Esempio

Get status example

Get status no changes example

Get status with conflict example

Get status example

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 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"
    }
  ]
}

Codice di stato:: 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

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 200

{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "changes": []
}

Codice di stato:: 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

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 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"
    }
  ]
}

Codice di stato:: 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

Definizioni

Nome	Descrizione
ChangeType	Modifica di un elemento. È possibile aggiungere altri tipi modificati nel tempo.
ConflictType	Modifica di un elemento sia nell'area di lavoro che in remoto. È possibile aggiungere altri tipi modificati nel tempo.
ErrorRelatedResource	Oggetto dettagli risorsa correlato all'errore.
ErrorResponse	Risposta di errore.
ErrorResponseDetails	Dettagli della risposta di errore.
GitStatusResponse	Contiene la risposta di stato.
ItemChange	Contiene le informazioni sulle modifiche dell'elemento.
ItemIdentifier	Contiene l'identificatore dell'elemento. È necessario definire almeno una delle proprietà.
ItemMetadata	Contiene i metadati dell'elemento.
ItemType	Tipo dell'elemento. È possibile aggiungere altri tipi di elemento nel tempo.

ChangeType

Enumerazione

Modifica di un elemento. È possibile aggiungere altri tipi modificati nel tempo.

Valore	Descrizione
Added	Elemento appena creato.
Deleted	L'elemento è stato eliminato.
Modified	Il contenuto dell'elemento è stato modificato.

ConflictType

Enumerazione

Modifica di un elemento sia nell'area di lavoro che in remoto. È possibile aggiungere altri tipi modificati nel tempo.

Valore	Descrizione
None	Non sono state apportate modifiche all'elemento.
Conflict	Sono state apportate modifiche diverse all'elemento nell'area di lavoro e in Git remoto.
SameChanges	Sono state apportate modifiche identiche all'elemento nell'area di lavoro e in Git remoto.

ErrorRelatedResource

Oggetto

Oggetto dettagli risorsa correlato all'errore.

Nome	Tipo	Descrizione
resourceId	string	ID risorsa coinvolto nell'errore.
resourceType	string	Tipo della risorsa coinvolta nell'errore.

ErrorResponse

Oggetto

Risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message	string	Rappresentazione leggibile dell'errore.
moreDetails	ErrorResponseDetails[]	Elenco di dettagli aggiuntivi sull'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.
requestId	string	ID della richiesta associata all'errore.

ErrorResponseDetails

Oggetto

Dettagli della risposta di errore.

Nome	Tipo	Descrizione
errorCode	string	Identificatore specifico che fornisce informazioni su una condizione di errore, consentendo la comunicazione standardizzata tra il servizio e i relativi utenti.
message	string	Rappresentazione leggibile dell'errore.
relatedResource	ErrorRelatedResource	Dettagli della risorsa correlati all'errore.

GitStatusResponse

Oggetto

Contiene la risposta di stato.

Nome	Tipo	Descrizione
changes	ItemChange[]	Elenco delle modifiche in Git remoto non applicate all'area di lavoro specificata e modifiche nell'area di lavoro non applicate a Git remoto.
remoteCommitHash	string	Hash di commit SHA completo remoto.
workspaceHead	string	Hash SHA completo in cui è sincronizzata l'area di lavoro.

ItemChange

Oggetto

Contiene le informazioni sulle modifiche dell'elemento.

Nome	Tipo	Descrizione
conflictType	ConflictType	Quando sono presenti modifiche sia sul lato area di lavoro che sul lato Git remoto.
itemMetadata	ItemMetadata	Metadati dell'elemento.
remoteChange	ChangeType	Cambiare sul lato Git remoto.
workspaceChange	ChangeType	Modificare sul lato area di lavoro.

ItemIdentifier

Oggetto

Contiene l'identificatore dell'elemento. È necessario definire almeno una delle proprietà.

Nome	Tipo	Descrizione
logicalId	string (uuid)	ID logico dell'elemento. Quando l'ID logico non è disponibile perché l'elemento non è ancora stato aggiunto all'area di lavoro, è possibile usare l'ID oggetto.
objectId	string (uuid)	ID oggetto dell'elemento. Quando l'ID oggetto non è disponibile perché l'elemento è stato eliminato dall'area di lavoro, è possibile usare l'ID logico.

ItemMetadata

Oggetto

Contiene i metadati dell'elemento.

Nome	Tipo	Descrizione
displayName	string	Nome visualizzato dell'elemento. Preferisce il nome visualizzato dell'elemento dell'area di lavoro, se esistente, altrimenti displayName usa il nome visualizzato dell'elemento remoto.
itemIdentifier	ItemIdentifier	Identificatore dell'elemento.
itemType	ItemType	Tipo di elemento.

ItemType

Enumerazione

Tipo dell'elemento. È possibile aggiungere altri tipi di elemento nel tempo.

Valore	Descrizione
Dashboard	Dashboard di Power BI.
Report	Report di Power BI.
SemanticModel	Modello semantico di PowerBI.
PaginatedReport	Report impaginato di Power BI.
Datamart	Datamart di PowerBI.
Lakehouse	Una lakehouse.
Eventhouse	Una casa eventi.
Environment	Un ambiente.
KQLDatabase	Un database KQL.
KQLQueryset	Set di query KQL.
KQLDashboard	Dashboard KQL.
DataPipeline	Una pipeline di dati.
Notebook	Un notebook.
SparkJobDefinition	Definizione di processo Spark.
MLExperiment	Esperimento di Machine Learning.
MLModel	Modello di Machine Learning.
Warehouse	Un magazzino.
Eventstream	Flusso di eventi.
SQLEndpoint	Endpoint SQL.
MirroredWarehouse	Magazzino con mirroring.
MirroredDatabase	Database con mirroring.
Reflex	Un riflesso.
GraphQLApi	API per l'elemento GraphQL.
MountedDataFactory	Oggetto MountedDataFactory.
SQLDatabase	A SQLDatabase.
CopyJob	Processo di copia.
VariableLibrary	VariabileLibrary.
Dataflow	Flusso di dati.
ApacheAirflowJob	An ApacheAirflowJob.
WarehouseSnapshot	Uno snapshot del warehouse.
DigitalTwinBuilder	A DigitalTwinBuilder.
DigitalTwinBuilderFlow	Flusso di Generatore di gemelli digitali.
MirroredAzureDatabricksCatalog	Catalogo di Azure databricks con mirroring.
Map	Una mappa.
AnomalyDetector	Rilevamento anomalie.
UserDataFunction	Funzione dati utente.
GraphModel	A GraphModel.
GraphQuerySet	Oggetto Graph QuerySet.
SnowflakeDatabase	Un database Snowflake per archiviare le tabelle Iceberg create dall'account Snowflake.
OperationsAgent	Oggetto OperationsAgent.
CosmosDBDatabase	Un database Cosmos DB.

Condividi tramite

Git - Get Status

Permissions

Ambiti delegati obbligatori

Identità supportate da Microsoft Entra

Interface

Parametri dell'URI

Risposte

Esempio

Get status example

Esempio di richiesta

Risposta di esempio

Get status no changes example

Esempio di richiesta

Risposta di esempio

Get status with conflict example

Esempio di richiesta

Risposta di esempio

Definizioni

ChangeType

ConflictType

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GitStatusResponse

ItemChange

ItemIdentifier

ItemMetadata

ItemType