Copy Resource

最終更新日:2025-08-20 11:13:49

このインターフェースは、指定したリソースを新しい名前のリソースとしてクラウドストレージプラットフォーム上にコピーする機能を提供します。ターゲットバケットに同名のリソースが存在する場合は、既存のファイルが直接上書きされます。

注意: m3u8ファイルをコピーした場合、関連するtsファイルは同時にコピーされません。

リクエスト説明

リクエストパス

POST /copy/{param_src}/{param_dst}
Host: <MgrDomain>
Authorization: <AccessToken>

注意:
param_srcはコピー元リソース(現在のリソースの場所)を示します。
param_dstはコピー後の新しいリソースの保存先や、任意の新しい名前を指定します。

  • {param_src} および {param_dst} の生成ルールは EncodeEntryURI format を参照してください。

ヘッダー説明

パラメータ 必須 説明
Host はい 管理ドメイン名(コンソールのバケット概要画面で取得可能)。
Authorization はい 管理認証情報

レスポンス説明

  • リクエスト成功時には以下のようなJson文字列が返されます。
{
    "message":   "OK",
    "code": 200
}
フィールド名 必須 説明
message はい ファイルコピー成功時のメッセージ
code はい リクエストのステータスコード。HTTP response status code を参照
  • リクエスト失敗時には以下のようなJson文字列が返されます。
{
    "code":     "<code string>",
    "message":  "<ErrMsg string>"
}
フィールド名 必須 説明
code はい HTTPリクエストのレスポンスコード。HTTP response status code を参照
message はい ファイルコピー失敗時のエラーメッセージ

実行例

curl -v -X POST -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:OWE0M2UxMjMxZTg1NTJmMjdhYjk3ZDgyZDZkMmVhNWMxYzUzMGM0OQ==" --url "http://mgrDomain/copy/aW1hZ2VzOmdqaF9zeW4yLnR4dA==/aW1hZ2VzOmdqaF9zeW4yX2NvcHkudHh0"