Ir para o conteúdo
Todas as ferramentas

onedrive_delete_file

OneDrive · macOS · Windows

Efeito: eliminação. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Exclui permanentemente um arquivo ou uma pasta VAZIA dentro da pasta do OneDrive sincronizada neste Mac. Não vai para a Lixeira do Mac, e o OneDrive sincroniza a exclusão com a nuvem. Recusa uma pasta que ainda tem itens (informa quantos) e qualquer caminho fora de uma pasta do OneDrive. Chamada sem confirm, retorna uma prévia; passe confirm=true para excluir. Se o OneDrive Files-On-Demand restaurar o item, a ferramenta informa que a exclusão não vingou em vez de declarar sucesso. Obtenha o caminho em onedrive_list_files ou onedrive_search_files.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em 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"
}

Exemplo documental

Exemplo de documentação para onedrive_delete_file. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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

Windows

Finalidade

Exclui um arquivo, ou uma pasta vazia, do disco local. Atua sobre o caminho local e nunca chama o serviço do OneDrive. O caminho deve estar dentro de uma pasta do OneDrive (onedrive_root as lista; onedrive_list_files e onedrive_search_files fornecem caminhos dentro delas): qualquer outro, e a própria pasta do OneDrive, é recusado com ou sem confirm. Um caminho que não existe, e uma pasta que ainda tem itens, são recusados com ou sem confirm. Sem confirm=true, nada é excluído: a chamada retorna uma prévia que nomeia o caminho e diz se é arquivo ou pasta. Com confirm=true, o item é removido diretamente, sem ir para a Lixeira, e este servidor não tem ferramenta para restaurá-lo; o que o cliente de sincronização do OneDrive faz depois com a exclusão está fora desta ferramenta. Para excluir uma pasta com itens, exclua primeiro o conteúdo, uma chamada por item.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em 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"
}

Exemplo documental

Exemplo de documentação para onedrive_delete_file. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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