Workspaces - Grant Admin Temporary Access

Υπηρεσία:
Admin
Έκδοση API:
v1

Εκχωρεί στον διαχειριστή προσωρινή πρόσβαση (24h) στον "Ο χώρος εργασίας μου" ενός χρήστη.

Δικαιώματα Πρόσβασης

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

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

Tenant.ReadWrite.All

Περιορισμοί

Το πολύ 25 αιτήσεις ανά λεπτό.

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

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

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

Διεπαφή

POST https://api.fabric.microsoft.com/v1/admin/workspaces/{workspaceId}/grantAdminTemporaryAccess

Παράμετροι URI

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

string (uuid)

Το αναγνωριστικό χώρου εργασίας.

Αποκρίσεις

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

OK
429 Too Many Requests

ErrorResponse

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

Κεφαλίδες

Retry-After: integer
Other Status Codes

ErrorResponse

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

  • EntityNotFound - Το αναγνωριστικό χώρου εργασίας δεν υπάρχει ή ο χώρος εργασίας δεν είναι "Ο χώρος εργασίας μου".

  • InsufficientScopes - Ο καλών δεν έχει δικαιώματα κλήσης του API.

  • BadRequest - Έχει ήδη εκχωρηθεί πρόσβαση στον προσωπικό χώρο εργασίας.

  • Μη εξουσιοδοτημένο - Μόνο οι διαχειριστές μισθωτών και οι οντότητες υπηρεσίας με ρόλο διαχειριστή μισθωτή είναι εξουσιοδοτημένοι να καλούν το API.

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

Grant admin temporary access to workspace example

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

POST https://api.fabric.microsoft.com/v1/admin/workspaces/f089354e-8366-4e18-aea3-4cb4a3a50b48/grantAdminTemporaryAccess

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

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

Ορισμοί

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

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

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

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

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

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