Items - List SQL Endpoints

Υπηρεσία:: SQLEndpoint

Έκδοση API:: v1

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

Permissions

Ο καλών πρέπει να έχει ρόλο θεατή.

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

Workspace.Read.All ή Workspace.ReadWrite.All

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

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

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

Interface

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

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

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

Παράμετροι URI

Όνομα	Σε	Απαιτείται	Τύπος	Περιγραφή
workspaceId	path	True	string (uuid)	Το αναγνωριστικό χώρου εργασίας.
continuationToken	query		string	Ένα διακριτικό για την ανάκτηση της επόμενης σελίδας αποτελεσμάτων.
recursive	query		boolean	Παραθέτει στοιχεία σε έναν φάκελο και τους ένθετες φακέλους του ή απλώς έναν φάκελο μόνο. True - Παρατίθενται όλα τα στοιχεία στον φάκελο και οι ένθετοί του φάκελοι, False - Παρατίθενται μόνο τα στοιχεία στον φάκελο. Η προεπιλεγμένη τιμή είναι true.
rootFolderId	query		string (uuid)	Αυτή η παράμετρος επιτρέπει στους χρήστες να φιλτράρουν στοιχεία με βάση έναν συγκεκριμένο ριζικό φάκελο. Εάν δεν παρέχεται, ο χώρος εργασίας χρησιμοποιείται ως ριζικός φάκελος.

Αποκρίσεις

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

200 OK

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

SQLEndpoints

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

429 Too Many Requests

ErrorResponse

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

Κεφαλίδες

Retry-After: integer

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",
      "sensitivityLabel": {
        "id": "b7b4f4d9-3f0d-4b3e-8f3d-4f6d3f4f3f4f"
      }
    }
  ]
}

Ορισμοί

Όνομα	Περιγραφή
EntireTenantPrincipal	Αντιπροσωπεύει μια αρχή μισθωτή
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
GroupDetails	Λεπτομέρειες συγκεκριμένης ομάδας. Ισχύει όταν ο κύριος τύπος είναι `Group`.
GroupPrincipal	Αντιπροσωπεύει μια ομάδα ασφαλείας.
GroupType	Ο τύπος της ομάδας. Επιπλέον τύποι ομάδων μπορούν να προστεθούν με την πάροδο του χρόνου.
ItemTag	Αντιπροσωπεύει μια ετικέτα που έχει εφαρμοστεί σε ένα στοιχείο.
ItemType	Ο τύπος του στοιχείου. Επιπλέον τύποι στοιχείων μπορούν να προστεθούν με την πάροδο του χρόνου.
PrincipalType	Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.
SensitivityLabel	Αντιπροσωπεύει μια ετικέτα ευαισθησίας που έχει εφαρμοστεί σε ένα στοιχείο.
ServicePrincipalDetails	Λεπτομέρειες για την κύρια υπηρεσία. Ισχύει όταν ο κύριος τύπος είναι `ServicePrincipal`.
ServicePrincipalPrincipal	Αντιπροσωπεύει μια Microsoft Entra κύρια υπηρεσία.
ServicePrincipalProfileDetails	Λεπτομέρειες προφίλ κύριας υπηρεσίας. Ισχύει όταν ο κύριος τύπος είναι `ServicePrincipalProfile`.
ServicePrincipalProfilePrincipal	Αντιπροσωπεύει ένα προφίλ κύριας υπηρεσίας.
SQLEndpoint	Ένα αντικείμενο τελικού σημείου SQL.
SQLEndpoints	Μια λίστα τελικών σημείων SQL.
UserDetails	Συγκεκριμένες λεπτομέρειες για την κύρια χρήστη. Ισχύει όταν ο κύριος τύπος είναι `User`.
UserPrincipal	Αντιπροσωπεύει μια Microsoft Entra κύρια χρήστη.

EntireTenantPrincipal

Αντικείμενο

Αντιπροσωπεύει μια αρχή μισθωτή

Όνομα	Τύπος	Περιγραφή
displayName	string	Το εμφανιζόμενο όνομα της κύριας.
id	string (uuid)	Το αναγνωριστικό του διευθυντή.
type	string: EntireTenant	Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.

ErrorRelatedResource

Αντικείμενο

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

Όνομα	Τύπος	Περιγραφή
resourceId	string	Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα.
resourceType	string	Ο τύπος του πόρου που εμπλέκεται στο σφάλμα.

ErrorResponse

Αντικείμενο

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

Όνομα	Τύπος	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
isRetriable	boolean	Όταν είναι true, η αίτηση μπορεί να επαναληφθεί. Χρησιμοποιήστε την `Retry-After` κεφαλίδα απόκρισης για να προσδιορίσετε την καθυστέρηση, εάν υπάρχει.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
moreDetails	ErrorResponseDetails[]	Λίστα πρόσθετων λεπτομερειών σφάλματος.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.
requestId	string (uuid)	Το αναγνωριστικό της αίτησης που σχετίζεται με το σφάλμα.

ErrorResponseDetails

Αντικείμενο

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

Όνομα	Τύπος	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

GroupDetails

Αντικείμενο

Λεπτομέρειες συγκεκριμένης ομάδας. Ισχύει όταν ο κύριος τύπος είναι Group.

