Freigeben über

Git - Get Status

  • Referenz
Dienst:
Core
API-Version:
v1

Gibt die Git status von Elementen im Arbeitsbereich zurück, die für Git übernommen werden können.
Diese API unterstützt LRO-.

Der Status gibt Änderungen an den Elementen seit dem letzten Arbeitsbereich und der Remote branch-Synchronisierung an. Wenn beide Speicherorte geändert wurden, kennzeichnet die API einen Konflikt.

Erlaubnisse

Der Aufrufer muss einen Mitwirkenden oder eine höhere Arbeitsbereichsrolle haben.

Erforderliche delegierte Bereiche

Workspace.GitUpdate.All oder Workspace.GitCommit.All

Von Microsoft Entra unterstützte Identitäten

Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.

Identität Unterstützen
Benutzer Ja
Dienstprinzipal und verwaltete Identitäten Nein

Schnittstelle

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
workspaceId
 path True

string

uuid

Die Arbeitsbereichs-ID.

Antworten

Name Typ Beschreibung
200 OK

GitStatusResponse

Die Anforderung wurde erfolgreich abgeschlossen.
202 Accepted

Anforderung angenommen, Status wird ausgeführt.

Header

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

ErrorResponse

Häufige Fehlercodes:

  • WorkspaceNotConnectedToGit – Arbeitsbereich ist nicht mit Git verbunden.

  • WorkspaceHasNoCapacityAssigned – Arbeitsbereich ist nicht in kapazität.

  • InsufficientPrivileges – Der Aufrufer verfügt nicht über ausreichende Arbeitsbereichsberechtigungen.

Beispiele

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

Get status example

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
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"
    }
  ]
}
Statuscode:
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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
200 
{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "changes": []
}
Statuscode:
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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:
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"
    }
  ]
}
Statuscode:
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

Definitionen

Name Beschreibung
ChangeType

Eine Änderung eines Elements. Im Laufe der Zeit können weitere geänderte Typen hinzugefügt werden.
ConflictType

Eine Änderung eines Elements in Arbeitsbereich und Remote. Im Laufe der Zeit können weitere geänderte Typen hinzugefügt werden.
ErrorRelatedResource

Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse

Die Fehlerantwort.
ErrorResponseDetails

Die Fehlerantwortdetails.
GitStatusResponse

Enthält die Statusantwort.
ItemChange

Enthält die Änderungsinformationen des Elements.
ItemIdentifier

Enthält den Elementbezeichner. Mindestens eine der Eigenschaften muss definiert werden.
ItemMetadata

Enthält die Elementmetadaten.
ItemType

Der Typ des Elements. Zusätzliche Elementtypen können im Laufe der Zeit hinzugefügt werden.

ChangeType

Enumeration

Eine Änderung eines Elements. Im Laufe der Zeit können weitere geänderte Typen hinzugefügt werden.

Wert Beschreibung
Added

Ein neu erstelltes Element.
Deleted

Element wurde gelöscht.
Modified

Elementinhalt wurde geändert.

ConflictType

Enumeration

Eine Änderung eines Elements in Arbeitsbereich und Remote. Im Laufe der Zeit können weitere geänderte Typen hinzugefügt werden.

Wert Beschreibung
Conflict

Es gibt unterschiedliche Änderungen am Element im Arbeitsbereich und in Remote-Git.
None

Es sind keine Änderungen am Element vorhanden.
SameChanges

Es gibt identische Änderungen am Element im Arbeitsbereich und in Remote-Git.

ErrorRelatedResource

Objekt

Das Fehlerbezogene Ressourcendetails-Objekt.

Name Typ Beschreibung
resourceId

string

Die Ressourcen-ID, die an dem Fehler beteiligt ist.
resourceType

string

Der Typ der Ressource, die an dem Fehler beteiligt ist.

ErrorResponse

Objekt

Die Fehlerantwort.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message

string

Eine lesbare Darstellung des Fehlers.
moreDetails

ErrorResponseDetails[]

