Copy Resource
最終更新日：2025-08-18 15:32:35
このインターフェースは、指定したリソースを新しい名前でコピー（複製）する機能を提供します。
注意：m3u8ファイルをコピーした場合、同時にtsファイルはコピーされません。
リクエスト説明
POST /fmgr/copy
HOST: <MgrDomain>
Authorization:<accessToken>
ヘッダー説明
| パラメータ | 必須 | 説明 |
|---|---|---|
| HOST | はい | 管理ドメイン名（コンソールのバケット概要で取得可能） |
| Authorization | はい | 管理クレデンシャル |
パラメータ説明
リクエストパラメータは以下のフォーマットで整理し、リクエストボディとして送信します：
fops=resource/<EncodeEntryURI>/bucket/<Urlsafe_Base64_Encoded_bucket>/key/<Urlsafe_Base64_Encoded_key>/prefix/<Urlsafe_Base64_Encoded_prefix>¬ifyURL=<Urlsafe_Base64_Encoded_notifyUrl>&separate=<Separate>
| パラメータ | 必須 | 説明 |
|---|---|---|
| fops | はい | 処理パラメータリスト。上記形式で記述、複数指定はセミコロン区切り。 |
| resource | はい | 空間名とリソース名を指定。書式： |
| bucket | はい | 保存先バケット。<Urlsafe_Base64_Encoded_bucket>はバケット名をURL-safe Base64でエンコードした値。 |
| key | いいえ | 保存先のファイル名。ファイルを同じ空間へコピーする場合は必ず指定し、コピー元と同名不可。 <Urlsafe_Base64_Encoded_key>はファイル名をURL-safe Base64でエンコードした値。 ※別バケットへコピー時には未指定だとオリジナルと同名になる。 |
| prefix | いいえ | コピー先ファイル名のプレフィックス。<Urlsafe_Base64_Encoded_prefix>はプレフィックスをURL-safe Base64でエンコードした値。 ※prefix指定時、保存名は「prefix/key」となる。 |
| notifyURL | いいえ | 処理結果通知用の受信URL。通知内容例はこちら |
| force | いいえ | 強制的に処理するか。1: 強制処理および既存結果を上書き。0: 既に結果が存在すれば再処理せず成功扱い（デフォルト0）。 |
| separate | いいえ | 通知をコマンド毎に分けるかまとめて行うか。1：各コマンド実行後に個別通知。0：全て完了後に一括通知（デフォルト0）。 |
fopsパラメータ例
fops=resource/bXlidWNrZXQ6YWEuanBn/bucket/bXlidWNrZXQy;resource/bXlidWNrZXQ6YWEuanBn/bucket/bXlidWNrZXQy/key/YWJjL2FhLmpwZw==/prefix/ZGlyYWEv¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1
レスポンス説明
- リクエスト成功時、以下の形式のJson文字列が返されます。
{ "persistentId": <persistentId> }
| フィールド名 | 必須 | 説明 |
|---|---|---|
| persistentId | はい | タスク管理ID。タスク進捗照会に使用可。 |
- リクエスト失敗時は、以下のJson形式となります。
{
"code": "<code string>",
"message": "<ErrMsg string>"
}
| フィールド名 | 必須 | 説明 |
|---|---|---|
| code | はい | HTTPリクエストレスポンスコード。HTTPレスポンスコード一覧参照 |
| message | はい | リクエスト失敗メッセージ |
例
curl -v -X POST -d "fops=resource/bXlidWNrZXQ6YWEuanBn/bucket/bXlidWNrZXQy;resource/bXlidWNrZXQ6YWEuanBn/bucket/bXlidWNrZXQy/key/YWJjL2FhLmpwZw==/prefix/ZGlyYWEv¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/copy"
このドキュメントの内容は役に立ちましたか?
はい
いいえ