すべてのプロダクト
Search
ドキュメントセンター

:CopyFile

最終更新日:Feb 26, 2026

ファイルまたはフォルダをコピーします。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエスト構文

POST /v2/file/copy HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

body

object

任意

リクエストパラメーター。

share_id

string

任意

共有 ID。共有リンクを使用してファイルを管理する場合は、リクエストの認証に x-share-token ヘッダーを付与し、`share_id` を指定します。この場合、drive_id は無効になります。それ以外の場合は、AccessKey ペア または アクセストークン を使用して認証し、drive_id を指定します。share_iddrive_id のいずれか一方を指定する必要があります。

7JQX1FswpQ8

drive_id

string

任意

ドライブ ID。

1

file_id

string

必須

ファイル ID またはフォルダ ID。

4221bf6e6ab43c255edc4463bf3a6f5f5d317406

to_drive_id

string

任意

ファイルまたはフォルダのコピー先ドライブの ID。デフォルト値: `drive_id` の値。

1

to_parent_file_id

string

必須

コピー先の親フォルダの ID。ファイルまたはフォルダをルートディレクトリにコピーする場合は、このパラメーターを `root` に設定します。

6520943DC261

auto_rename

boolean

任意

コピー先のフォルダに同名のファイルが存在する場合に、ファイルを自動的に改名するかどうかを指定します。デフォルト値: false。

true

レスポンスフィールド

フィールド

説明

object

domain_id

string

ドメイン ID。

bj1

drive_id

string

ドライブ ID。

1

file_id

string

コピーされたファイルまたはフォルダの ID。

4221bf6e6ab43a255edc4463bffa6f5f5d317401

async_task_id

string

非同期タスクの ID。

ファイルをコピーした場合、このパラメーターは返されません。フォルダをコピーした場合、フォルダはバックグラウンドで非同期にコピーされ、このパラメーターが返されます。`GetAsyncTask` 操作を呼び出して、タスク ID に基づいて非同期タスクに関する情報を照会できます。

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

成功レスポンス

JSONJSON

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

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。