Git - Get Status

Υπηρεσία:: Core

Έκδοση API:: v1

Επιστρέφει την Git status στοιχείων στον χώρο εργασίας, τα οποία μπορούν να δεσμευτούν στο Git.
Αυτό το API υποστηρίζει λειτουργίες μεγάλης διάρκειας (LRO).

Η κατάσταση υποδεικνύει αλλαγές σε στοιχεία από τον τελευταίο συγχρονισμό χώρου εργασίας και απομακρυσμένου κλάδου. Εάν τα στοιχεία απομακρυσμένης σύνδεσης και χώρου εργασίας τροποποιήθηκαν και τα δύο, το API επισημαίνει μια διένεξη.

Για να χρησιμοποιήσετε αυτό το API, πρέπει να ρυθμίσετε τις παραμέτρους των διαπιστευτηρίων Git του καλούντε χρησιμοποιώντας το API Ενημέρωση των διαπιστευτηρίων μου Git . Μπορείτε να χρησιμοποιήσετε το API Λήψη των διαπιστευτηρίων μου Git για να ελέγξετε τη ρύθμιση παραμέτρων διαπιστευτηρίων Git.

Δικαιώματα

Ο καλών πρέπει να έχει συνεισφέροντα ή υψηλότερο ρόλο χώρου εργασίας.

Απαιτούμενες εμβέλειες με ανάθεση

Workspace.GitUpdate.All ή Workspace.GitCommit.All

Υποστηριζόμενες ταυτότητες Microsoft Entra

Αυτό το API υποστηρίζει τις ταυτότητες Microsoft που παρατίθενται σε αυτή την ενότητα.

Ταυτότητα	Υποστηρίζω
Χρήστης	Ναι
Υπηρεσίας και διαχειριζόμενες ταυτότητες

Διεπαφή

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

Παράμετροι URI

Όνομα	Σε	Απαιτείται	Τύπος	Περιγραφή
workspaceId	path	True	string (uuid)	Το αναγνωριστικό χώρου εργασίας.

Αποκρίσεις

Όνομα	Τύπος	Περιγραφή
200 OK	GitStatusResponse	Η αίτηση ολοκληρώθηκε με επιτυχία.
202 Accepted		Αίτηση αποδοχής, λήψη κατάστασης σε εξέλιξη. Κεφαλίδες Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Συνήθεις κωδικοί σφαλμάτων: WorkspaceNotConnectedToGit - Ο χώρος εργασίας δεν είναι συνδεδεμένος στο git. WorkspaceHasNoCapacityAssigned - Ο χώρος εργασίας δεν βρίσκεται σε εκχωρημένους πόρους. InsufficientPrivileges - Ο καλών δεν διαθέτει επαρκή δικαιώματα χώρου εργασίας. PrincipalTypeNotSupported - Δεν υποστηρίζεται ο τύπος ταυτότητας καλούντα.

Όνομα

Τύπος

Περιγραφή

200 OK

GitStatusResponse

Η αίτηση ολοκληρώθηκε με επιτυχία.

202 Accepted

Αίτηση αποδοχής, λήψη κατάστασης σε εξέλιξη.

Κεφαλίδες

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

Other Status Codes

ErrorResponse

Συνήθεις κωδικοί σφαλμάτων:

WorkspaceNotConnectedToGit - Ο χώρος εργασίας δεν είναι συνδεδεμένος στο git.
WorkspaceHasNoCapacityAssigned - Ο χώρος εργασίας δεν βρίσκεται σε εκχωρημένους πόρους.
InsufficientPrivileges - Ο καλών δεν διαθέτει επαρκή δικαιώματα χώρου εργασίας.
PrincipalTypeNotSupported - Δεν υποστηρίζεται ο τύπος ταυτότητας καλούντα.

Παραδείγματα

Get status example

Get status no changes example

Get status with conflict example

Get status example

Δείγμα αίτησης

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/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"
    }
  ]
}

Κωδικός κατάστασης:: 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

Δείγμα αίτησης

HTTP

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

Δείγμα απόκρισης

Κωδικός κατάστασης:: 200

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

Κωδικός κατάστασης:: 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

Δείγμα αίτησης

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/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"
    }
  ]
}

Κωδικός κατάστασης:: 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

Ορισμοί

