Git - Connect

Υπηρεσία:: Core

Έκδοση API:: v1

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

Για να ξεκινήσετε με το GitHub, ανατρέξτε στο θέμα: Γρήγορα αποτελέσματα με την ενοποίηση του Git.

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

Δικαιώματα

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

Για τα διαπιστευτήρια Git σύνδεσης που έχουν ρυθμιστεί, ο καλών πρέπει να έχει δικαιώματα για τη σύνδεση.

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

Workspace.ReadWrite.All

Περιορισμοί

Όταν χρησιμοποιείτε την προέλευση αυτόματων διαπιστευτηρίων, αυτό το API αποκλείεται για την υπηρεσία παροχής GitHub και για την κύρια υπηρεσία.

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

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

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

Διεπαφή

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

Παράμετροι URI

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

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

Όνομα	Απαιτούμενο	Δακτυλογραφώ	Περιγραφή
gitProviderDetails	True	GitProviderDetails: AzureDevOpsDetails GitHubDetails	Τα στοιχεία της υπηρεσίας παροχής Git.
myGitCredentials		GitCredentials: ConfiguredConnectionGitCredentials AutomaticGitCredentials	Διαπιστευτήρια Git ειδικά για τον χρήστη για τον έλεγχο ταυτότητας στο GitProvider. Αυτά τα διαπιστευτήρια δεν κοινοποιούνται σε άλλους συμβάλλοντες στον χώρο εργασίας. Για το GitHub, αυτή η ιδιότητα είναι απαραίτητη. Για το AzureDevOps, αυτή η ιδιότητα είναι προαιρετική. Εάν δεν οριστεί, η προεπιλογή είναι AutomaticGitCredentials.

Απαντήσεις

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

200 OK

Όνομα	Δακτυλογραφώ	Περιγραφή
200 OK		Η αίτηση ολοκληρώθηκε με επιτυχία.
429 Too Many Requests	ErrorResponse	Έγινε υπέρβαση του ορίου επιτοκίου υπηρεσίας. Ο διακομιστής επιστρέφει μια `Retry-After` κεφαλίδα που υποδεικνύει, σε δευτερόλεπτα, πόσο πρέπει να περιμένει ο υπολογιστής-πελάτης πριν από την αποστολή πρόσθετων αιτήσεων. Κεφαλίδες Retry-After: integer
Other Status Codes	ErrorResponse	Συνήθεις κωδικοί σφαλμάτων: UnknownError - Παρουσιάστηκε σφάλμα. WorkspaceAlreadyConnectedToGit - Ο χώρος εργασίας είναι ήδη συνδεδεμένος στο git. WorkspaceHasNoCapacityAssigned - Δεν έχουν εκχωρηθεί εκχωρημένοι πόροι στον χώρο εργασίας. InsufficientPrivileges - Ο καλών έχει ανεπαρκή δικαιώματα χώρου εργασίας. PrincipalTypeNotSupported - Δεν υποστηρίζεται ο τύπος ταυτότητας καλούντα.

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

429 Too Many Requests

ErrorResponse

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

Κεφαλίδες

Retry-After: integer

Other Status Codes

ErrorResponse

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

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

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

Connect a workspace to Azure DevOps example

Connect a workspace to Azure DevOps using configured connection example

Connect a workspace to GitHub example

Connect a workspace to GitHub example - GitHub Enterprise With Data Residency (ghe.com)

Connect a workspace to Azure DevOps example

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

HTTP

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

{
  "gitProviderDetails": {
    "organizationName": "Test Organization",
    "projectName": "Test Project",
    "gitProviderType": "AzureDevOps",
    "repositoryName": "Test Repo",
    "branchName": "Test Branch",
    "directoryName": "Test Directory"
  }
}

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

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

Connect a workspace to Azure DevOps using configured connection example

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

HTTP

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

{
  "gitProviderDetails": {
    "organizationName": "Test Organization",
    "projectName": "Test Project",
    "gitProviderType": "AzureDevOps",
    "repositoryName": "Test Repo",
    "branchName": "Test Branch",
    "directoryName": "Test Directory/Test Subdirectory"
  },
  "myGitCredentials": {
    "source": "ConfiguredConnection",
    "connectionId": "3f2504e0-4f89-11d3-9a0c-0305e82c3301"
  }
}

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

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

