概述

本文主要介紹在使用CDN、視頻點播時，通過腳本程序實現對M3U8資源刷新和預熱的操作方法。該腳本程序可實現以下場景：

• 對URL進行資源刷新和預熱。
• 對M3U8資源的TS文件進行刷新和預熱。
• 通過本地文件對URL進行批量刷新和預熱。
• 對URL進行目錄刷新。

注意：CDN和視頻點播對于刷新限制默認是每日2000條，預熱限制默認是每日500條。

詳細信息

以下是通過腳本程序實現對M3U8資源刷新和預熱的準備工作、命令詳解和常見報錯。

準備工作

以下是準備工作：

• 腳本程序由Java實現，建議使用JDK 1.7及以上的版本。
• 下載jar腳本，下載后可直接使用。
• jar所在目錄需要有log文件存放運行日志。
• 下載并解壓源碼Maven項目工程。

命令詳解

基本概念

使用jar腳本的格式如下所示，其中[$Parameter]是您需要使用的參數。

java -jar refreshPush.jar [$Parameter]

以下是部分jar腳本命令的詳細說明：

• --help：jar腳本命令的幫助說明。
• --product：支持的產品分類取值cdn或者是vod，必填。
• --accessKeyId：用戶的AccessKeyId信息，必填。
• --accessKeySecret：用戶的AccessKeySecrest信息，必填。
• --source： 需要刷新或者預熱的源，可以填URL地址或者文件路徑，必填。
• --type：填寫url或者dir，代表對URL刷新或預熱，如果是目錄刷新則填寫dir。
• --action：填寫push或者refresh，代表預熱或者是刷新，默認為refresh。
• --ts： 填寫true或者false，true代表對M3U8資源的TS文件進行刷新和預熱，默認為false。

對URL資源進行刷新

對URL資源進行刷新，請參考以下命令。

java -jar refreshPush.jar --product=[$Product] --accessKeyId=[$AccesskeyId] --accessKeySecret=[$AccessKeySecret] --source=[$URL]

說明：

• [$Product]：可填寫cdn或者vod，代表CDN產品或者視頻點播產品。
• [$AccesskeyId]：您的AccesskeyId。
• [$AccessKeySecret]：您的AccessKeySecret。
• [$URL]：需要刷新的URL資源，例如https://example.com/shj/RTC/AliRTC-1.12-WebSample/index.html。

對URL目錄進行刷新

對URL目錄進行刷新，請參考以下命令。

說明：目錄刷新中URL必須以HTTPS或HTTP開頭，并且以/結尾，例如https://example.com/shj/RTC/AliRTC-1.12-WebSample/。

java -jar refreshPush.jar --product=[$Product] --accessKeyId=[$AccesskeyId] --accessKeySecret=[$AccessKeySecret] --source=[$URL] --type=dir --action=refresh

對URL資源進行預熱

對URL資源進行預熱，請參考以下命令。

說明：使用CDN時，僅能對URL資源進行預熱，暫時不支持對URL目錄進行預熱。

java -jar refreshPush.jar --product=[$Product] --accessKeyId=[$AccesskeyId] --accessKeySecret=[$AccessKeySecret] --source=[$URL] --type=url --action=push

對URL進行批量刷新和預熱

通過本地文件對URL進行批量刷新，請參考以下命令。

java -jar refreshPush.jar --product=[$Product] --accessKeyId=[$AccesskeyId] --accessKeySecret=[$AccessKeySecret] --source=[$File] --action=[$Action] --type=url

說明：

• [$File]：本地文件，文本中包含多個URL，每個URL間以換行符進行分割。
• [$Action]：填寫refresh為刷新操作，填寫push為預熱操作，若不填寫該參數，則默認為刷新操作。

對M3U8資源的TS文件進行刷新和預熱

對M3U8資源的TS文件進行刷新和預熱，請參考以下命令。

java -jar refreshPush.jar --product=[$Product] --accessKeyId=[$AccesskeyId] --accessKeySecret=[$AccessKeySecret] --source=[$M3U8_URL] --action=[$Action] --ts=true

說明：[$M3U8_URL]為M3U8資源的URL地址。

常見報錯

報錯信息	報錯內容
Specified access key is not found	使用的AccessKey錯誤
params error,please check or use --help	命令中使用的參數命令有誤，請用--help參數查看命令使用說明
Specified Access Key Secret is not valid	使用的AccessKeySecret錯誤
url is not start with https or  http	URL沒有以HTTPS或者HTTP開頭
url is not start with https or  http，end with /	目錄中URL要以HTTPS或者HTTP開頭，同時以“/”結尾
Your preload attempts have exceeded the daily limit	預熱達到了上限
Your refresh attempts have exceeded the daily limit	刷新達到了上限

適用于

• CDN
• 視頻點播