Items - Associate Identity (beta)

Υπηρεσία:: Core

Έκδοση API:: v1

Συσχετίζει την προεπιλεγμένη ταυτότητα με ένα στοιχείο.

Σημείωμα

Αυτό το API αποτελεί μέρος μιας έκδοσης Beta και παρέχεται μόνο για σκοπούς αξιολόγησης και ανάπτυξης. Μπορεί να αλλάξει με βάση τα σχόλια και δεν συνιστάται για χρήση στην παραγωγή. Κατά την κλήση αυτού του API, οι καλούντες πρέπει να καθορίσουν true ως τιμή για την παράμετρο betaερωτήματος .

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

Αυτό το API υποστηρίζεται για διάφορους τύπους στοιχείων, βρείτε τους υποστηριζόμενους τύπους στοιχείων και πληροφορίες σχετικά με τη δομή ορισμού τους στο Επισκόπηση διαχείρισης στοιχείων.

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

Ο καλών πρέπει να έχει δικαιώματα ανάγνωσης και εγγραφής για το στοιχείο.

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

Για τα API στοιχείων χρησιμοποιήστε αυτούς τους τύπους εμβέλειας:

Γενική εμβέλεια: Item.ReadWrite.All
Συγκεκριμένη εμβέλεια: itemType. ReadWrite.All (για παράδειγμα: Notebook.ReadWrite.All)

Για περισσότερες πληροφορίες σχετικά με τις εμβέλειες, ανατρέξτε στο θέμα: εμβέλειες, άρθρο.

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

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

Ταυτότητα	Υποστήριξη
Χρήστης	Ναι
Υπηρεσίας και διαχειριζόμενες ταυτότητες	Όταν υποστηρίζεται ο τύπος στοιχείου στην κλήση. Ελέγξτε το αντίστοιχο API για τον τύπο στοιχείου που καλείτε, για να δείτε εάν η κλήση σας υποστηρίζεται.

Διεπαφή

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/identities/default/assign?beta={beta}

Παράμετροι URI

Όνομα	Σε	Απαιτείται	Τύπος	Περιγραφή
itemId	path	True	string (uuid)	Το αναγνωριστικό στοιχείου.
workspaceId	path	True	string (uuid)	Το αναγνωριστικό χώρου εργασίας.
beta	query	True	boolean	Αυτή η απαιτούμενη παράμετρος πρέπει να οριστεί για `true` πρόσβαση σε αυτό το API, το οποίο βρίσκεται αυτήν τη στιγμή σε beta.

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

Όνομα	Απαιτείται	Τύπος	Περιγραφή
assignmentType	True	IdentityAssignmentEntityType	Ο τύπος του θέματος που υποβάλλει αίτηση για συσχετισμό ταυτότητας.

Αποκρίσεις

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

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

Associate identity example

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

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715/identities/default/assign?beta=True

{
  "assignmentType": "Caller"
}

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

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

{
  "assignmentStatus": [
    {
      "itemId": "eab1679a-8cab-40d6-9ba6-5c2a07a7ce81",
      "status": "Succeeded"
    },
    {
      "itemId": "8eedb1b0-3af8-4b17-8e7e-663e61e12211",
      "parentItemId": "eab1679a-8cab-40d6-9ba6-5c2a07a7ce81",
      "status": "Succeeded"
    },
    {
      "itemId": "83b128a3-f58f-4eee-ab0b-e7e25a748f54",
      "parentItemId": "eab1679a-8cab-40d6-9ba6-5c2a07a7ce81",
      "status": "Failed",
      "errorInfo": {
        "errorCode": "AssignmentFailed",
        "message": "The assignment operation failed due to insufficient permissions."
      }
    }
  ]
}

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

Location: https://api.fabric.microsoft.com/v1/operations/427f6c34-b64e-4ee4-8ea5-b533c0e203ef
x-ms-operation-id: 427f6c34-b64e-4ee4-8ea5-b533c0e203ef
Retry-After: 30

Ορισμοί

Όνομα	Περιγραφή
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
IdentityAssignmentEntityType	Ο τύπος του θέματος που υποβάλλει αίτηση για συσχετισμό ταυτότητας.
IdentityAssignmentStatusType	Η κατάσταση της ανάθεσης ταυτότητας. Μπορεί να προστεθεί επιπλέον κατάσταση με την πάροδο του χρόνου.
ItemAssignmentStatus	Η κατάσταση μιας ανάθεσης ταυτότητας σε ένα στοιχείο.
UpdateItemIdentityRequest	Ωφέλιμο φορτίο αίτησης ταυτότητας συνεργάτη.
UpdateItemIdentityResponse	Συσχέτιση απόκρισης ταυτότητας.

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	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

IdentityAssignmentEntityType

Απαρίθμηση

Ο τύπος του θέματος που υποβάλλει αίτηση για συσχετισμό ταυτότητας.

Τιμή	Περιγραφή
Caller	Χρήστης ή κύρια υπηρεσία που υποβάλλει την αίτηση ταυτότητας συνεργάτη.

IdentityAssignmentStatusType

Απαρίθμηση

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

Τιμή	Περιγραφή
Succeeded	Η ταυτότητα εκχωρείται με επιτυχία στο στοιχείο.
Failed	Η ανάθεση ταυτότητας απέτυχε.

ItemAssignmentStatus

Αντικείμενο

Η κατάσταση μιας ανάθεσης ταυτότητας σε ένα στοιχείο.

Όνομα	Τύπος	Περιγραφή
errorInfo	ErrorResponseDetails	Οι πληροφορίες σφάλματος εάν η ανάθεση ταυτότητας απέτυχε.
itemId	string (uuid)	Το αναγνωριστικό του στοιχείου.
parentItemId	string (uuid)	Το αναγνωριστικό του γονικού στοιχείου.
status	IdentityAssignmentStatusType	Η κατάσταση της ανάθεσης ταυτότητας. Μπορεί να προστεθεί επιπλέον κατάσταση με την πάροδο του χρόνου.

UpdateItemIdentityRequest

Αντικείμενο

Ωφέλιμο φορτίο αίτησης ταυτότητας συνεργάτη.

Όνομα	Τύπος	Περιγραφή
assignmentType	IdentityAssignmentEntityType	Ο τύπος του θέματος που υποβάλλει αίτηση για συσχετισμό ταυτότητας.

UpdateItemIdentityResponse

Αντικείμενο

Συσχέτιση απόκρισης ταυτότητας.

Όνομα	Τύπος	Περιγραφή
assignmentStatus	ItemAssignmentStatus[]	Η ταυτότητα που εκχωρήθηκε στο στοιχείο μετά την ενημέρωση.