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

Domains - Role Assignments Bulk Unassign

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

Σημείωση

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

Κατάργηση ανάθεσης των καθορισμένων διαχειριστών ή συμβαλλόντων από τον τομέα.

Δικαιώματα

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

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

Tenant.ReadWrite.All.

Περιορισμούς

Μέγιστος αριθμός 25 αιτήσεων ανά ένα λεπτό ανά κεφάλαιο.

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

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

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

Διεπαφή

POST https://api.fabric.microsoft.com/v1/admin/domains/{domainId}/roleAssignments/bulkUnassign

Παράμετροι URI

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

string (uuid)

Το αναγνωριστικό τομέα.

Κυρίως τμήμα αίτησης

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

DomainRole

Ο τύπος αίτησης ενημέρωσης.
principals

Principal[]

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

Αποκρίσεις

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

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

ErrorResponse

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

  • DomainSpecificUsersScopeCannotBeEmptyError - Τα μη εκχωρημένα μέλη τομέα απέτυχαν επειδή όταν η εμβέλεια των συμβαλλόντων οριστεί σε "Συγκεκριμένοι χρήστες και ομάδες", η λίστα χρηστών ή ομάδων δεν μπορεί να είναι κενή.

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

Unassign domain admins example
Unassign domain contributors example

Unassign domain admins example

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

POST https://api.fabric.microsoft.com/v1/admin/domains/97dd1d38-a4c6-41ed-bc4f-1e383f8ddd0f/roleAssignments/bulkUnassign

{
  "type": "Admins",
  "principals": [
    {
      "id": "796ce6ad-9163-4c16-9559-c68192a251de",
      "type": "User"
    }
  ]
}

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

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

Unassign domain contributors example

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

POST https://api.fabric.microsoft.com/v1/admin/domains/97dd1d38-a4c6-41ed-bc4f-1e383f8ddd0f/roleAssignments/bulkUnassign

{
  "type": "Contributors",
  "principals": [
    {
      "id": "796ce6ad-9163-4c16-9559-c68192a251de",
      "type": "User"
    }
  ]
}

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

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

Ορισμοί

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

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

Το ωφέλιμο φορτίο αίτησης για κατάργηση ανάθεσης μελών τομέα κατά κεφάλαιο.
ErrorRelatedResource

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

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

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

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

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

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

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

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

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

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

DomainRole

Απαρίθμηση

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

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

Τύπος αίτησης για διαχειριστές τομέα.
Contributors

Τύπος αίτησης συμβαλλόντων στον τομέα.

DomainRoleUnassignmentRequest

Object

Το ωφέλιμο φορτίο αίτησης για κατάργηση ανάθεσης μελών τομέα κατά κεφάλαιο.

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

Principal[]

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

DomainRole

Ο τύπος αίτησης ενημέρωσης.

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

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