Items - List SQL Endpoints

Υπηρεσία:

SQLEndpoint

Έκδοση API:

v1

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

Δικαιώματα

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

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

Workspace.Read.All ή Workspace.ReadWrite.All

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

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

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

Διεπαφή

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

Με προαιρετικές παραμέτρους:

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/sqlEndpoints?continuationToken={continuationToken}

Παράμετροι URI

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

Αποκρίσεις

Όνομα	Τύπος	Περιγραφή
200 OK	SQLEndpoints	Η αίτηση ολοκληρώθηκε με επιτυχία.
Other Status Codes	ErrorResponse	Συνήθεις κωδικοί σφαλμάτων: InvalidItemType - Μη έγκυρος τύπος στοιχείου.

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

List SQL endpoints in workspace example

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

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/sqlEndpoints

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

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

200

{
  "value": [
    {
      "id": "3546052c-ae64-4526-b1a8-52af7761426f",
      "displayName": "SQLEndpoint Name 1",
      "description": "A SQL endpoint description.",
      "type": "SQLEndpoint",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229"
    }
  ]
}

Ορισμοί

Όνομα	Περιγραφή
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
ItemTag	Αντιπροσωπεύει μια ετικέτα που έχει εφαρμοστεί σε ένα στοιχείο.
ItemType	Ο τύπος του στοιχείου. Επιπλέον τύποι στοιχείων μπορούν να προστεθούν με την πάροδο του χρόνου.
SQLEndpoint	Ένα αντικείμενο τελικού σημείου SQL.
SQLEndpoints	Μια λίστα τελικών σημείων SQL.

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	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

ItemTag

Object

Αντιπροσωπεύει μια ετικέτα που έχει εφαρμοστεί σε ένα στοιχείο.

Όνομα	Τύπος	Περιγραφή
displayName	string	Το όνομα της ετικέτας.
id	string (uuid)	Το αναγνωριστικό ετικέτας.

ItemType

Απαρίθμηση

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

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

SQLEndpoint

Object

Ένα αντικείμενο τελικού σημείου SQL.

Όνομα	Τύπος	Περιγραφή
description	string	Η περιγραφή του στοιχείου.
displayName	string	Το εμφανιζόμενο όνομα του στοιχείου.
folderId	string (uuid)	Το αναγνωριστικό φακέλου.
id	string (uuid)	Το αναγνωριστικό στοιχείου.
tags	ItemTag[]	Λίστα εφαρμοσμένων ετικετών.
type	ItemType	Ο τύπος στοιχείου.
workspaceId	string (uuid)	Το αναγνωριστικό χώρου εργασίας.

SQLEndpoints

Object

Μια λίστα τελικών σημείων SQL.

Όνομα	Τύπος	Περιγραφή
continuationToken	string	Το διακριτικό για την επόμενη δέσμη συνόλου αποτελεσμάτων. Εάν δεν υπάρχουν άλλες εγγραφές, καταργείται από την απόκριση.
continuationUri	string	Το URI της δέσμης επόμενου συνόλου αποτελεσμάτων. Εάν δεν υπάρχουν άλλες εγγραφές, καταργείται από την απόκριση.
value	SQLEndpoint[]	Μια λίστα τελικών σημείων SQL.