最終更新日: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>¬ifyURL=<Urlsafe_Base64_Encoded_notifyUrl>&separate=<Separate>
| パラメーター | 必須 | 説明 |
|---|---|---|
| fops | はい | 処理パラメーターリストです。フォーマットは上記の通りで、複数の処理リクエストを同時にサポートします。複数指定する場合は「;」で区切ります。 |
| resource | はい | スペース名とリソース名を指定します。形式は |
| 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¬ifyURL=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¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/move"