Connect a workspace to GitHub example

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

HTTP

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

{
  "gitProviderDetails": {
    "ownerName": "Test Owner",
    "gitProviderType": "GitHub",
    "repositoryName": "Test Repo",
    "branchName": "Test Branch",
    "directoryName": "Test Directory/Test Subdirectory"
  },
  "myGitCredentials": {
    "source": "ConfiguredConnection",
    "connectionId": "3f2504e0-4f89-11d3-9a0c-0305e82c3301"
  }
}

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

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

Connect a workspace to GitHub example - GitHub Enterprise With Data Residency (ghe.com)

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

HTTP

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

{
  "gitProviderDetails": {
    "ownerName": "Test Owner",
    "customDomainName": "my-enterprise.ghe.com",
    "gitProviderType": "GitHub",
    "repositoryName": "Test Repo",
    "branchName": "Test Branch",
    "directoryName": "Test Directory/Test Subdirectory"
  },
  "myGitCredentials": {
    "source": "ConfiguredConnection",
    "connectionId": "3f2504e0-4f89-11d3-9a0c-0305e82c3301"
  }
}

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

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

Ορισμοί

Όνομα	Περιγραφή
AutomaticGitCredentials	Αυτόματα διαπιστευτήρια Git.
AzureDevOpsDetails	Λεπτομέρειες υπηρεσίας παροχής Azure DevOps.
ConfiguredConnectionGitCredentials	Διαμορφωμένα διαπιστευτήρια σύνδεσης Git.
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
GitConnectRequest	Περιέχει τα δεδομένα αίτησης σύνδεσης Git.
GitCredentialsSource	Η προέλευση διαπιστευτηρίων Git. Πρόσθετες προελεύσεις διαπιστευτηρίων Git μπορεί να προστεθούν με την πάροδο του χρόνου.
GitHubDetails	Λεπτομέρειες υπηρεσίας παροχής GitHub.
GitProviderType	Ένας τύπος υπηρεσίας παροχής Git. Πρόσθετοι τύποι υπηρεσιών παροχής μπορούν να προστεθούν με την πάροδο του χρόνου.

AutomaticGitCredentials

Αντικείμενο

Αυτόματα διαπιστευτήρια Git.

Όνομα	Δακτυλογραφώ	Περιγραφή
source	string: Automatic	Η προέλευση διαπιστευτηρίων Git.

AzureDevOpsDetails

Αντικείμενο

Λεπτομέρειες υπηρεσίας παροχής Azure DevOps.

Όνομα	Δακτυλογραφώ	Περιγραφή
branchName	string maxLength: 250	Το όνομα της διακλάδωσης. Το μέγιστο μήκος είναι 250 χαρακτήρες.
directoryName	string maxLength: 256	Η σχετική διαδρομή προς τον κατάλογο. Το μέγιστο μήκος είναι 256 χαρακτήρες.
gitProviderType	string: AzureDevOps	Ένας τύπος υπηρεσίας παροχής Git. Πρόσθετοι τύποι υπηρεσιών παροχής μπορούν να προστεθούν με την πάροδο του χρόνου.
organizationName	string maxLength: 100	Το όνομα οργανισμού. Το μέγιστο μήκος είναι 100 χαρακτήρες.
projectName	string maxLength: 100	Το όνομα του έργου. Το μέγιστο μήκος είναι 100 χαρακτήρες.
repositoryName	string maxLength: 128	Το όνομα του αποθετηρίου. Το μέγιστο μήκος είναι 128 χαρακτήρες.

ConfiguredConnectionGitCredentials

Αντικείμενο

Διαμορφωμένα διαπιστευτήρια σύνδεσης Git.

Όνομα	Δακτυλογραφώ	Περιγραφή
connectionId	string (uuid)	Το αναγνωριστικό αντικειμένου της σύνδεσης.
source	string: ConfiguredConnection	Η προέλευση διαπιστευτηρίων 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	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

