Fetch Resource
最終更新日：2025-08-18 15:32:33
このインターフェースは、指定したURLからリソースを取得し、指定したストレージスペース（バケット）に保存する機能を提供します。
リクエスト説明
POST /fmgr/fetch
HOST: <MgrDomain>
Authorization:<accessToken>
ヘッダー説明
| パラメータ | 必須 | 説明 |
|---|---|---|
| HOST | はい | 管理ドメイン名（コンソールのバケット概要で取得可能） |
| Authorization | はい | 管理クレデンシャル |
パラメータ説明
リクエストパラメータは次の形式で整理し、リクエストボディとして送信します：
fops=fetchURL/<Urlsafe_Base64_Encoded_URL>/bucket/<Urlsafe_Base64_Encoded_bucket>/key/<Urlsafe_Base64_Encoded_key>/prefix/<Urlsafe_Base64_Encoded_prefix>/md5/<md5>/decompression/<decompression>/fetchTS/<fetchTS>¬ifyURL=<Urlsafe_Base64_Encoded_notifyUrl>&force=<Force>&separate=<Separate>
| パラメータ | 必須 | 説明 |
|---|---|---|
| fops | はい | 処理パラメータリスト。上記形式で記述し、複数処理も同時指定可能(セミコロン区切り)。 |
| fetchURL | はい | 取得対象のURL。[URLセーフBase64でエンコードしたURL] |
| bucket | はい | 保存先バケット。[URLセーフBase64でエンコードしたバケット名] |
| key | いいえ | 保存先ファイル名。[URLセーフBase64でエンコードしたファイル名] ※未指定時、保存名はfetchURLのURI部分 |
| prefix | いいえ | 保存先ファイル名につけるプレフィックス。[URLセーフBase64でエンコードしたプレフィックス] ※指定時、保存名は「prefix/key」 |
| md5 | いいえ | リソースのMD5値を指定。取得したリソースのmd5と一致すれば保存。一致しなければ保存されません。未指定時はチェックなし。 |
| decompression | いいえ | 取得したファイルを指定タイプで解凍（zip/tar/gzip対応）。例：/decompression/zip でzip解凍 |
| fetchTS | いいえ | m3u8ファイル取得時にTSファイルも取得するか指定： 0=取得しない 1=取得する ※デフォルトは取得しない。m3u8専用。TSへのパスは相対パスのみ対応。マルチレート非対応。 |
| notifyURL | いいえ | 処理結果の通知用受信URL。通知内容例はこちら |
| force | いいえ | 強制的に処理するかどうか。 1：強制的に処理して既存のものを上書き 0：既存結果があれば再処理せず成功扱い（デフォルト0） |
| separate | いいえ | 通知を個別に行うかまとめて行うか。1または0指定。 1：各処理コマンドごとに個別通知 0：全コマンド終了後に一括通知（デフォルト0） |
リクエストパラメータの例
fops=fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEuanBn/bucket/bXlidWNrZXQ=;fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEuanBn/bucket/bXlidWNrZXQ=/key/ZGlyL2FhLmpwZw==/prefix/YWFkaXIv/md5/0bee89b07a248e27c83fc3d5951213c1;fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEuemlw/bucket/bXlidWNrZXQ=/decompress/zip;fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEubTN1OA==/bucket/bXlidWNrZXQ=/fetchTS/1¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&force=1&separate=1
レスポンス説明
- 成功時、以下の形式で
JSON文字列が返却されます。
{ "persistentId": <persistentId> }
| フィールド名 | 必須 | 説明 |
|---|---|---|
| persistentId | はい | 処理タスクID。進捗照会に使用可能 |
- 失敗時、以下の形式で
JSON文字列が返却されます。
{
"code": "<code string>",
"message": "<ErrMsg string>"
}
| フィールド名 | 必須 | 説明 |
|---|---|---|
| code | はい | HTTPリクエストレスポンスコード。レスポンスコード一覧参照 |
| message | はい | 失敗時のエラーメッセージ |
リクエスト例
curl -v -X POST -d "fops=fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEuanBn/bucket/bXlidWNrZXQ=/key/ZGlyL2FhLmpwZw==/prefix/YWFkaXIv/md5/0bee89b07a248e27c83fc3d5951213c1;fetchURL/aHR0cDovL3d3dy5iYWlkdS5jb20vYWEuemlw/bucket/bXlidWNrZXQ=/decompress/zip¬ifyURL=aHR0cDovL3Rlc3QuY29tL25vdGlmeVVSbA==&force=1&separate=1" -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:Y2JmMGY0YTNhZmQxZmVlZGM2ZTA0YTdjNTcyOWQ1NjRkNTExYjg0Yg==" --url "http://mgrDomain/fmgr/fetch"
このドキュメントの内容は役に立ちましたか?
はい
いいえ