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

Git - Update From Git

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

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

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

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

Δικαιώματα

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

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

Workspace.GitUpdate.All

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

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

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

Διεπαφή

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/updateFromGit

Παράμετροι URI

Όνομα Μέσα Απαιτούμενο Δακτυλογραφώ Περιγραφή
workspaceId
 path True

string (uuid)

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

Σώμα αιτήματος

Όνομα Απαιτούμενο Δακτυλογραφώ Περιγραφή
remoteCommitHash True

string

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

WorkspaceConflictResolution

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

UpdateOptions

Επιλογές που θα χρησιμοποιηθούν στην ενημέρωση από τη λειτουργία Git
workspaceHead

string

Κατακερματίζεται το Πλήρες SHA στο οποίο συγχρονίζεται ο χώρος εργασίας. Αυτή η τιμή μπορεί να είναι null μόνο μετά την Προετοιμασία σύνδεσης. Σε άλλες περιπτώσεις, το σύστημα θα επικυρώσει ότι η παρεχόμενη τιμή ευθυγραμμίζεται με την κεφαλή που είναι γνωστή στο σύστημα.

Απαντήσεις

Όνομα Δακτυλογραφώ Περιγραφή
200 OK

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

Αποδοχή αίτησης, ενημέρωση από το Git σε εξέλιξη.

Κεφαλίδες

  • 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 - Δεν έχουν εκχωρηθεί εκχωρημένοι πόροι στον χώρο εργασίας.

  • WorkspaceHeadMismatch - Η κεφαλή στην αίτηση δεν συμφωνεί με την κεφαλή του συστήματος.

  • WorkspacePreviousOperationInProgress - Η προηγούμενη λειτουργία βρίσκεται ακόμα σε εξέλιξη.

  • MissingDependency - Απουσιάζει μια εξάρτηση στη λειτουργία ενημέρωσης.

  • PotentialDuplicateDisplayNameAndType - Η λειτουργία ενημέρωσης θα δημιουργήσει ένα διπλότυπο εμφανιζόμενο όνομα και τύπο.

  • DependencyDeletionFailed - Η λειτουργία ενημέρωσης θα διαγράψει την εξάρτηση.

  • InsufficientPrivileges - Ο καλών δεν διαθέτει επαρκή δικαιώματα χώρου εργασίας.

  • PrincipalTypeNotSupported - Δεν υποστηρίζεται ο τύπος ταυτότητας καλούντα.

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

Update a workspace using data from a Git example

Αίτημα δείγματος

POST https://api.fabric.microsoft.com/v1/workspaces/1565e6a3-c020-4c0c-dda7-92bafe99eec5/git/updateFromGit

{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705",
  "conflictResolution": {
    "conflictResolutionType": "Workspace",
    "conflictResolutionPolicy": "PreferWorkspace"
  },
  "options": {
    "allowOverrideItems": true
  }
}

Δείγμα απάντησης

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

Ορισμοί

Όνομα Περιγραφή
ConflictResolutionPolicy

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

Τύπος επίλυσης διένεξης. Μπορούν να προστεθούν πρόσθετοι τύποι επίλυσης διένεξης με την πάροδο του χρόνου.
ErrorRelatedResource

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

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

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

Περιέχει την ενημέρωση από τα δεδομένα αίτησης Git.
UpdateOptions

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

Τα βασικά δεδομένα επίλυσης διένεξης.

ConflictResolutionPolicy

Απαρίθμηση

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

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

Προτιμάτε απομακρυσμένο περιεχόμενο από την πλευρά του Git.
PreferWorkspace

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

ConflictResolutionType

Απαρίθμηση

Τύπος επίλυσης διένεξης. Μπορούν να προστεθούν πρόσθετοι τύποι επίλυσης διένεξης με την πάροδο του χρόνου.

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

Επίλυση διένεξης που αντιπροσωπεύει το επίπεδο χώρου εργασίας.

ErrorRelatedResource

Αντικείμενο

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

Όνομα Δακτυλογραφώ Περιγραφή
resourceId

string

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

string

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

ErrorResponse

Αντικείμενο

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

Όνομα Δακτυλογραφώ Περιγραφή
errorCode

string

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

string

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

ErrorResponseDetails[]

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

ErrorRelatedResource

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

string (uuid)

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

ErrorResponseDetails

Αντικείμενο

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

Όνομα Δακτυλογραφώ Περιγραφή
errorCode

string

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

string

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

ErrorRelatedResource

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

UpdateFromGitRequest

Αντικείμενο

Περιέχει την ενημέρωση από τα δεδομένα αίτησης Git.

Όνομα Δακτυλογραφώ Περιγραφή
conflictResolution

WorkspaceConflictResolution

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

UpdateOptions

Επιλογές που θα χρησιμοποιηθούν στην ενημέρωση από τη λειτουργία Git
remoteCommitHash

string

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

string

Κατακερματίζεται το Πλήρες SHA στο οποίο συγχρονίζεται ο χώρος εργασίας. Αυτή η τιμή μπορεί να είναι null μόνο μετά την Προετοιμασία σύνδεσης. Σε άλλες περιπτώσεις, το σύστημα θα επικυρώσει ότι η παρεχόμενη τιμή ευθυγραμμίζεται με την κεφαλή που είναι γνωστή στο σύστημα.

UpdateOptions

Αντικείμενο

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

Όνομα Δακτυλογραφώ Περιγραφή
allowOverrideItems

boolean

Ο χρήστης συμφωνεί να παρακάμπτει εισερχόμενα στοιχεία κατά τη διαδικασία ενημέρωσης από το Git. Όταν υπάρχουν εισερχόμενα στοιχεία και δεν καθορίζεται η δυνατότητα παράκαμψης στοιχείων ή παρέχεται ως false, η λειτουργία ενημέρωσης δεν θα ξεκινήσει. Η προεπιλεγμένη τιμή είναι false.

WorkspaceConflictResolution

Αντικείμενο

Τα βασικά δεδομένα επίλυσης διένεξης.

Όνομα Δακτυλογραφώ Περιγραφή
conflictResolutionPolicy

ConflictResolutionPolicy

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

ConflictResolutionType

Τύπος επίλυσης διένεξης. Μπορούν να προστεθούν πρόσθετοι τύποι επίλυσης διένεξης με την πάροδο του χρόνου.