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

:CopyFile

最終更新日:May 27, 2026

ファイルまたはディレクトリをコピーします。

今すぐお試しください

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

テスト

RAM 認証

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

リクエスト構文

POST /v2/file/copy HTTP/1.1

リクエストパラメーター

パラメーター

必須 / 任意

説明

domain_id

string

必須

ドメイン ID。

body

object

任意

リクエストボディ。

share_id

string

任意

共有 ID。 共有経由でファイルにアクセスする場合は、x-share-token ヘッダーに認証情報を含め、このパラメーターを指定します。 この場合、drive_id パラメーターは無視されます。 または、AccessKey ペアかアクセストークンで認証し、drive_id パラメーターを指定することもできます。 share_id または drive_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。

このパラメーターは、フォルダーのコピー操作でのみ返されます。 フォルダーのコピーは非同期タスクです。 この ID を GetAsyncTask API で使用して、タスクのステータスを照会します。

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

成功レスポンス

JSONJSON

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

エラーコード

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

変更履歴

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