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

Domains - Assign Domain Workspaces By Principals

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

Σημείωση

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

Αναθέστε χώρους εργασίας στον καθορισμένο τομέα, όταν μία από τις καθορισμένες κύριες αρχές έχει δικαιώματα διαχειριστή στον χώρο εργασίας.
Οι εκ των προτέρων αναθέσεις τομέα θα αντικατασταθούν, εκτός εάν η μαζική εκ νέου ανάθεση αποκλειστεί από τις ρυθμίσεις μισθωτή διαχείρισης τομέα.

Αυτό το API υποστηρίζει λειτουργίες μεγάλης διάρκειας (LRO).

Δικαιώματα

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

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

Tenant.ReadWrite.All.

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

Έως 10 αιτήσεις ανά ένα λεπτό ανά κεφάλαιο.

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

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

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

Διεπαφή

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

Παράμετροι URI

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

string

uuid

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

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

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

Principal[]

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

Αποκρίσεις

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

Η λειτουργία βρίσκεται σε εξέλιξη

Κεφαλίδες

  • Location: string
  • Retry-After: integer
  • x-ms-operation-id: string
Other Status Codes

ErrorResponse

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

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

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

Assign domain workspaces example

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

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

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

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

Κωδικός κατάστασης:
202 
Location: https://api.fabric.microsoft.com/operations/cfafbeb1-8037-4d0c-896e-a46fb27ff227
x-ms-operation-id: cfafbeb1-8037-4d0c-896e-a46fb27ff227
Retry-After: 30

Ορισμοί

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

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

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

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

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

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

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

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

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

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

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

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

AssignDomainWorkspacesByPrincipalsRequest

Object

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

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

Principal[]

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

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

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