Delete m3u8 File

最終更新日: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>&notifyURL=<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&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=bucket/bXlidWNrZXQ=/key/SW1hZ2UubTN1OA==/deletets/1;bucket/bXlidWNrZXQ=/key/SW1hZ2UxLm0zdTg=/deletets/0&notifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/deletem3u8"