Delen via

Git - Get Status

  • Referentie
Service:
Core
API-versie:
v1

Retourneert de Git status van items in de werkruimte, die kunnen worden doorgevoerd in Git.
Deze API ondersteunt langlopende bewerkingen (LRO).

De status geeft wijzigingen aan in de items sinds de laatste werkruimte en externe vertakkingssynchronisatie. Als beide locaties zijn gewijzigd, markeert de API een conflict.

Machtigingen

De aanroeper moet een inzender hebben of een hogere werkruimterol.

Vereiste gedelegeerde bereiken

Workspace.GitUpdate.All of Workspace.GitCommit.All

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft -identiteiten vermeld in deze sectie.

Identiteit Steunen
Gebruiker Ja
service-principal en beheerde identiteiten Nee

Interface

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

URI-parameters

Name In Vereist Type Description
workspaceId
 path True

string

uuid

De werkruimte-id.

Antwoorden

Name Type Description
200 OK

GitStatusResponse

De aanvraag is voltooid.
202 Accepted

Aanvraag geaccepteerd, status wordt uitgevoerd.

Kopteksten

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

ErrorResponse

Veelvoorkomende foutcodes:

  • WorkspaceNotConnectedToGit - Werkruimte is niet verbonden met Git.

  • WorkspaceHasNoCapacityAssigned - Werkruimte heeft geen capaciteit.

  • InsufficientPrivileges : de aanroeper beschikt niet over voldoende werkruimtemachtigingen.

Voorbeelden

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

Get status example

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
ChangeType

Een wijziging van een item. Er kunnen in de loop van de tijd extra gewijzigde typen worden toegevoegd.
ConflictType

Een wijziging van een item in zowel werkruimte als extern. Er kunnen in de loop van de tijd extra gewijzigde typen worden toegevoegd.
ErrorRelatedResource

Het foutgerelateerde resourcedetailsobject.
ErrorResponse

Het foutbericht.
ErrorResponseDetails

De details van het foutbericht.
GitStatusResponse

Bevat het statusantwoord.
ItemChange

Bevat de wijzigingsgegevens van het item.
ItemIdentifier

Bevat de item-id. Ten minste één van de eigenschappen moet worden gedefinieerd.
ItemMetadata

Bevat de metagegevens van het item.
ItemType

Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.

ChangeType

Inventarisatie

Een wijziging van een item. Er kunnen in de loop van de tijd extra gewijzigde typen worden toegevoegd.

Waarde Description
Added

Een nieuw gemaakt item.
Deleted

Item is verwijderd.
Modified

Iteminhoud is gewijzigd.

ConflictType

Inventarisatie

Een wijziging van een item in zowel werkruimte als extern. Er kunnen in de loop van de tijd extra gewijzigde typen worden toegevoegd.

Waarde Description
Conflict

Er zijn verschillende wijzigingen in het item in de werkruimte en in externe Git.
None

Er zijn geen wijzigingen in het item.
SameChanges

Er zijn identieke wijzigingen in het item in de werkruimte en in externe Git.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name Type Description
resourceId

string

De resource-id die betrokken is bij de fout.
resourceType

string

Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message

string

Een leesbare weergave van de fout.
moreDetails

ErrorResponseDetails[]

Lijst met aanvullende foutdetails.
relatedResource

ErrorRelatedResource

De foutgerelateerde resourcedetails.
requestId

string

Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message

string

Een leesbare weergave van de fout.
relatedResource

ErrorRelatedResource

De foutgerelateerde resourcedetails.

GitStatusResponse

Object

Bevat het statusantwoord.

Name Type Description
changes

ItemChange[]

Een lijst met wijzigingen in externe Git die niet worden toegepast op de opgegeven werkruimte en wijzigingen in de werkruimte die niet worden toegepast op externe Git.
remoteCommitHash

string

Externe volledige SHA-doorvoerhash.
workspaceHead

string

Volledige SHA-hash waarmee de werkruimte wordt gesynchroniseerd.

ItemChange

Object

Bevat de wijzigingsgegevens van het item.

Name Type Description
conflictType

ConflictType

Wanneer er wijzigingen zijn aan zowel de werkruimtezijde als de externe Git-zijde.
itemMetadata

ItemMetadata

De metagegevens van het item.
remoteChange

ChangeType

Wijzigen aan de externe Git-zijde.
workspaceChange

ChangeType

Wijzigen aan de werkruimtezijde.

ItemIdentifier

Object

Bevat de item-id. Ten minste één van de eigenschappen moet worden gedefinieerd.

Name Type Description
logicalId

string

uuid

De logische id van het item. Wanneer de logische id niet beschikbaar is omdat het item nog niet is toegevoegd aan de werkruimte, kunt u de object-id gebruiken.
objectId

string

uuid

De object-id van het item. Wanneer de object-id niet beschikbaar is omdat het item is verwijderd uit de werkruimte, kunt u de logische id gebruiken.

ItemMetadata

Object

Bevat de metagegevens van het item.

Name Type Description
displayName

string

De weergavenaam van het item. Geeft de voorkeur aan de weergavenaam van het werkruimte-item als het bestaat, anders gebruikt displayName de weergavenaam van het externe item.
itemIdentifier

ItemIdentifier

De item-id.
itemType

ItemType

Het itemtype.

ItemType

Inventarisatie

Het type item. Er kunnen in de loop van de tijd extra itemtypen worden toegevoegd.

Waarde Description
Dashboard

PowerBI-dashboard.
DataPipeline

Een gegevenspijplijn.
Datamart

PowerBI-datamart.
Environment

Een omgeving.
Eventhouse

Een eventhouse.
Eventstream

Een eventstream.
GraphQLApi

Een API voor GraphQL-item.
KQLDashboard

Een KQL-dashboard.
KQLDatabase

Een KQL-database.
KQLQueryset

Een KQL-queryset.
Lakehouse

Een lakehouse.
MLExperiment

Een machine learning-experiment.
MLModel

Een machine learning-model.
MirroredDatabase

Een gespiegelde database.
MirroredWarehouse

Een gespiegeld magazijn.
MountedDataFactory

Een MountedDataFactory.
Notebook

Een notitieblok.
PaginatedReport

Gepagineerd Power BI-rapport.
Reflex

Een reflex.
Report

PowerBI-rapport.
SQLDatabase

Een SQLDatabase.
SQLEndpoint

Een SQL-eindpunt.
SemanticModel

Semantisch Power BI-model.
SparkJobDefinition

Een Spark-taakdefinitie.
Warehouse

Een magazijn.