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

Connections - List Connection Role Assignments

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

Σημείωση

Αυτό το API είναι σε προεπισκόπηση.

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

Δικαιώματα

  • Ο καλών πρέπει να έχει χρήστη ή υψηλότερο ρόλο στη σύνδεση ή να είναι διαχειριστή στην πύλη που είναι συνδεδεμένη με τη σύνδεση.

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

Connection.Read.All ή Connection.ReadWrite.All

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

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

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

Διεπαφή

GET https://api.fabric.microsoft.com/v1/connections/{connectionId}/roleAssignments
Με προαιρετικές παραμέτρους: 
GET https://api.fabric.microsoft.com/v1/connections/{connectionId}/roleAssignments?continuationToken={continuationToken}

Παράμετροι URI

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

string

uuid

Το αναγνωριστικό της σύνδεσης.
continuationToken
 query

string

Ένα διακριτικό για την ανάκτηση της επόμενης σελίδας αποτελεσμάτων.

Αποκρίσεις

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

ConnectionRoleAssignments

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

ErrorResponse

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

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

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

List connection role assignment example
List connection role assignment with continuation example

List connection role assignment example

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

GET https://api.fabric.microsoft.com/v1/connections/9558d649-84f1-4b7e-850a-59b5d0ae95eb/roleAssignments

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

Κωδικός κατάστασης:
200 
{
  "value": [
    {
      "id": "1c15c348-dd88-4065-8f25-57581c216bcf",
      "principal": {
        "id": "1c15c348-dd88-4065-8f25-57581c216bcf",
        "type": "User"
      },
      "role": "Owner"
    },
    {
      "id": "d3a7dbf7-6641-48f2-851e-d71bbf9d90c4",
      "principal": {
        "id": "d3a7dbf7-6641-48f2-851e-d71bbf9d90c4",
        "type": "Group"
      },
      "role": "Owner"
    },
    {
      "id": "48ba22da-4431-4da4-8b70-3401685bf9e5",
      "principal": {
        "id": "48ba22da-4431-4da4-8b70-3401685bf9e5",
        "type": "Group"
      },
      "role": "User"
    },
    {
      "id": "1dfa1747-ce76-4caf-99c8-360b95f9f17a",
      "principal": {
        "id": "1dfa1747-ce76-4caf-99c8-360b95f9f17a",
        "type": "User"
      },
      "role": "UserWithReshare"
    }
  ]
}

List connection role assignment with continuation example

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

GET https://api.fabric.microsoft.com/v1/connections/9558d649-84f1-4b7e-850a-59b5d0ae95eb/roleAssignments

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

Κωδικός κατάστασης:
200 
{
  "value": [
    {
      "id": "1c15c348-dd88-4065-8f25-57581c216bcf",
      "principal": {
        "id": "1c15c348-dd88-4065-8f25-57581c216bcf",
        "type": "User"
      },
      "role": "Owner"
    },
    {
      "id": "d3a7dbf7-6641-48f2-851e-d71bbf9d90c4",
      "principal": {
        "id": "d3a7dbf7-6641-48f2-851e-d71bbf9d90c4",
        "type": "Group"
      },
      "role": "Owner"
    },
    {
      "id": "48ba22da-4431-4da4-8b70-3401685bf9e5",
      "principal": {
        "id": "48ba22da-4431-4da4-8b70-3401685bf9e5",
        "type": "Group"
      },
      "role": "User"
    },
    {
      "id": "1dfa1747-ce76-4caf-99c8-360b95f9f17a",
      "principal": {
        "id": "1dfa1747-ce76-4caf-99c8-360b95f9f17a",
        "type": "User"
      },
      "role": "UserWithReshare"
    }
  ],
  "continuationToken": "LDEsMTAwMDAwLDA%3D",
  "continuationUri": "https://api.fabric.microsoft.com/v1/connections/9558d649-84f1-4b7e-850a-59b5d0ae95eb/roleAssignments?continuationToken=LDEsMTAwMDAwLDA%3D"
}

Ορισμοί

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

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

Η ανάθεση ρόλου σύνδεσης για μια κύρια.
ConnectionRoleAssignments
ErrorRelatedResource

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

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

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

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

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

Αντιπροσωπεύει μια ταυτότητα ή μια ομάδα Microsoft Entra.
PrincipalType

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

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

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

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

ConnectionRole

Απαρίθμηση

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

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

Ενεργοποιεί την πρόσβαση κυριότητας για τη σύνδεση.
User

Επιτρέπει την πρόσβαση χρήστη για τη σύνδεση.
UserWithReshare

Ενεργοποιεί το χρήστη με πρόσβαση κοινής χρήσης εκ νέου για τη σύνδεση.

ConnectionRoleAssignment

Object

Η ανάθεση ρόλου σύνδεσης για μια κύρια.

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

string

uuid

Το αναγνωριστικό αντικειμένου της ανάθεσης ρόλου σύνδεσης.
principal

Principal

Ο διευθυντής.
role

ConnectionRole

Ο ρόλος σύνδεσης της κύριας.

ConnectionRoleAssignments

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

string

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

string

Το URI της δέσμης επόμενου συνόλου αποτελεσμάτων. Εάν δεν υπάρχουν άλλες εγγραφές, καταργείται από την απόκριση.
value

ConnectionRoleAssignment[]

Μια λίστα αναθέσεων ρόλου σύνδεσης.

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

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

GroupDetails

Object

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

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

GroupType

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

GroupType

Απαρίθμηση

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

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

Το Principal είναι μια λίστα διανομής.
SecurityGroup

Το Principal είναι μια ομάδα ασφαλείας.
Unknown

Ο κύριος τύπος ομάδας είναι άγνωστος.

Principal

Object

Αντιπροσωπεύει μια ταυτότητα ή μια ομάδα Microsoft Entra.

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

string

Το εμφανιζόμενο όνομα της κύριας.
groupDetails

GroupDetails

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

string

uuid

Το αναγνωριστικό του διευθυντή.
servicePrincipalDetails

ServicePrincipalDetails

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

ServicePrincipalProfileDetails

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

PrincipalType

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

UserDetails

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

PrincipalType

Απαρίθμηση

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

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

Το Principal είναι μια ομάδα ασφαλείας.
ServicePrincipal

Το Principal είναι μια κύρια υπηρεσία Microsoft Entra.
ServicePrincipalProfile

Το Principal είναι ένα προφίλ κύριας υπηρεσίας.
User

Το Principal είναι μια κύρια χρήστης του Microsoft Entra.

ServicePrincipalDetails

Object

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

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

string

uuid

Το Microsoft Entra AppId της κύριας υπηρεσίας.

ServicePrincipalProfileDetails

Object

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

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

Principal

Η γονική οντότητα του προφίλ κύριας υπηρεσίας.

UserDetails

Object

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

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

string

Το κύριο όνομα χρήστη.