最終更新日:2025-08-18 15:32:46
このインターフェースは、指定したリソースの削除を行います。
注意:
- 削除したファイルは復元できません。操作には十分ご注意ください。
- 削除処理の際、一部のtsファイルの削除に失敗する場合があります。削除失敗の通知を受け取った場合は、m3u8ファイルの削除を成功するまで再度トリガーする必要があります。
POST /fmgr/deletem3u8
HOST: <MgrDomain>
Authorization:<accessToken>
| パラメーター | 必須 | 説明 |
|---|---|---|
| HOST | はい | 管理ドメイン名(コンソールのバケット概要で取得可能) |
| Authorization | はい | 管理クレデンシャル |
リクエストパラメーターは以下のフォーマットで構成され、リクエストボディとして送信されます。
fops=bucket/<Urlsafe_Base64_Encoded_bucket>/key/<Urlsafe_Base64_Encoded_key>/deletets/<deletets>¬ifyURL=<Urlsafe_Base64_Encoded_notifyUrl>&separate=<Separate>
| パラメーター | 必須 | 説明 |
|---|---|---|
| fops | はい | 処理パラメータリストです。上記のフォーマットで、複数の処理リクエストを同時にサポートします。リストは「;」で区切ります。 注: 指定したリソースが存在しない場合も、「削除成功」となります。 |
| bucket | はい | バケットを指定します。<Urlsafe_Base64_Encoded_bucket>はバケット名をURLセーフBase64でエンコードした文字列です。 |
| key | はい | 対象リソースのキー(ファイル名)を指定します。<Urlsafe_Base64_Encoded_key> はキー(ファイル名)をURLセーフBase64でエンコードした文字列です。 |
| deletets | いいえ | 関連するtsファイルも削除するかどうかを指定します。 0: 関連ファイルの削除を行わない 1: 関連tsファイルを削除する 注:<1> このパラメータを指定しない場合、デフォルトで関連削除が行われます。<2> TSファイルのアクセスパスがm3u8ファイル内で相対パスの場合のみ有効です。TSアドレスが絶対パスの場合、TSファイルは関連削除されませんのでご注意ください。<3> TSファイルが絶対パスとなっているm3u8ファイルの場合、事前にm3u8ファイルの内容を解析し、TSファイルを操作してからm3u8ファイルを処理することを推奨します。 |
| notifyURL | いいえ | 処理結果の通知を受信するURLです。通知内容のフォーマットはtask query interface の返却内容をご参照ください。 |
| separate | いいえ | 各処理指示単位で個別に通知するかどうか指定します。1または0を指定: 1: コマンド実行ごとにnotifyURLへ通知します。 0: 全コマンド実行後に1回だけnotifyURLへ通知します。(デフォルトは0) |
fopsパラメーター例
fops=bucket/bXlidWNrZXQ=/key/SW1hZ2UubTN1OA==/deletets/1;bucket/bXlidWNrZXQ=/key/SW1hZ2UxLm0zdTg=/deletets/0¬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=bucket/bXlidWNrZXQ=/key/SW1hZ2UubTN1OA==/deletets/1;bucket/bXlidWNrZXQ=/key/SW1hZ2UxLm0zdTg=/deletets/0¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/deletem3u8"