Todos os produtos
Search
Central de documentação

Drive and Photo Service:MoveFile

Última atualização: Jul 20, 2026

Move um arquivo ou pasta.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

POST /v2/file/move HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

domain_id

string

Sim

body

object

Não

Os parâmetros do corpo da solicitação.

drive_id

string

Sim

O ID do drive.

1

file_id

string

Sim

O ID do arquivo.

9520943DC264

to_parent_file_id

string

Sim

O ID da pasta pai de destino. Defina este parâmetro como root se você quiser mover o arquivo ou pasta para o diretório raiz.

6520943DC261

check_name_mode

string

Não

O modo de processamento para arquivos com o mesmo nome. Valores válidos:

ignore: permite arquivos com o mesmo nome.

auto_rename: renomeia automaticamente o arquivo na nuvem quando um arquivo com o mesmo nome é encontrado. Por padrão, o carimbo de data/hora atual é anexado, como xxx_20060102_150405.

refuse: rejeita a criação de um novo arquivo quando um arquivo com o mesmo nome já existe na nuvem e retorna os detalhes do arquivo existente para o cliente.

Valor padrão: ignore.

ignore.

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Esquema da resposta.

domain_id

string

O ID do domínio.

bj1

drive_id

string

O ID do drive.

1

file_id

string

O ID do arquivo.

fileid1

async_task_id

string

O ID da tarefa assíncrona.

Se uma string vazia for retornada, o arquivo ou pasta será movido diretamente.

Se uma string não vazia for retornada, a movimentação exigirá processamento assíncrono. Chame GetAsyncTask e passe o ID da tarefa assíncrona para recuperar as informações da tarefa.

23ebd1a24dba4166b1527add476ef2866051b4d5del106

exist

boolean

Indica se o arquivo já existe.

false.

revision_id

string

file_name

string

updated_at

string

Exemplos

Resposta de sucesso

JSON formato

{
  "domain_id": "bj1",
  "drive_id": "1",
  "file_id": "fileid1",
  "async_task_id": "23ebd1a24dba4166b1527add476ef2866051b4d5del106",
  "exist": false,
  "revision_id": "",
  "file_name": "",
  "updated_at": ""
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.