Όνομα	Τύπος	Περιγραφή
groupType	GroupType	Ο τύπος της ομάδας. Επιπλέον τύποι ομάδων μπορούν να προστεθούν με την πάροδο του χρόνου.

GroupPrincipal

Αντικείμενο

Αντιπροσωπεύει μια ομάδα ασφαλείας.

Όνομα	Τύπος	Περιγραφή
displayName	string	Το εμφανιζόμενο όνομα της κύριας.
groupDetails	GroupDetails	Λεπτομέρειες συγκεκριμένης ομάδας. Ισχύει όταν ο κύριος τύπος είναι `Group`.
id	string (uuid)	Το αναγνωριστικό του διευθυντή.
type	string: Group	Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.

GroupType

Απαρίθμηση

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

Τιμή	Περιγραφή
Unknown	Ο κύριος τύπος ομάδας είναι άγνωστος.
SecurityGroup	Το Principal είναι μια ομάδα ασφαλείας.
DistributionList	Το Principal είναι μια λίστα διανομής.

ItemTag

Αντικείμενο

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

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

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	Ένα Κατοπτρικό Αρχείο.

PrincipalType

Απαρίθμηση

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

Τιμή	Περιγραφή
User	Το Principal είναι μια κύρια Microsoft Entra χρήστη.
ServicePrincipal	Το Principal είναι μια Microsoft Entra κύρια υπηρεσία.
Group	Το Principal είναι μια ομάδα ασφαλείας.
ServicePrincipalProfile	Το Principal είναι ένα προφίλ κύριας υπηρεσίας.
EntireTenant	Το Principal αντιπροσωπεύει όλους τους χρήστες μισθωτή.

SensitivityLabel

Αντικείμενο

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

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

ServicePrincipalDetails

Αντικείμενο

Λεπτομέρειες για την κύρια υπηρεσία. Ισχύει όταν ο κύριος τύπος είναι ServicePrincipal.

Όνομα	Τύπος	Περιγραφή
aadAppId	string (uuid)	Το Microsoft Entra AppId της κύριας υπηρεσίας.

ServicePrincipalPrincipal

Αντικείμενο

Αντιπροσωπεύει μια Microsoft Entra κύρια υπηρεσία.

Όνομα	Τύπος	Περιγραφή
displayName	string	Το εμφανιζόμενο όνομα της κύριας.
id	string (uuid)	Το αναγνωριστικό του διευθυντή.
servicePrincipalDetails	ServicePrincipalDetails	Λεπτομέρειες για την κύρια υπηρεσία. Ισχύει όταν ο κύριος τύπος είναι `ServicePrincipal`.
type	string: ServicePrincipal	Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.

ServicePrincipalProfileDetails

Αντικείμενο

Λεπτομέρειες προφίλ κύριας υπηρεσίας. Ισχύει όταν ο κύριος τύπος είναι ServicePrincipalProfile.

Όνομα	Τύπος	Περιγραφή
parentPrincipal	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Η γονική οντότητα του προφίλ κύριας υπηρεσίας.

ServicePrincipalProfilePrincipal

Αντικείμενο

Αντιπροσωπεύει ένα προφίλ κύριας υπηρεσίας.

Όνομα	Τύπος	Περιγραφή
displayName	string	Το εμφανιζόμενο όνομα της κύριας.
id	string (uuid)	Το αναγνωριστικό του διευθυντή.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Λεπτομέρειες προφίλ κύριας υπηρεσίας. Ισχύει όταν ο κύριος τύπος είναι `ServicePrincipalProfile`.
type	string: ServicePrincipalProfile	Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.

SQLEndpoint

Αντικείμενο

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

Όνομα	Τύπος	Περιγραφή
defaultIdentity	Principal: EntireTenantPrincipal GroupPrincipal ServicePrincipalPrincipal ServicePrincipalProfilePrincipal UserPrincipal	Η προεπιλεγμένη ταυτότητα του στοιχείου.
description	string	Η περιγραφή του στοιχείου.
displayName	string	Το εμφανιζόμενο όνομα του στοιχείου.
folderId	string (uuid)	Το αναγνωριστικό φακέλου.
id	string (uuid)	Το αναγνωριστικό στοιχείου.
sensitivityLabel	SensitivityLabel	Η ετικέτα ευαισθησίας στοιχείου.
tags	ItemTag[]	Λίστα εφαρμοσμένων ετικετών.
type	ItemType	Ο τύπος στοιχείου.
workspaceId	string (uuid)	Το αναγνωριστικό χώρου εργασίας.

SQLEndpoints

Αντικείμενο

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

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

UserDetails

Αντικείμενο

Συγκεκριμένες λεπτομέρειες για την κύρια χρήστη. Ισχύει όταν ο κύριος τύπος είναι User.

Όνομα	Τύπος	Περιγραφή
userPrincipalName	string	Το κύριο όνομα χρήστη.

UserPrincipal

Αντικείμενο

Αντιπροσωπεύει μια Microsoft Entra κύρια χρήστη.

Όνομα	Τύπος	Περιγραφή
displayName	string	Το εμφανιζόμενο όνομα της κύριας.
id	string (uuid)	Το αναγνωριστικό του διευθυντή.
type	string: User	Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.
userDetails	UserDetails	Συγκεκριμένες λεπτομέρειες για την κύρια χρήστη. Ισχύει όταν ο κύριος τύπος είναι `User`.