Condividi tramite

Git - Get Status

  • Riferimento
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 entrambe le posizioni sono state modificate, l'API contrassegna un conflitto.

Autorizzazioni

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.

Identità Appoggiare
Utente Sì
'entità servizio e identità gestite No

Interfaccia

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.

Esempio

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

Get status example

Esempio di richiesta

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

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

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

Enumeration

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

Enumeration

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

Valore Descrizione
Conflict

Sono state apportate modifiche diverse all'elemento nell'area di lavoro e in Git remoto.
None

Non sono state apportate modifiche all'elemento.
SameChanges

Sono state apportate modifiche identiche all'elemento nell'area di lavoro e in Git remoto.

ErrorRelatedResource

Object

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

Object

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

Object

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

Object

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

Object

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

Object

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

Object

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

Enumeration

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

Valore Descrizione
Dashboard

Dashboard di Power BI.
DataPipeline

Una pipeline di dati.
Datamart

Datamart di PowerBI.
Environment

Un ambiente.
Eventhouse

Una casa eventi.
Eventstream

Flusso di eventi.
GraphQLApi

API per l'elemento GraphQL.
KQLDashboard

Dashboard KQL.
KQLDatabase

Un database KQL.
KQLQueryset

Set di query KQL.
Lakehouse

Una lakehouse.
MLExperiment

Esperimento di Machine Learning.
MLModel

Modello di Machine Learning.
MirroredDatabase

Database con mirroring.
MirroredWarehouse

Magazzino con mirroring.
MountedDataFactory

Oggetto MountedDataFactory.
Notebook

Un notebook.
PaginatedReport

Report impaginato di Power BI.
Reflex

Un riflesso.
Report

Report di Power BI.
SQLDatabase

A SQLDatabase.
SQLEndpoint

Endpoint SQL.
SemanticModel

Modello semantico di PowerBI.
SparkJobDefinition

Definizione di processo Spark.
Warehouse

Un magazzino.