Όνομα	Περιγραφή
ChangeType	Αλλαγή ενός στοιχείου. Ενδέχεται να προστεθούν πρόσθετοι αλλαγμένοι τύποι με την πάροδο του χρόνου.
ConflictType	Μια αλλαγή ενός στοιχείου τόσο στο χώρο εργασίας όσο και στην απομακρυσμένη. Ενδέχεται να προστεθούν πρόσθετοι αλλαγμένοι τύποι με την πάροδο του χρόνου.
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
GitStatusResponse	Περιέχει την απόκριση κατάστασης.
ItemChange	Περιέχει τις πληροφορίες αλλαγής του στοιχείου.
ItemIdentifier	Περιέχει το αναγνωριστικό στοιχείου. Πρέπει να οριστεί τουλάχιστον μία από τις ιδιότητες.
ItemMetadata	Περιέχει τα μετα-δεδομένα του στοιχείου.
ItemType	Ο τύπος του στοιχείου. Επιπλέον τύποι στοιχείων μπορούν να προστεθούν με την πάροδο του χρόνου.

ChangeType

Απαρίθμηση

Αλλαγή ενός στοιχείου. Ενδέχεται να προστεθούν πρόσθετοι αλλαγμένοι τύποι με την πάροδο του χρόνου.

Τιμή	Περιγραφή
Added	Ένα στοιχείο που μόλις δημιουργήθηκε.
Deleted	Το στοιχείο διαγράφηκε.
Modified	Το περιεχόμενο στοιχείου τροποποιήθηκε.

ConflictType

Απαρίθμηση

Μια αλλαγή ενός στοιχείου τόσο στο χώρο εργασίας όσο και στην απομακρυσμένη. Ενδέχεται να προστεθούν πρόσθετοι αλλαγμένοι τύποι με την πάροδο του χρόνου.

Τιμή	Περιγραφή
Conflict	Υπάρχουν διαφορετικές αλλαγές στο στοιχείο στον χώρο εργασίας και στο απομακρυσμένο Git.
None	Δεν υπάρχουν αλλαγές στο στοιχείο.
SameChanges	Υπάρχουν πανομοιότυπες αλλαγές στο στοιχείο στον χώρο εργασίας και στο απομακρυσμένο Git.

ErrorRelatedResource

Object

Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.

Όνομα	Τύπος	Περιγραφή
resourceId	string	Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα.
resourceType	string	Ο τύπος του πόρου που εμπλέκεται στο σφάλμα.

ErrorResponse

Object

Η απόκριση σφάλματος.

Όνομα	Τύπος	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
moreDetails	ErrorResponseDetails[]	Λίστα πρόσθετων λεπτομερειών σφάλματος.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.
requestId	string	Το αναγνωριστικό της αίτησης που σχετίζεται με το σφάλμα.

ErrorResponseDetails

Object

Οι λεπτομέρειες της απόκρισης σφάλματος.

Όνομα	Τύπος	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

GitStatusResponse

Object

Περιέχει την απόκριση κατάστασης.

Όνομα	Τύπος	Περιγραφή
changes	ItemChange[]	Μια λίστα των αλλαγών στο απομακρυσμένο Git που δεν εφαρμόζονται στον συγκεκριμένο χώρο εργασίας καθώς και των αλλαγών στον χώρο εργασίας που δεν εφαρμόζονται στο απομακρυσμένο Git.
remoteCommitHash	string	Κατακερματισμός πλήρους δέσμευσης SHA.
workspaceHead	string	Κατακερματίζεται το Πλήρες SHA στο οποίο συγχρονίζεται ο χώρος εργασίας.

ItemChange

Object

Περιέχει τις πληροφορίες αλλαγής του στοιχείου.

Όνομα	Τύπος	Περιγραφή
conflictType	ConflictType	Όταν υπάρχουν αλλαγές τόσο στην πλευρά του χώρου εργασίας όσο και στην απομακρυσμένη πλευρά του Git.
itemMetadata	ItemMetadata	Τα μετα-δεδομένα του στοιχείου.
remoteChange	ChangeType	Αλλαγή στην απομακρυσμένη πλευρά του Git.
workspaceChange	ChangeType	Αλλαγή στην πλευρά του χώρου εργασίας.

ItemIdentifier

Object

Περιέχει το αναγνωριστικό στοιχείου. Πρέπει να οριστεί τουλάχιστον μία από τις ιδιότητες.

