Αναφορά OneDrive (έκδοση προεπισκόπησης)

Σημείωμα

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

Σημαντικό

Αυτή είναι μια δυνατότητα προεπισκόπησης.

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

Επισκόπηση

Αναγνωριστικό διακομιστή	Διεύθυνση URL σε επίπεδο μισθωτή	Εμφανιζόμενο όνομα	Περιγραφή
mcp_OneDriveRemoteServer	https://agent365.svc.cloud.microsoft/ agents/tenants/{tenantId}/servers/ mcp_OneDriveRemoteServer	OneDrive	Εργαλεία για λειτουργίες OneDrive. Χρησιμοποιήστε αυτόν τον διακομιστή για τη διαχείριση αρχείων και φακέλων στις προσωπικές OneDrive του χρήστη. Όλες οι λειτουργίες αρχείων που περιορίζονται σε ≤5MB.

Διαθέσιμα εργαλεία

λήψη τουOnedrive

Λαμβάνει πληροφορίες σχετικά με τις OneDrive του χρήστη, συμπεριλαμβανομένων των μετα-δεδομένων μονάδας δίσκου, του ορίου και των πληροφοριών κατόχου.

Δεν απαιτούνται παράμετροι.

getFolderChildrenInMyOnedrive

Απαριθμεί τα 20 κορυφαία αρχεία και φακέλους (DriveItems) που περιέχονται σε έναν καθορισμένο γονικό φάκελο στον OneDrive του χρήστη.

Προαιρετικές παράμετροι:

• parentFolderId: Το αναγνωριστικό του γονικού φακέλου του οποίου τα αρχεία και οι φάκελοι θέλετε να καταχωρήσετε (προεπιλογή: "root")

findFileOrFolderInMyOnedrive

Εντοπίζει ένα αρχείο ή φάκελο (DriveItem) στο OneDrive του χρήστη κατά ερώτημα αναζήτησης. Αυτή η μέθοδος είναι πιο αποτελεσματική από την αναζήτηση σε όλα τα προσβάσιμα αρχεία εάν γνωρίζετε ότι το στοιχείο βρίσκεται στη OneDrive του χρήστη.

Απαιτούμενες παράμετροι:

• searchQuery: Αναζήτηση ερωτήματος, Μπορεί να είναι ολόκληρο ή μερικό όνομα αρχείου

getFileOrFolderMetadataInMyOnedrive

Λαμβάνει μετα-δεδομένα ενός αρχείου ή φακέλου (DriveItem) από το OneDrive του χρήστη.

Απαιτούμενες παράμετροι:

• fileOrFolderId: αναγνωριστικό του αρχείου ή φακέλου στον OneDrive χρήστη

getFileOrFolderMetadataByUrl

Λαμβάνει μετα-δεδομένα ενός αρχείου ή φακέλου (DriveItem) από μια διεύθυνση URL κοινής χρήσης. Μόνο χρήστες με υπάρχοντα ρητά δικαιώματα για πρόσβαση στο αρχείο μπορούν να λάβουν τα μετα-δεδομένα.

Απαιτούμενες παράμετροι:

• fileOrFolderUrl: Η διεύθυνση URL του αρχείου ή του φακέλου. Η διεύθυνση URL δεν εξαργυρώνεται για κοινή χρήση με τον χρήστη. πρέπει να έχουν ήδη ρητή πρόσβαση.

ανάγνωσηΜικρούΑρχείουΚειμένουΑπόΤοOneDriveΜου

Διαβάζει (κάνει λήψη) ένα αρχείο κειμένου από το OneDrive του χρήστη.

Απαιτούμενες παράμετροι:

• fileId: Το αναγνωριστικό του αρχείου (DriveItem) για ανάγνωση ή λήψη

createSmallTextFileInMyOnedrive

Δημιουργεί ή αποστέλλει ένα αρχείο κειμένου μικρότερο από 5 MB στο OneDrive του χρήστη.

Απαιτούμενες παράμετροι:

• Όνομα_αρχείου: Το όνομα του αρχείου που θα δημιουργηθεί
• περιεχόμενοΚείμενο: Περιεχόμενο κειμένου του αρχείου.

Προαιρετικές παράμετροι:

• parentFolderId: Αναγνωριστικό του γονικού φακέλου (προεπιλογή: 'root').

createFolderInMyOnedrive

Δημιουργεί έναν νέο φάκελο (DriveItem) στον OneDrive χρήστη ως θυγατρικό στοιχείο του καθορισμένου γονικού φακέλου. Εάν υπάρχει ήδη ένας φάκελος με το ίδιο όνομα, η μέθοδος προσθέτει ένα αριθμητικό επίθημα (για παράδειγμα, NewFolder (1)).

Απαιτούμενες παράμετροι:

• folderName: Το όνομα του φακέλου που θα δημιουργήσετε

Προαιρετικές παράμετροι:

• parentFolderId: Αναγνωριστικό του γονικού φακέλου (προεπιλογή: 'root').

renameFileOrFolderInMyOnedrive

