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

Git - Get Connection

  • Αναφορά
Υπηρεσία:
Core
Έκδοση API:
v1

Επιστρέφει λεπτομέρειες σύνδεσης git για τον καθορισμένο χώρο εργασίας.

Δικαιώματα

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

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

Workspace.Read.All ή Workspace.ReadWrite.All

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

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

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

Διεπαφή

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

Παράμετροι URI

Όνομα Σε Απαιτείται Τύπος Περιγραφή
workspaceId
 path True

string (uuid)

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

Αποκρίσεις

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

GitConnection

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

ErrorResponse

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

  • UnknownError - Παρουσιάστηκε σφάλμα.

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

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

Get Git connection details example
Workspace not connected to git example

Get Git connection details example

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

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

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

Κωδικός κατάστασης:
200 
{
  "gitProviderDetails": {
    "organizationName": "Test Organization",
    "projectName": "Test Project",
    "gitProviderType": "AzureDevOps",
    "repositoryName": "Test Repo",
    "branchName": "Test Branch",
    "directoryName": ""
  },
  "gitSyncDetails": {
    "head": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
    "lastSyncTime": "2021-11-20T09:26:43.153"
  },
  "gitConnectionState": "ConnectedAndInitialized"
}

Workspace not connected to git example

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

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

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

Κωδικός κατάστασης:
200 
{
  "gitProviderDetails": null,
  "gitSyncDetails": null,
  "gitConnectionState": "NotConnected"
}

Ορισμοί

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

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

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

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

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

Περιέχει τις λεπτομέρειες σύνδεσης Git.
GitConnectionState

Κατάσταση σύνδεσης Git. Επιπλέον τύποι κατάστασης σύνδεσης μπορούν να προστεθούν με την πάροδο του χρόνου.
GitHubDetails

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

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

Περιέχει τις λεπτομέρειες συγχρονισμού.

AzureDevOpsDetails

Object

Λεπτομέρειες υπηρεσίας παροχής 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 χαρακτήρες.

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

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

GitConnection

Object

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

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

GitConnectionState

Κατάσταση σύνδεσης Git. Επιπλέον τύποι κατάστασης σύνδεσης μπορούν να προστεθούν με την πάροδο του χρόνου.
gitProviderDetails GitProviderDetails:

Τα στοιχεία της υπηρεσίας παροχής Git.
gitSyncDetails

GitSyncDetails

Περιέχει τις λεπτομέρειες συγχρονισμού.

GitConnectionState

Απαρίθμηση

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

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

Συνδεδεμένη κατάσταση.
ConnectedAndInitialized

Συνδεδεμένη και αρχικοποιημένη κατάσταση.
NotConnected

Δεν είναι συνδεδεμένη κατάσταση.

GitHubDetails

Object

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

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

string

maxLength: 250

Το όνομα της διακλάδωσης. Το μέγιστο μήκος είναι 250 χαρακτήρες.
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

GitSyncDetails

Object

Περιέχει τις λεπτομέρειες συγχρονισμού.

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

string

Ο πλήρης Ασφαλής αλγόριθμος κατακερματισμού 1 (SHA-1) του συγχρονισμένου αναγνωριστικού δέσμευσης.
lastSyncTime

string (date-time)

Η ημερομηνία και η ώρα της κατάστασης τελευταίου συγχρονισμού.