GitConnectRequest

Αντικείμενο

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

Όνομα	Δακτυλογραφώ	Περιγραφή
gitProviderDetails	GitProviderDetails: AzureDevOpsDetails GitHubDetails	Τα στοιχεία της υπηρεσίας παροχής Git.
myGitCredentials	GitCredentials: AutomaticGitCredentials ConfiguredConnectionGitCredentials	Διαπιστευτήρια Git ειδικά για τον χρήστη για τον έλεγχο ταυτότητας στο GitProvider. Αυτά τα διαπιστευτήρια δεν κοινοποιούνται σε άλλους συμβάλλοντες στον χώρο εργασίας. Για το GitHub, αυτή η ιδιότητα είναι απαραίτητη. Για το AzureDevOps, αυτή η ιδιότητα είναι προαιρετική. Εάν δεν οριστεί, η προεπιλογή είναι AutomaticGitCredentials.

GitCredentialsSource

Απαρίθμηση

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

Τιμή	Περιγραφή
ConfiguredConnection	Τα διαπιστευτήρια Git λαμβάνονται μέσω μιας ρυθμισμένης σύνδεσης.
Automatic	Τα διαπιστευτήρια Git λαμβάνονται αυτόματα από το σύστημα, χρησιμοποιώντας προεπιλεγμένα διαπιστευτήρια, εάν υπάρχουν.
None	Τα διαπιστευτήρια Git δεν έχουν ρυθμιστεί.

GitHubDetails

Αντικείμενο

Λεπτομέρειες υπηρεσίας παροχής GitHub.

Όνομα	Δακτυλογραφώ	Περιγραφή
branchName	string maxLength: 250	Το όνομα της διακλάδωσης. Το μέγιστο μήκος είναι 250 χαρακτήρες.
customDomainName	string maxLength: 100	Σημείωση Η υποστήριξη για το GitHub Enterprise με θέση αποθήκευσης δεδομένων (ghe.com) βρίσκεται επί του παρόντος σε προεπισκόπηση. (μάθετε περισσότερα). Το όνομα του εταιρικού τομέα github εάν δεν είναι github.com. Υποστηρίζονται μόνο το GitHub Enterprise με τομείς αποθήκευσης δεδομένων (ghe.com). Το μέγιστο μήκος είναι 100 χαρακτήρες.
directoryName	string maxLength: 256	Η σχετική διαδρομή προς τον κατάλογο. Το μέγιστο μήκος είναι 256 χαρακτήρες.
gitProviderType	string: GitHub	Ένας τύπος υπηρεσίας παροχής Git. Πρόσθετοι τύποι υπηρεσιών παροχής μπορούν να προστεθούν με την πάροδο του χρόνου.
ownerName	string maxLength: 100	Το όνομα του κατόχου. Το μέγιστο μήκος είναι 100 χαρακτήρες.
repositoryName	string maxLength: 128	Το όνομα του αποθετηρίου. Το μέγιστο μήκος είναι 128 χαρακτήρες.

GitProviderType

Απαρίθμηση

Ένας τύπος υπηρεσίας παροχής Git. Πρόσθετοι τύποι υπηρεσιών παροχής μπορούν να προστεθούν με την πάροδο του χρόνου.

Τιμή	Περιγραφή
AzureDevOps	Υπηρεσία παροχής Azure DevOps
GitHub	Υπηρεσία παροχής GitHub

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

Git - Connect

Δικαιώματα

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

Περιορισμοί

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

Διεπαφή

Παράμετροι URI

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

Απαντήσεις

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

Connect a workspace to Azure DevOps example

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

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

Connect a workspace to Azure DevOps using configured connection example

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

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

Connect a workspace to GitHub example

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

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

Connect a workspace to GitHub example - GitHub Enterprise With Data Residency (ghe.com)

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

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

Ορισμοί

AutomaticGitCredentials

AzureDevOpsDetails

ConfiguredConnectionGitCredentials

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

GitConnectRequest

GitCredentialsSource

GitHubDetails

GitProviderType