Liste der zusätzlichen Fehlerdetails.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.
requestId

string

ID der Anforderung, die dem Fehler zugeordnet ist.

ErrorResponseDetails

Objekt

Die Fehlerantwortdetails.

Name Typ Beschreibung
errorCode

string

Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message

string

Eine lesbare Darstellung des Fehlers.
relatedResource

ErrorRelatedResource

Die fehlerbezogenen Ressourcendetails.

GitStatusResponse

Objekt

Enthält die Statusantwort.

Name Typ Beschreibung
changes

ItemChange[]

Eine Liste der Änderungen in Remote-Git, die nicht auf den angegebenen Arbeitsbereich angewendet werden, und Änderungen im Arbeitsbereich, die nicht auf Remote-Git angewendet werden.
remoteCommitHash

string

Vollständiger SHA-Commit-Hash für Remotezugriff.
workspaceHead

string

Vollständiger SHA-Hash, mit dem der Arbeitsbereich synchronisiert wird.

ItemChange

Objekt

Enthält die Änderungsinformationen des Elements.

Name Typ Beschreibung
conflictType

ConflictType

Wenn Änderungen sowohl auf der Arbeitsbereichseite als auch auf der Remote-Git-Seite vorhanden sind.
itemMetadata

ItemMetadata

Die Elementmetadaten.
remoteChange

ChangeType

Ändern Sie sich auf der Git-Remoteseite.
workspaceChange

ChangeType

Ändern sie auf der Arbeitsbereichsseite.

ItemIdentifier

Objekt

Enthält den Elementbezeichner. Mindestens eine der Eigenschaften muss definiert werden.

Name Typ Beschreibung
logicalId

string

uuid

Die logische ID des Elements. Wenn die logische ID nicht verfügbar ist, da das Element noch nicht zum Arbeitsbereich hinzugefügt wurde, können Sie die Objekt-ID verwenden.
objectId

string

uuid

Die Objekt-ID des Elements. Wenn die Objekt-ID nicht verfügbar ist, weil das Element aus dem Arbeitsbereich gelöscht wurde, können Sie die logische ID verwenden.

ItemMetadata

Objekt

Enthält die Elementmetadaten.

Name Typ Beschreibung
displayName

string

Der Anzeigename des Elements. Bevorzugt den Anzeigenamen des Arbeitsbereichselements, falls vorhanden, andernfalls verwendet displayName den Anzeigenamen des Remoteelements.
itemIdentifier

ItemIdentifier

Der Elementbezeichner.
itemType

ItemType

Der Elementtyp.

ItemType

Enumeration

Der Typ des Elements. Zusätzliche Elementtypen können im Laufe der Zeit hinzugefügt werden.

Wert Beschreibung
Dashboard

PowerBI-Dashboard.
DataPipeline

Eine Datenpipeline.
Datamart

PowerBI datamart.
Environment

Eine Umgebung.
Eventhouse

Ein Eventhouse.
Eventstream

Ein Ereignisstream.
GraphQLApi

Eine API für GraphQL-Element.
KQLDashboard

Ein KQL-Dashboard.
KQLDatabase

Eine KQL-Datenbank.
KQLQueryset

Ein KQL-Abfrageset.
Lakehouse

Ein Seehaus.
MLExperiment

Ein Machine Learning-Experiment.
MLModel

Ein Machine Learning-Modell.
MirroredDatabase

Eine gespiegelte Datenbank.
MirroredWarehouse

Ein gespiegeltes Lager.
MountedDataFactory

Eine MountedDataFactory.
Notebook

Ein Notizbuch.
PaginatedReport

PowerBI-Paginated-Bericht.
Reflex

Ein Reflex.
Report

PowerBI-Bericht.
SQLDatabase

Eine SQLDatabase.
SQLEndpoint

Ein SQL-Endpunkt.
SemanticModel

PowerBI-Semantikmodell.
SparkJobDefinition

Eine Sparkauftragsdefinition.
Warehouse

Ein Lagerhaus.