Ir para o conteúdo
Todas as ferramentas

onedrive_move_file

OneDrive · macOS · Windows

Efeito: escrita. 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

Move ou renomeia um arquivo ou pasta dentro da pasta do OneDrive sincronizada neste Mac; o OneDrive sincroniza a alteração com a nuvem. Origem e destino devem estar ambos dentro do OneDrive. Se o destino é uma pasta existente, o item é movido PARA DENTRO dela e mantém o nome. Nunca sobrescreve: falha se já existir algo no destino. Cria as pastas pai ausentes do destino. Chamada sem confirm, retorna uma prévia; passe confirm=true para mover.

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 move",
      "type": "boolean"
    },
    "destination": {
      "description": "Destination path",
      "type": "string"
    },
    "source": {
      "description": "Source path",
      "type": "string"
    }
  },
  "required": [
    "source",
    "destination"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para onedrive_move_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,
  "destination": "Documents/Archive/meeting-notes.txt",
  "source": "Documents/meeting-notes.txt"
}

Windows

Finalidade

Move ou renomeia um arquivo ou pasta no disco local. Renomeia o caminho local e nunca chama o serviço do OneDrive. Ambos os caminhos devem estar dentro de uma pasta do OneDrive (onedrive_root as lista): qualquer outro é recusado com ou sem confirm, e também a própria pasta do OneDrive como origem. Se `destination` for uma pasta existente, o item é movido PARA DENTRO dela e mantém seu nome (a prévia mostra o caminho resultante); caso contrário, `destination` é o novo caminho completo, incluindo o novo nome. Nunca sobrescreve: se já existir algo no caminho resultante (um arquivo ou uma pasta), a chamada é recusada, com ou sem confirm, e nada é substituído. Uma origem que não existe também é recusada. Sem confirm=true, nada é movido: a chamada retorna uma prévia com a origem e o caminho resultante. Com confirm=true, as pastas pai ausentes do destino são criadas e o item é movido. Não há desfazer; para reverter, mova-o de volta.

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",
      "type": "boolean"
    },
    "destination": {
      "description": "New path, or an existing folder to move the item into",
      "type": "string"
    },
    "source": {
      "description": "Current path",
      "type": "string"
    }
  },
  "required": [
    "source",
    "destination"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para onedrive_move_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,
  "destination": "Documents/Archive/meeting-notes.txt",
  "source": "Documents/meeting-notes.txt"
}