Vai al contenuto
Tutti gli strumenti

onedrive_delete_file

OneDrive · macOS · Windows

Effetto: eliminazione. Stato: disponibilità condizionata.

«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.

macOS

Scopo

Elimina in modo permanente un file o una cartella VUOTA all'interno della cartella OneDrive sincronizzata su questo Mac. Non viene spostato nel Cestino del Mac e OneDrive sincronizza l'eliminazione nel cloud. Rifiuta una cartella che contiene ancora elementi (indicando quanti) e qualsiasi percorso fuori da una cartella OneDrive. Se chiamato senza confirm restituisce un'anteprima; passa confirm=true per eliminare. Se OneDrive Files-On-Demand ripristina l'elemento, lo strumento segnala che l'eliminazione non è avvenuta invece di dichiarare successo. Ottieni il percorso da onedrive_list_files o onedrive_search_files.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per onedrive_delete_file. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

{
  "confirm": false,
  "path": "/Users/demo/OneDrive-Demo/Documents/meeting-notes.txt"
}

Windows

Scopo

Elimina un file, o una cartella vuota, dal disco locale. Agisce sul percorso locale e non chiama mai il servizio OneDrive. Il percorso deve trovarsi all'interno di una cartella OneDrive (onedrive_root le elenca, onedrive_list_files e onedrive_search_files forniscono i percorsi al loro interno): qualsiasi altro percorso, e una cartella OneDrive stessa, viene rifiutato con o senza confirm. Un percorso che non esiste e una cartella che contiene ancora elementi vengono rifiutati con o senza confirm. Senza confirm=true non viene eliminato nulla: la chiamata restituisce un'anteprima che indica il percorso e dice se è un file o una cartella. Con confirm=true l'elemento viene rimosso direttamente, non inviato al Cestino, e questo server non ha uno strumento per ripristinarlo; ciò che il client di sincronizzazione di OneDrive fa poi con l'eliminazione esula da questo strumento. Per eliminare una cartella con elementi, elimina prima il suo contenuto, una chiamata per ciascuno.

Input obbligatori

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema dichiara un parametro di conferma esplicito. Controlla l’anteprima e autorizza l’operazione reale secondo il contratto della piattaforma.

Schema tecnico canonico in inglese — 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"
}

Esempio documentale

Esempio di documentazione per onedrive_delete_file. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

{
  "confirm": false,
  "path": "Documents/meeting-notes.txt"
}