Μετονομάζει ένα αρχείο ή φάκελο (DriveItem) στον OneDrive του χρήστη. Το νέο όνομα πρέπει να συμμορφώνεται με τους κανόνες ονομασίας.

Απαιτούμενες παράμετροι:

• fileOrFolderId: Το αναγνωριστικό του αρχείου ή του φακέλου για μετονομασία
• newFileOrFolderName: Το νέο όνομα για το αρχείο ή τον φάκελο

Προαιρετικές παράμετροι:

• Etag: Τιμή ETag για έλεγχο ταυτόχρονης εκτέλεσης. Η λειτουργία επιτυγχάνει μόνο εάν συμφωνεί το τρέχον ETag του DriveItem

διαγραφήΑρχείουΉΦακέλουΣτοOneDriveΜου

Διαγράφει ένα αρχείο ή φάκελο (DriveItem) από το OneDrive του χρήστη.

Απαιτούμενες παράμετροι:

• fileOrFolderId: Το αναγνωριστικό του αρχείου ή του φακέλου που θα διαγράψετε

Προαιρετικές παράμετροι:

• Etag: Τιμή ETag για έλεγχο ταυτόχρονης εκτέλεσης

κοινή χρήση αρχείου ή φακέλου στο OneDrive μου

Αποστέλλει μια πρόσκληση κοινής χρήσης για την εκχώρηση δικαιωμάτων ανάγνωσης ή εγγραφής σε ένα αρχείο ή φάκελο (DriveItem) στο OneDrive του χρήστη.

Απαιτούμενες παράμετροι:

• fileOrFolderId: Το αναγνωριστικό του αρχείου ή του φακέλου προς κοινή χρήση
• recipientEmails: Πίνακας διευθύνσεων ηλεκτρονικού ταχυδρομείου παραληπτών για πρόσκληση
• Ρόλους: Πίνακας ρόλων προς ανάθεση. Αποδεκτές τιμές: "ανάγνωση", "εγγραφή" (η εγγραφή εκχωρεί τόσο ανάγνωση όσο και εγγραφή)

Προαιρετικές παράμετροι:

• Μήνυμα: Προσαρμοσμένο μήνυμα που θα συμπεριληφθεί στο μήνυμα ηλεκτρονικού ταχυδρομείου πρόσκλησης. Προεπιλογή: "Εδώ είναι το αρχείο στο οποίο συνεργαζόμαστε."
• sendInvitation: Εάν θέλετε να στείλετε μια πρόσκληση κοινής χρήσης. Προεπιλογή: true.

Ορισμός ετικέτας ευαισθησίας σε αρχείο στο OneDrive μου

Ορίζει την ετικέτα ευαισθησίας ενός αρχείου στον OneDrive του χρήστη.

Απαιτούμενες παράμετροι:

• fileId: Το αναγνωριστικό του αρχείου (DriveItem)
• sensitivityLabelId: Το αναγνωριστικό της ετικέτας ευαισθησίας προς εκχώρηση ή κενή συμβολοσειρά προς κατάργηση

Προαιρετικές παράμετροι:

• assignmentMethod: Μέθοδος ανάθεσης: 'standard', 'privileged', 'auto', ή 'unknownFutureValue' (προεπιλογή: 'privileged')
• justificationText: Κείμενο αιτιολόγησης για σκοπούς ελέγχου· απαιτείται κατά την υποβάθμιση ή την κατάργηση μιας ετικέτας (προεπιλογή: "Τροποποιήθηκε από MCPServer")

δημιουργίαΜικρούΔυαδικούΑρχείουΣτοOneDriveΜου

Δημιουργεί ένα δυαδικό αρχείο μεγέθους μικρότερο από 5 MB με κωδικοποίηση base64 του περιεχομένου του στο OneDrive του χρήστη.

Απαιτούμενες παράμετροι:

• Όνομα_αρχείου: Το όνομα του αρχείου που θα δημιουργηθεί, συμπεριλαμβανομένης της επέκτασης αρχείου
• base64Συνεχές: Το περιεχόμενο δυαδικού αρχείου που έχει κωδικοποιηθεί ως συμβολοσειρά base64

Προαιρετικές παράμετροι:

• parentFolderId: Αναγνωριστικό του γονικού φακέλου (προεπιλογή: 'root').

ανάγνωσηΜικρούΔυαδικούΑρχείουΑπόΤοOneDriveΜου

Διαβάζει ένα δυαδικό αρχείο μικρότερο από 5 MB από το OneDrive του χρήστη. Επιστρέφει το περιεχόμενο αρχείου ως συμβολοσειρά με κωδικοποίηση base64.

Απαιτούμενες παράμετροι:

• fileId: Το αναγνωριστικό του αρχείου (DriveItem) για ανάγνωση ή λήψη

Αντιγραφή αρχείου ή φακέλου στο My OneDrive

Αντιγράφει ένα αρχείο ή φάκελο (DriveItem) σε έναν φάκελο προορισμού εντός του OneDrive του χρήστη. Αυτή η λειτουργία είναι ασύγχρονη. Χρησιμοποιείται checkOperationStatusInMyOnedrive για την παρακολούθηση της προόδου.

