All Products
Search

This Product

    Drive and Photo Service:CopyFile

    Document Center

    Drive and Photo Service:CopyFile

    Last Updated:Feb 26, 2026

    Menyalin file atau folder.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

    Sintaks permintaan

    POST /v2/file/copy HTTP/1.1

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    body

    object

    No

    Parameter permintaan.

    share_id

    string

    No

    ID share. Jika Anda ingin mengelola file menggunakan tautan share, sertakan header x-share-token untuk otentikasi dalam permintaan dan tentukan share_id. Dalam kasus ini, drive_id tidak berlaku. Jika tidak, gunakan AccessKey pair atau access token untuk otentikasi dan tentukan drive_id. Anda harus menentukan salah satu dari share_id dan drive_id.

    7JQX1FswpQ8
    drive_id

    string

    No

    ID drive.

    1
    file_id

    string

    Yes

    ID file atau ID folder.

    4221bf6e6ab43c255edc4463bf3a6f5f5d317406
    to_drive_id

    string

    No

    ID drive tujuan tempat Anda ingin menyalin file atau folder tersebut. Nilai default: nilai drive_id.

    1
    to_parent_file_id

    string

    Yes

    ID folder induk tujuan. Jika Anda ingin menyalin file atau folder ke direktori root, atur parameter ini ke root.

    6520943DC261
    auto_rename

    boolean

    No

    Menentukan apakah nama file akan diubah secara otomatis jika nama file tersebut sudah ada di folder tujuan. Nilai default: false.

    true

    Elemen respons

    Element

    Type

    Description

    Example

    object

    domain_id

    string

    ID domain.

    bj1
    drive_id

    string

    ID drive.

    1
    file_id

    string

    ID file atau folder yang disalin.

    4221bf6e6ab43a255edc4463bffa6f5f5d317401
    async_task_id

    string

    ID tugas asinkron.

    Jika sebuah file disalin, parameter ini tidak dikembalikan. Jika sebuah folder disalin, folder tersebut disalin secara asinkron di latar belakang dan parameter ini dikembalikan. Anda dapat memanggil operasi GetAsyncTask untuk mengkueri informasi tentang tugas asinkron berdasarkan ID tugas tersebut.

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

    Contoh

    Respons sukses

    JSONformat

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

    Kode kesalahan

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.