Saltar al contenido
Todas las herramientas

onedrive_delete_file

OneDrive · macOS · Windows

Efecto: eliminación. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Elimina de forma permanente un archivo o una carpeta VACÍA dentro de la carpeta de OneDrive sincronizada en esta Mac. No se mueve a la Papelera de la Mac, y OneDrive sincroniza la eliminación con la nube. Rechaza una carpeta que aún contiene elementos (indica cuántos) y cualquier ruta fuera de una carpeta de OneDrive. Si se llama sin confirm, devuelve una vista previa; pase confirm=true para eliminar. Si OneDrive Files-On-Demand restaura el elemento, la herramienta informa de que la eliminación no se aplicó en lugar de declarar éxito. Obtenga la ruta de onedrive_list_files o onedrive_search_files.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para onedrive_delete_file. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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

Windows

Propósito

Elimina un archivo, o una carpeta vacía, del disco local. Actúa sobre la ruta local y nunca llama al servicio de OneDrive. La ruta debe estar dentro de una carpeta de OneDrive (onedrive_root las enumera; onedrive_list_files y onedrive_search_files dan rutas dentro de ellas): cualquier otra, y la propia carpeta de OneDrive, se rechaza con o sin confirm. Una ruta que no existe, y una carpeta que aún contiene elementos, se rechazan con o sin confirm. Sin confirm=true no se elimina nada: la llamada devuelve una vista previa que nombra la ruta e indica si es archivo o carpeta. Con confirm=true el elemento se elimina directamente, sin enviarlo a la Papelera de reciclaje, y este servidor no tiene ninguna herramienta para restaurarlo; lo que haga después el cliente de sincronización de OneDrive con la eliminación queda fuera de esta herramienta. Para eliminar una carpeta con elementos, elimine primero su contenido, una llamada por elemento.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para onedrive_delete_file. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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