Απαιτούμενες παράμετροι:

• sourcefileid: Το αναγνωριστικό του αρχείου προέλευσης ή του φακέλου (DriveItem) για αντιγραφή
• destfolderid: αναγνωριστικό του φακέλου προορισμού (πρέπει να υπάρχει στο OneDrive του χρήστη)

Προαιρετικές παράμετροι:

• newfilename: Νέο όνομα για το στοιχείο που αντιγράφηκε (το προεπιλεγμένο όνομα)

moveFileOrFolderInMyOnedrive

Μετακινεί ένα αρχείο ή φάκελο (DriveItem) σε έναν φάκελο προορισμού εντός του OneDrive του χρήστη. Αυτή η λειτουργία είναι ασύγχρονη. Χρησιμοποιείται checkOperationStatusInMyOnedrive για την παρακολούθηση της προόδου.

Απαιτούμενες παράμετροι:

• sourcefileid: Το αναγνωριστικό του αρχείου προέλευσης ή του φακέλου (DriveItem) για μετακίνηση
• destfolderid: αναγνωριστικό του φακέλου προορισμού (πρέπει να υπάρχει στο OneDrive του χρήστη)

Προαιρετικές παράμετροι:

• newfilename: Νέο όνομα για το στοιχείο που μετακινήθηκε (από προεπιλογή στο αρχικό όνομα)

έλεγχος της κατάστασης λειτουργίας στο OneDrive μου

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

Απαιτούμενες παράμετροι:

• operationToken: Το διακριτικό λειτουργίας επέστρεψε από μια ασύγχρονη λειτουργία όπως copyFileOrFolderInMyOnedrive ή moveFileOrFolderInMyOnedrive

Δυνατότητες κλειδιά

Διαχείριση OneDrive

• Λαμβάνει OneDrive πληροφορίες, όπως το όριο και ο κάτοχος
• Πρόσβαση στις προσωπικές OneDrive του χρήστη
• Όλες οι λειτουργίες στοχοποίησαν OneDrive χρήστη με έλεγχο ταυτότητας

Αναζήτηση και εντοπισμός αρχείων

• Αναζήτηση αρχείων και φακέλων με βάση το όνομα εντός των OneDrive του χρήστη
• Λήψη μεταδεδομένων αρχείου ή φακέλου με αναγνωριστικό ή URL κοινής χρήσης
• Περιηγηθείτε στα περιεχόμενα του φακέλου (έως 20 στοιχεία).

Λειτουργίες αρχείων

• Δημιουργία κειμένου και δυαδικών αρχείων (≤5 MB)
• Ανάγνωση κειμένου και δυαδικών αρχείων (≤5 MB)
• Διαγραφή αρχείων με έλεγχο ταυτόχρονης εκτέλεσης
• Μετονομασία αρχείων με προστασία eTag
• Ασύγχρονη αντιγραφή και μετακίνηση αρχείων και φακέλων

Διαχείριση φακέλων

• Δημιουργία φακέλων με προαιρετικές γονικές διαδρομές
• Αυτόματο αριθμητικό επίθημα για διπλότυπα ονόματα φακέλων.
• Λίστα περιεχομένων φακέλου (έως 20 στοιχεία)
• Λήψη μεταδεδομένων φακέλου
• Διαγραφή φακέλων με έλεγχο ταυτόχρονης εκτέλεσης
• Μετονομασία φακέλων με προστασία eTag

Κοινή χρήση και δικαιώματα

• Κοινή χρήση αρχείων και φακέλων με χρήστες
• Έλεγχος πρόσβασης βάσει ρόλων (ανάγνωση, εγγραφή)
• Ειδοποιήσεις μέσω email για κοινή χρήση.
• Προσαρμοσμένα μηνύματα σε προσκλήσεις.

Ασφάλεια και συμμόρφωση

• Εφαρμόστε και καταργήστε ετικέτες ευαισθησίας.
• Χρησιμοποιήστε πολλές μεθόδους ανάθεσης, συμπεριλαμβανομένων των τυπικών, των προνομιακών και των αυτόματων.
• Υποστήριξη αιτιολόγησης ελέγχου.
• Χρησιμοποιήστε τον έλεγχο ταυτόχρονης εκτέλεσης με το eTags.

Σημειώσεις

• Όλες οι λειτουργίες στοχεύουν στην προσωπική OneDrive του εξουσιοδοτημένου χρήστη.
• Οι λειτουργίες αρχείων περιορίζονται σε αρχεία που είναι 5 MB ή λιγότερα για αποστολή και λήψη.
• Οι λειτουργίες διαγραφής και μετονομασίας υποστηρίζουν eTags για έλεγχο ταυτόχρονης εκτέλεσης.
• Η κοινή χρήση απαιτεί έγκυρες διευθύνσεις ηλεκτρονικού ταχυδρομείου και κατάλληλα δικαιώματα.
• Οι ετικέτες ευαισθησίας απαιτούν κατάλληλη άδεια χρήσης και ρύθμιση παραμέτρων.
• Η καταχώρηση σε φάκελο επιστρέφει έως και 20 στοιχεία από προεπιλογή.