onedrive_delete_file
OneDrive · macOS · Windows
Wirkung: Löschen. Status: bedingt verfügbar.
„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.
macOS
Zweck
Löscht eine Datei oder einen LEEREN Ordner dauerhaft im auf diesem Mac synchronisierten OneDrive-Ordner. Sie wird nicht in den Papierkorb des Mac verschoben, und OneDrive synchronisiert die Löschung in die Cloud. Lehnt einen Ordner ab, der noch Elemente enthält (und nennt deren Anzahl), sowie jeden Pfad außerhalb eines OneDrive-Ordners. Ohne confirm wird eine Vorschau zurückgegeben; übergeben Sie confirm=true, um zu löschen. Stellt OneDrive Files-On-Demand das Element wieder her, meldet das Tool, dass das Löschen nicht wirksam wurde, statt Erfolg vorzutäuschen. Den Pfad erhalten Sie von onedrive_list_files oder onedrive_search_files.
Erforderliche Eingaben
path
Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.
Berechtigungen und Bestätigung
Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.
- Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.
Kanonisches technisches Schema auf Englisch — macOS
{
"properties": {
"confirm": {
"description": "Must be true to delete",
"type": "boolean"
},
"path": {
"description": "Absolute path to the file or folder",
"type": "string"
}
},
"required": [
"path"
],
"type": "object"
}Dokumentationsbeispiel
Dokumentationsbeispiel für onedrive_delete_file. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.
{
"confirm": false,
"path": "/Users/demo/OneDrive-Demo/Documents/meeting-notes.txt"
}Windows
Zweck
Löscht eine Datei oder einen leeren Ordner vom lokalen Datenträger. Es wirkt auf den lokalen Pfad und ruft nie den OneDrive-Dienst auf. Der Pfad muss innerhalb eines OneDrive-Ordners liegen (onedrive_root listet sie auf, onedrive_list_files und onedrive_search_files liefern Pfade darin): Alles andere sowie ein OneDrive-Ordner selbst wird mit oder ohne confirm abgelehnt. Ein Pfad, der nicht existiert, und ein Ordner, der noch Elemente enthält, werden mit oder ohne confirm abgelehnt. Ohne confirm=true wird nichts gelöscht: Der Aufruf gibt eine Vorschau zurück, die den Pfad nennt und angibt, ob es sich um eine Datei oder einen Ordner handelt. Mit confirm=true wird das Element direkt entfernt, nicht in den Papierkorb verschoben, und dieser Server hat kein Tool, um es wiederherzustellen; was der OneDrive-Synchronisierungsclient anschließend mit der Löschung macht, liegt außerhalb dieses Tools. Um einen Ordner mit Elementen zu löschen, löschen Sie zuerst dessen Inhalt, jeweils in einem eigenen Aufruf.
Erforderliche Eingaben
path
Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.
Berechtigungen und Bestätigung
Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.
- Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.
Kanonisches technisches Schema auf Englisch — Windows
{
"properties": {
"confirm": {
"description": "Must be true to execute the delete",
"type": "boolean"
},
"path": {
"description": "Absolute path to the file or folder to delete",
"type": "string"
}
},
"required": [
"path"
],
"type": "object"
}Dokumentationsbeispiel
Dokumentationsbeispiel für onedrive_delete_file. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.
{
"confirm": false,
"path": "Documents/meeting-notes.txt"
}