Όνομα	Τύπος	Περιγραφή
logicalId	string (uuid)	Το λογικό αναγνωριστικό του στοιχείου. Όταν το λογικό αναγνωριστικό δεν είναι διαθέσιμο επειδή το στοιχείο δεν έχει προστεθεί ακόμα στον χώρο εργασίας, μπορείτε να χρησιμοποιήσετε το αναγνωριστικό αντικειμένου.
objectId	string (uuid)	Το αναγνωριστικό αντικειμένου του στοιχείου. Όταν το αναγνωριστικό αντικειμένου δεν είναι διαθέσιμο επειδή το στοιχείο διαγράφηκε από τον χώρο εργασίας, μπορείτε να χρησιμοποιήσετε το λογικό αναγνωριστικό.

ItemMetadata

Object

Περιέχει τα μετα-δεδομένα του στοιχείου.

Όνομα	Τύπος	Περιγραφή
displayName	string	Το εμφανιζόμενο όνομα του στοιχείου. Προτιμά το εμφανιζόμενο όνομα του στοιχείου χώρου εργασίας εάν υπάρχει, διαφορετικά το displayName χρησιμοποιεί το εμφανιζόμενο όνομα του απομακρυσμένου στοιχείου.
itemIdentifier	ItemIdentifier	Το αναγνωριστικό στοιχείου.
itemType	ItemType	Ο τύπος στοιχείου.

ItemType

Απαρίθμηση

Ο τύπος του στοιχείου. Επιπλέον τύποι στοιχείων μπορούν να προστεθούν με την πάροδο του χρόνου.

Τιμή	Περιγραφή
ApacheAirflowJob	Ένα ApacheAirflowJob.
CopyJob	Μια εργασία αντιγραφής.
Dashboard	Πίνακας εργαλείων του PowerBI.
DataPipeline	Μια διοχέτευση δεδομένων.
Dataflow	Μια ροή δεδομένων.
Datamart	Datamart του PowerBI.
DigitalTwinBuilder	Μια DigitalTwinBuilder.
DigitalTwinBuilderFlow	Μια ψηφιακή ροή Twin Builder.
Environment	Ένα περιβάλλον.
Eventhouse	Μια εκδήλωση.
Eventstream	Μια ροή συμβάντος.
GraphQLApi	Ένα API για το στοιχείο GraphQL.
KQLDashboard	Ένας πίνακας εργαλείων KQL.
KQLDatabase	Μια βάση δεδομένων KQL.
KQLQueryset	Ένα σύνολο ερωτημάτων KQL.
Lakehouse	Ένα λιμνοθάσπιτο.
MLExperiment	Ένα πείραμα εκμάθησης μηχανής.
MLModel	Ένα μοντέλο εκμάθησης μηχανής.
MirroredAzureDatabricksCatalog	Ένας κατοπτρικός κατάλογος azure databricks.
MirroredDatabase	Μια βάση δεδομένων κατοπτρισμού.
MirroredWarehouse	Μια αποθήκη με κατοπτρικό καθρέφτη.
MountedDataFactory	A MountedDataFactory.
Notebook	Ένα σημειωματάριο.
PaginatedReport	Σελιδοποιημένη αναφορά PowerBI.
Reflex	Αντανακλαστικά.
Report	Αναφορά PowerBI.
SQLDatabase	Μια βάση δεδομένων SQL.
SQLEndpoint	Ένα τελικό σημείο SQL.
SemanticModel	Σημασιολογικό μοντέλο PowerBI.
SparkJobDefinition	Ένας ορισμός εργασίας σπινθήρα.
VariableLibrary	Μια μεταβλητήLibrary.
Warehouse	Μια αποθήκη.
WarehouseSnapshot	Ένα στιγμιότυπο αποθήκης.

Κοινή χρήση μέσω

Git - Get Status

Δικαιώματα

Απαιτούμενες εμβέλειες με ανάθεση

Υποστηριζόμενες ταυτότητες Microsoft Entra

Διεπαφή

Παράμετροι URI

Αποκρίσεις

Παραδείγματα

Get status example

Δείγμα αίτησης

Δείγμα απόκρισης

Get status no changes example

Δείγμα αίτησης

Δείγμα απόκρισης

Get status with conflict example

Δείγμα αίτησης

Δείγμα απόκρισης

Ορισμοί

ChangeType

ConflictType

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GitStatusResponse

ItemChange

ItemIdentifier

ItemMetadata

ItemType