Todos os produtos
Search
Central de documentação

Drive and Photo Service:CopyFile

Última atualização: Jul 04, 2026

Copia um arquivo ou diretório.

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/copy HTTP/1.1

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

domain_id

string

Sim

O ID do domínio.

body

object

Não

O corpo da solicitação.

share_id

string

Não

O ID do compartilhamento. Se você acessar um arquivo por meio de um compartilhamento, inclua o cabeçalho x-share-token para autenticação e especifique este parâmetro. Nesse caso, o parâmetro drive_id é ignorado. Alternativamente, autentique-se com um par de AccessKey ou um token de acesso e especifique o parâmetro drive_id. Você deve especificar o parâmetro share_id ou drive_id.

7JQX1FswpQ8

drive_id

string

Não

O ID do drive.

1

file_id

string

Sim

O ID do arquivo ou da pasta.

4221bf6e6ab43c255edc4463bf3a6f5f5d317406

to_drive_id

string

Não

O ID do drive de destino. Por padrão, este parâmetro é definido com o valor de drive_id.

1

to_parent_file_id

string

Sim

O ID da pasta pai de destino. Para copiar um arquivo ou pasta para o diretório raiz, defina este parâmetro como root.

6520943DC261

auto_rename

boolean

Não

Especifica se o arquivo deve ser renomeado automaticamente caso já exista um arquivo com o mesmo nome na pasta de destino. Valor padrão: false.

true

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

domain_id

string

O ID do domínio.

bj1

drive_id

string

O ID do drive.

1

file_id

string

O ID do novo arquivo ou pasta.

4221bf6e6ab43a255edc4463bffa6f5f5d317401

async_task_id

string

O ID da tarefa assíncrona.

Este parâmetro é retornado apenas para operações de cópia de pastas. A cópia de uma pasta é uma tarefa assíncrona. Use este ID com a operação GetAsyncTask para consultar o status da tarefa.

000e89fb-cf8f-11e9-8ab4-b6e980803a3b

Exemplos

Resposta de sucesso

JSON formato

{
  "domain_id": "bj1",
  "drive_id": "1",
  "file_id": "4221bf6e6ab43a255edc4463bffa6f5f5d317401",
  "async_task_id": "000e89fb-cf8f-11e9-8ab4-b6e980803a3b"
}

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.