Move Resource

最終更新日:2025-08-18 15:32:38

このインターフェースは、指定したリソースを別のバケットへ移動したり、同じバケット内でリネームしたりすることができます。

注意:m3u8ファイルを移動した場合、tsファイルは同時に移動されません。

リクエスト説明

POST /fmgr/move
HOST: <MgrDomain>
Authorization:<accessToken>

ヘッダー説明

パラメーター 必須 説明
HOST はい 管理ドメイン名(コンソールのバケット概要で取得可能)
Authorization はい 管理クレデンシャル

パラメーター説明

リクエストパラメーターは、以下のフォーマットで構成され、リクエストコンテンツとして送信されます。

fops=resource/<EncodeEntryURI>/bucket/<Urlsafe_Base64_Encoded_bucket>/key/<Urlsafe_Base64_Encoded_key>/prefix/<Urlsafe_Base64_Encoded_prefix>&notifyURL=<Urlsafe_Base64_Encoded_notifyUrl>&separate=<Separate>
パラメーター 必須 説明
fops はい 処理パラメーターリストです。フォーマットは上記の通りで、複数の処理リクエストを同時にサポートします。複数指定する場合は「;」で区切ります。
resource はい スペース名とリソース名を指定します。形式は : です(ディレクトリ複製は非対応)。 は指定リソースをURLセーフなBase64でエンコードした文字列です。
bucket はい バケットを指定します。<Urlsafe_Base64_Encoded_bucket> は、指定したバケット名をURLセーフなBase64でエンコードした文字列です。
key いいえ リソースを保存するキーを指定します。同じスペース内でファイルをコピーする場合はキーの指定が必要で、元ファイルと同じキーにすることはできません。<Urlsafe_Base64_Encoded_key> は、指定リソースのキーをURLセーフなBase64でエンコードした文字列です。
注:異なるスペースへコピーする場合、キーを指定しなければ元リソースのキーで命名されます。
prefix いいえ リソースキーのプレフィックスを指定します。<Urlsafe_Base64_Encoded_prefix> は、指定リソースのキーのプレフィックスをURLセーフなBase64でエンコードした文字列です。
注:prefixパラメーターを指定した場合、リソースは最終的に「prefix/key」として保存されます。
notifyURL いいえ 処理結果の通知を受け取るURLです。通知内容のフォーマットは タスク照会インターフェースの返却内容 を参照してください。
force いいえ 強制的に処理を実行するかどうかを指定します。
1:データ処理を強制実行し、元の結果を上書きします。
0:既に結果が存在する場合、正常終了とみなします(リソースの無駄な重複処理を回避)。 デフォルトは0です。
separate いいえ 処理指示ごとに別々に通知するかどうかを指定します。1/0を指定可能:
1:各コマンドの実行後にnotifyURLへ通知します。
0:全コマンド実行後に1回だけnotifyURLへ通知します。デフォルトは0です。

fopsパラメーター例

fops=resource/bXlidWNrZXQ6YWEuanBn/bucket/bXlidWNrZXQy;resource/bXlidWNrZXQ6YWEuanBn/bucket/bXlidWNrZXQy/key/YWJjL2FhLmpwZw==/prefix/ZGlyYWEv&notifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1

レスポンス説明

  • リクエストが成功した場合、次の内容を持つ Json 文字列が返されます:
{ "persistentId": <persistentId> }
フィールド名 必須 説明
persistentId はい タスクプロセスIDです。タスク進捗の照会に使用します。
  • リクエストが失敗した場合、次の内容を持つ Json 文字列が返されます:
{
    "code":     "<code string>",
    "message":  "<ErrMsg string>"
}
フィールド名 必須 説明
code はい HTTPリクエストのレスポンスコードです。 HTTP response status code を参照してください。
message はい リクエスト失敗時のメッセージ

curl -v -X POST -d "fops=resource/bXlidWNrZXQ6YWFjLmpwZw==/bucket/bXlidWNrZXQy;resource/bXlidWNrZXQ6YWEuanBn/bucket/bXlidWNrZXQy/key/YWJjL2FhLmpwZw==/prefix/ZGlyYWEv&notifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/move"