この API を呼び出して、CDN ノードのファイルコンテンツを更新できます。 Alibaba Cloud CDN は、複数 URL に対するコンテンツの同時更新をサポートしています。
Alibaba Cloud CDN は、パラメーターがフォームとして送信される POST リクエストをサポートしています。
注
- RefreshObjectCaches API を呼び出してコンテンツを更新し、 PushObjectCache API を呼び出してコンテンツをプリロードできます
- 同じ ID を使用して、コンテンツを更新する URL およびディレクトリをそれぞれ毎日最大 2,000 個および 100 個送信できます。
- 更新リクエストごとに、最大 1,000 個の URL を指定できます。
- 毎秒最大 50 件のリクエストを送信できます。
デバッグ
リクエストパラメーター
パラメータ | タイプ | 必須項目 | 例 | 説明 |
---|---|---|---|---|
Action | String | はい | RefreshObjectCaches |
実行する操作 (RefreshObjectCaches) を設定します。 |
ObjectPath | String | 必須 | abc.com/image/1.png |
更新対象の URL を設定します。 複数の URL を指定する場合は、改行 (\nまたは \r\n) で区切ります。 |
ObjectType | String | いいえ | File |
更新するオブジェクトのタイプを設定します。 設定可能な値は、File および Directory です。 デフォルト値は、File です。 |
応答パラメーター
パラメーター | データ型 | 例 | 説明 |
---|---|---|---|
RefreshTaskId | String | 704222904 |
返された更新タスクの ID を示します。 複数のタスクが返される場合、ID はコンマ (,) で区切られます。 |
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
リクエストの ID です。 |
コーディング例
リクエスト例
https://cdn.aliyuncs.com?&Action=RefreshObjectCaches
&ObjectPath=example.com/test.txt
&ObjectType=File
&<Common request parameters>
通常のレスポンス例
XML
形式
<RefreshObjectCaches>
<RefreshTaskId>704222904</RefreshTaskId>
<RequestId>D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C</RequestId>
</RefreshObjectCaches>
JSON
形式
{
"RefreshTaskId":"704222904",
"RequestId":"D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C"
}
Error codes
エラーコードの詳細については、API エラーセンター をご参照ください。