Items - Delete Item

Υπηρεσία:: Core

Έκδοση API:: v1

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

Σημείωμα

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

Δικαιώματα

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

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

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

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

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

Όρια περιορισμού αριθμού αιτήσεων

Τύπος ορίου	Τιμή
Ενοποιημένο όριο για API πλατφόρμας	500 κλήσεις/λεπτά
Όριο API	200 κλήσεις/λεπτά

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

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

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

Διεπαφή

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}

Με προαιρετικές παραμέτρους:

DELETE https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}?hardDelete={hardDelete}

Παράμετροι URI

Ονομασία	Σε	Απαιτείται	Τύπος	Περιγραφή
itemId	path	True	string (uuid)	Το αναγνωριστικό στοιχείου.
workspaceId	path	True	string (uuid)	Το αναγνωριστικό χώρου εργασίας.
hardDelete	query		boolean	Καθορίζει εάν θα εκτελεστεί μια σκληρή διαγραφή. Όταν οριστεί σε `true`, το στοιχείο διαγράφεται οριστικά και δεν είναι δυνατή η ανάκτηση του. Όταν οριστεί σε `false` ή δεν καθορίζεται, το στοιχείο διαγράφεται οριστικά εάν το υποστηρίζει ο τύπος στοιχείου.

Αποκρίσεις

Ονομασία Τύπος Περιγραφή

200 OK

Ονομασία	Τύπος	Περιγραφή
200 OK		Η αίτηση ολοκληρώθηκε με επιτυχία.
429 Too Many Requests	ErrorResponse	Έγινε υπέρβαση του ορίου επιτοκίου υπηρεσίας. Ο διακομιστής επιστρέφει μια `Retry-After` κεφαλίδα που υποδεικνύει, σε δευτερόλεπτα, πόσο πρέπει να περιμένει ο υπολογιστής-πελάτης πριν από την αποστολή πρόσθετων αιτήσεων. Κεφαλίδες Retry-After: integer
Other Status Codes	ErrorResponse	Συνήθεις κωδικοί σφαλμάτων: ItemNotFound - Το στοιχείο που ζητήθηκε δεν βρέθηκε. InsufficientWorkspaceRole - Ο χρήστης δεν διαθέτει επαρκή ρόλο χώρου εργασίας. FeatureNotAvailable - Αυτό μπορεί να οφείλεται στο ότι η δυνατότητα προσωρινής διαγραφής δεν είναι διαθέσιμη. Μη υποστηριζόμενοItemType - Αυτό μπορεί να οφείλεται στη δυνατότητα προσωρινής διαγραφής που δεν υποστηρίζεται από τον τύπο στοιχείου που ζητήθηκε. TenantSwitchDisabled - Αυτό μπορεί να οφείλεται στην απενεργοποίηση της δυνατότητας προσωρινής διαγραφής από τον διαχειριστή μισθωτή. InvalidTargetItemStateForSoftDeletion - Το στοιχείο είναι σε μη έγκυρες καταστάσεις για προσωρινή διαγραφή. InvalidParentItemStateForSoftDeletion - Το γονικό στοιχείο του στοιχείου δεν είναι σε ενεργή κατάσταση.

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

429 Too Many Requests

ErrorResponse

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

Κεφαλίδες

Retry-After: integer

Other Status Codes

ErrorResponse

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

ItemNotFound - Το στοιχείο που ζητήθηκε δεν βρέθηκε.
InsufficientWorkspaceRole - Ο χρήστης δεν διαθέτει επαρκή ρόλο χώρου εργασίας.
FeatureNotAvailable - Αυτό μπορεί να οφείλεται στο ότι η δυνατότητα προσωρινής διαγραφής δεν είναι διαθέσιμη.
Μη υποστηριζόμενοItemType - Αυτό μπορεί να οφείλεται στη δυνατότητα προσωρινής διαγραφής που δεν υποστηρίζεται από τον τύπο στοιχείου που ζητήθηκε.
TenantSwitchDisabled - Αυτό μπορεί να οφείλεται στην απενεργοποίηση της δυνατότητας προσωρινής διαγραφής από τον διαχειριστή μισθωτή.
InvalidTargetItemStateForSoftDeletion - Το στοιχείο είναι σε μη έγκυρες καταστάσεις για προσωρινή διαγραφή.
InvalidParentItemStateForSoftDeletion - Το γονικό στοιχείο του στοιχείου δεν είναι σε ενεργή κατάσταση.

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

Delete an item example

Hard delete an item example

Delete an item example

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

HTTP

DELETE https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715

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

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

Hard delete an item example

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

HTTP

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

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

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

Ορισμοί

Ονομασία	Περιγραφή
ErrorParameter	Μια δομημένη παράμετρος που παρέχει πρόσθετο περιβάλλον αναγνώσιμο από υπολογιστή σχετικά με ένα σφάλμα.
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.

ErrorParameter

Αντικείμενο

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

Ονομασία	Τύπος	Περιγραφή
message	string	Μια αναγνώσιμη από τον άνθρωπο περιγραφή της έννοιας της παραμέτρου.
name	string	Το αναγνωριστικό παραμέτρου.
value	string	Η τιμή της παραμέτρου.

ErrorRelatedResource

Αντικείμενο

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

Ονομασία	Τύπος	Περιγραφή
resourceId	string	Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα.
resourceType	string	Ο τύπος του πόρου που εμπλέκεται στο σφάλμα.

ErrorResponse

Αντικείμενο

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

Ονομασία	Τύπος	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
isRetriable	boolean	Όταν είναι true, η αίτηση μπορεί να επαναληφθεί. Χρησιμοποιήστε την `Retry-After` κεφαλίδα απόκρισης για να προσδιορίσετε την καθυστέρηση, εάν υπάρχει.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
moreDetails	ErrorResponseDetails[]	Λίστα πρόσθετων λεπτομερειών σφάλματος.
parameters	ErrorParameter[]	Δομημένες παράμετροι που παρέχουν πρόσθετο περιβάλλον αναγνώσιμο από υπολογιστή σχετικά με το σφάλμα.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.
requestId	string (uuid)	Το αναγνωριστικό της αίτησης που σχετίζεται με το σφάλμα.

ErrorResponseDetails

Αντικείμενο

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

Ονομασία	Τύπος	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
parameters	ErrorParameter[]	Δομημένες παράμετροι που παρέχουν πρόσθετο περιβάλλον αναγνώσιμο από υπολογιστή σχετικά με το σφάλμα.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.