Items - Update Item
Ενημερώνει τις ιδιότητες του καθορισμένου στοιχείου.
Αυτό το API υποστηρίζεται για διάφορους τύπους στοιχείων, βρείτε τους υποστηριζόμενους τύπους στοιχείων και πληροφορίες σχετικά με τη δομή ορισμού τους στο Επισκόπηση διαχείρισης στοιχείων.
Δικαιώματα
Ο καλών πρέπει να έχει συμβάλλοντα ή υψηλότερο ρόλο στον χώρο εργασίας.
Απαιτούμενες εμβέλειες με ανάθεση
Για τα API στοιχείων χρησιμοποιήστε αυτούς τους τύπους εμβέλειας:
- Γενική εμβέλεια: Item.ReadWrite.All
- Συγκεκριμένη εμβέλεια: itemType. ReadWrite.All (για παράδειγμα: Notebook.ReadWrite.All)
Για περισσότερες πληροφορίες σχετικά με τις εμβέλειες, ανατρέξτε στο θέμα: εμβέλειες, άρθρο.
Υποστηριζόμενες ταυτότητες Microsoft Entra
Αυτό το API υποστηρίζει τις ταυτότητες Microsoft που παρατίθενται σε αυτή την ενότητα.
Διεπαφή
PATCH https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}
Παράμετροι URI
Όνομα | Σε | Απαιτείται | Τύπος | Περιγραφή |
---|---|---|---|---|
item
|
path | True |
string uuid |
Το αναγνωριστικό στοιχείου. |
workspace
|
path | True |
string uuid |
Το αναγνωριστικό χώρου εργασίας. |
Κυρίως τμήμα αίτησης
Όνομα | Τύπος | Περιγραφή |
---|---|---|
description |
string |
Η περιγραφή του στοιχείου. Το μέγιστο μήκος είναι 256 χαρακτήρες. |
displayName |
string |
Το εμφανιζόμενο όνομα του στοιχείου. Το εμφανιζόμενο όνομα πρέπει να ακολουθεί τους κανόνες ονομασίας σύμφωνα με τον τύπο στοιχείου. |
Αποκρίσεις
Όνομα | Τύπος | Περιγραφή |
---|---|---|
200 OK |
Η αίτηση ολοκληρώθηκε με επιτυχία. |
|
Other Status Codes |
Συνήθεις κωδικοί σφαλμάτων:
|
Παραδείγματα
Update an item example
Δείγμα αίτησης
PATCH https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/items/5b218778-e7a5-4d73-8187-f10824047715
{
"displayName": "Item's New name",
"description": "Item's New description"
}
Δείγμα απόκρισης
{
"displayName": "Item's New name",
"description": "Item's New description",
"type": "Lakehouse",
"workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"id": "5b218778-e7a5-4d73-8187-f10824047715"
}
Ορισμοί
Όνομα | Περιγραφή |
---|---|
Error |
Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα. |
Error |
Η απόκριση σφάλματος. |
Error |
Οι λεπτομέρειες της απόκρισης σφάλματος. |
Item |
Ένα αντικείμενο στοιχείου. |
Item |
Ο τύπος του στοιχείου. Επιπλέον τύποι στοιχείων μπορούν να προστεθούν με την πάροδο του χρόνου. |
Update |
Ενημέρωση αίτησης στοιχείου. |
ErrorRelatedResource
Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
resourceId |
string |
Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα. |
resourceType |
string |
Ο τύπος του πόρου που εμπλέκεται στο σφάλμα. |
ErrorResponse
Η απόκριση σφάλματος.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
errorCode |
string |
Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της. |
message |
string |
Μια αναγνώσιμη αναπαράσταση του σφάλματος. |
moreDetails |
Λίστα πρόσθετων λεπτομερειών σφάλματος. |
|
relatedResource |
Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα. |
|
requestId |
string |
Το αναγνωριστικό της αίτησης που σχετίζεται με το σφάλμα. |
ErrorResponseDetails
Οι λεπτομέρειες της απόκρισης σφάλματος.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
errorCode |
string |
Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της. |
message |
string |
Μια αναγνώσιμη αναπαράσταση του σφάλματος. |
relatedResource |
Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα. |
Item
Ένα αντικείμενο στοιχείου.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
description |
string |
Η περιγραφή του στοιχείου. |
displayName |
string |
Το εμφανιζόμενο όνομα του στοιχείου. |
id |
string uuid |
Το αναγνωριστικό στοιχείου. |
type |
Ο τύπος στοιχείου. |
|
workspaceId |
string uuid |
Το αναγνωριστικό χώρου εργασίας. |
ItemType
Ο τύπος του στοιχείου. Επιπλέον τύποι στοιχείων μπορούν να προστεθούν με την πάροδο του χρόνου.
Τιμή | Περιγραφή |
---|---|
Dashboard |
Πίνακας εργαλείων του PowerBI. |
DataPipeline |
Μια διοχέτευση δεδομένων. |
Datamart |
Datamart του PowerBI. |
Environment |
Ένα περιβάλλον. |
Eventhouse |
Μια εκδήλωση. |
Eventstream |
Μια ροή συμβάντος. |
GraphQLApi |
Ένα API για το στοιχείο GraphQL. |
KQLDashboard |
Ένας πίνακας εργαλείων KQL. |
KQLDatabase |
Μια βάση δεδομένων KQL. |
KQLQueryset |
Ένα σύνολο ερωτημάτων KQL. |
Lakehouse |
Ένα λιμνοθάσπιτο. |
MLExperiment |
Ένα πείραμα εκμάθησης μηχανής. |
MLModel |
Ένα μοντέλο εκμάθησης μηχανής. |
MirroredDatabase |
Μια βάση δεδομένων κατοπτρισμού. |
MirroredWarehouse |
Μια αποθήκη με κατοπτρικό καθρέφτη. |
MountedDataFactory |
A MountedDataFactory. |
Notebook |
Ένα σημειωματάριο. |
PaginatedReport |
Σελιδοποιημένη αναφορά PowerBI. |
Reflex |
Αντανακλαστικά. |
Report |
Αναφορά PowerBI. |
SQLDatabase |
Μια βάση δεδομένων SQL. |
SQLEndpoint |
Ένα τελικό σημείο SQL. |
SemanticModel |
Σημασιολογικό μοντέλο PowerBI. |
SparkJobDefinition |
Ένας ορισμός εργασίας σπινθήρα. |
Warehouse |
Μια αποθήκη. |
UpdateItemRequest
Ενημέρωση αίτησης στοιχείου.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
description |
string |
Η περιγραφή του στοιχείου. Το μέγιστο μήκος είναι 256 χαρακτήρες. |
displayName |
string |
Το εμφανιζόμενο όνομα του στοιχείου. Το εμφανιζόμενο όνομα πρέπει να ακολουθεί τους κανόνες ονομασίας σύμφωνα με τον τύπο στοιχείου. |