Git - Get Status

Υπηρεσία:
Core
Έκδοση API:
v1

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

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

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

Permissions

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

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

Workspace.GitUpdate.All ή Workspace.GitCommit.All

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

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

Identity Support
User Yes
Υπηρεσίας και διαχειριζόμενες ταυτότητες Yes

Interface

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
429 Too Many Requests

ErrorResponse

Έγινε υπέρβαση του ορίου επιτοκίου υπηρεσίας. Ο διακομιστής επιστρέφει μια Retry-After κεφαλίδα που υποδεικνύει, σε δευτερόλεπτα, πόσο πρέπει να περιμένει ο υπολογιστής-πελάτης πριν από την αποστολή πρόσθετων αιτήσεων.

Κεφαλίδες

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

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

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

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

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

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

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

Απαρίθμηση

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

Τιμή Περιγραφή
None

Δεν υπάρχουν αλλαγές στο στοιχείο.
Conflict

Υπάρχουν διαφορετικές αλλαγές στο στοιχείο στον χώρο εργασίας και στο απομακρυσμένο Git.
SameChanges

Υπάρχουν πανομοιότυπες αλλαγές στο στοιχείο στον χώρο εργασίας και στο απομακρυσμένο Git.

ErrorRelatedResource

Αντικείμενο

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

Όνομα Τύπος Περιγραφή
resourceId

string

Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα.
resourceType

string

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

ErrorResponse

Αντικείμενο

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

Όνομα Τύπος Περιγραφή
errorCode

string

Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message

string

Μια αναγνώσιμη αναπαράσταση του σφάλματος.
moreDetails

ErrorResponseDetails[]

Λίστα πρόσθετων λεπτομερειών σφάλματος.
relatedResource

ErrorRelatedResource

Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.
requestId

string (uuid)

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

ErrorResponseDetails

Αντικείμενο

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

Όνομα Τύπος Περιγραφή
errorCode

string

Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message

string

Μια αναγνώσιμη αναπαράσταση του σφάλματος.
relatedResource

ErrorRelatedResource

Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

GitStatusResponse

Αντικείμενο

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

Όνομα Τύπος Περιγραφή
changes

ItemChange[]

Μια λίστα των αλλαγών στο απομακρυσμένο Git που δεν εφαρμόζονται στον συγκεκριμένο χώρο εργασίας καθώς και των αλλαγών στον χώρο εργασίας που δεν εφαρμόζονται στο απομακρυσμένο Git.
remoteCommitHash

string

Κατακερματισμός πλήρους δέσμευσης SHA.
workspaceHead

string

Κατακερματίζεται το Πλήρες SHA στο οποίο συγχρονίζεται ο χώρος εργασίας.

ItemChange

Αντικείμενο

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

Όνομα Τύπος Περιγραφή
conflictType

ConflictType

Όταν υπάρχουν αλλαγές τόσο στην πλευρά του χώρου εργασίας όσο και στην απομακρυσμένη πλευρά του Git.
itemMetadata

ItemMetadata

Τα μετα-δεδομένα του στοιχείου.
remoteChange

ChangeType

Αλλαγή στην απομακρυσμένη πλευρά του Git.
workspaceChange

ChangeType

Αλλαγή στην πλευρά του χώρου εργασίας.

ItemIdentifier

Αντικείμενο

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

Όνομα Τύπος Περιγραφή
logicalId

string (uuid)

Το λογικό αναγνωριστικό του στοιχείου. Όταν το λογικό αναγνωριστικό δεν είναι διαθέσιμο επειδή το στοιχείο δεν έχει προστεθεί ακόμα στον χώρο εργασίας, μπορείτε να χρησιμοποιήσετε το αναγνωριστικό αντικειμένου.
objectId

string (uuid)

Το αναγνωριστικό αντικειμένου του στοιχείου. Όταν το αναγνωριστικό αντικειμένου δεν είναι διαθέσιμο επειδή το στοιχείο διαγράφηκε από τον χώρο εργασίας, μπορείτε να χρησιμοποιήσετε το λογικό αναγνωριστικό.

ItemMetadata

Αντικείμενο

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

Όνομα Τύπος Περιγραφή
displayName

string

Το εμφανιζόμενο όνομα του στοιχείου. Προτιμά το εμφανιζόμενο όνομα του στοιχείου χώρου εργασίας εάν υπάρχει, διαφορετικά το displayName χρησιμοποιεί το εμφανιζόμενο όνομα του απομακρυσμένου στοιχείου.
itemIdentifier

ItemIdentifier

Το αναγνωριστικό στοιχείου.
itemType

ItemType

Ο τύπος στοιχείου.

ItemType

Απαρίθμηση

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

Τιμή Περιγραφή
Dashboard

Πίνακας εργαλείων του PowerBI.
Report

Αναφορά PowerBI.
SemanticModel

Σημασιολογικό μοντέλο PowerBI.
PaginatedReport

Σελιδοποιημένη αναφορά PowerBI.
Datamart

Datamart του PowerBI.
Lakehouse

Ένα λιμνοθάσπιτο.
Eventhouse

Μια εκδήλωση.
Environment

Ένα περιβάλλον.
KQLDatabase

Μια βάση δεδομένων KQL.
KQLQueryset

Ένα σύνολο ερωτημάτων KQL.
KQLDashboard

Ένας πίνακας εργαλείων KQL.
DataPipeline

Μια διοχέτευση δεδομένων.
Notebook

Ένα σημειωματάριο.
SparkJobDefinition

Ένας ορισμός εργασίας σπινθήρα.
MLExperiment

Ένα πείραμα εκμάθησης μηχανής.
MLModel

Ένα μοντέλο εκμάθησης μηχανής.
Warehouse

Μια αποθήκη.
Eventstream

Μια ροή συμβάντος.
SQLEndpoint

Ένα τελικό σημείο SQL.
MirroredWarehouse

Μια αποθήκη με κατοπτρικό καθρέφτη.
MirroredDatabase

Μια βάση δεδομένων κατοπτρισμού.
Reflex

Αντανακλαστικά.
GraphQLApi

Ένα API για το στοιχείο GraphQL.
MountedDataFactory

A MountedDataFactory.
SQLDatabase

Μια βάση δεδομένων SQL.
CopyJob

Μια εργασία αντιγραφής.
VariableLibrary

Μια μεταβλητήLibrary.
Dataflow

Μια ροή δεδομένων.
ApacheAirflowJob

Ένα ApacheAirflowJob.
WarehouseSnapshot

Ένα στιγμιότυπο αποθήκης.
DigitalTwinBuilder

Μια DigitalTwinBuilder.
DigitalTwinBuilderFlow

Μια ψηφιακή ροή Twin Builder.
MirroredAzureDatabricksCatalog

Ένας κατοπτρικός κατάλογος azure databricks.
Map

Ένας χάρτης.
AnomalyDetector

Ένας εντοπισμός ανωμαλιών.
UserDataFunction

Μια συνάρτηση δεδομένων χρήστη.
GraphModel

Ένα GraphModel.
GraphQuerySet

Ένα σύνολο ερωτημάτων Graph.
SnowflakeDatabase

Μια βάση δεδομένων Snowflake για την αποθήκευση πινάκων Iceberg που δημιουργήθηκαν από τον λογαριασμό Snowflake.
OperationsAgent

A OperationsAgent.
CosmosDBDatabase

Μια βάση δεδομένων Cosmos DB.
Ontology

Μια ογκολογία.
EventSchemaSet

Ένα EventSchemaSet.
DataAgent

Ένας DataAgent.
MirroredCatalog

Ένα Κατοπτρικό Αρχείο.