RefreshObjectCaches - - Alibaba Cloud ドキュメントセンター

操作説明

Alibaba Cloud CDN は、パラメーターがフォームとして送信される POST リクエストをサポートしています。
RefreshObjectCaches 操作を呼び出してコンテンツをリフレッシュし、PushObjectCache 操作を呼び出してコンテンツをプリフェッチできます。
アカウントごとに 1 秒あたり最大 50 回、RefreshObjectCaches 操作を呼び出すことができます。
タスクを自動的にリフレッシュまたはプリフェッチする方法の詳細については、「スクリプトを実行してコンテンツをリフレッシュおよびプリフェッチする」をご参照ください。

注意事項

リフレッシュタスクが送信されて完了すると、特定のリソースが POP から削除されます。POP が削除されたリソースのリクエストを受信すると、POP はリクエストをオリジンサーバーに転送してリソースを取得します。取得されたリソースはクライアントに返され、POP にキャッシュされます。複数のリフレッシュタスクを実行すると、多数のリソースが POP から削除される可能性があります。これにより、オリジンサーバーに転送されるリクエストの数が増加します。オリジンサーバーへのルーティングプロセスはより多くの帯域幅リソースを消費し、オリジンサーバーが過負荷になる可能性があります。
リフレッシュタスクは、送信後 5〜6 分で有効になります。つまり、リフレッシュしたいリソースの TTL が 5 分未満の場合、手動でリフレッシュタスクを実行するのではなく、有効期限が切れるのを待ちます。
RAM ユーザーを使用してリソースをリフレッシュまたはプリフェッチする場合は、必要な権限を取得する必要があります。詳細については、「RAM ユーザーにリソースのプリフェッチとリフレッシュを許可する」をご参照ください。

リフレッシュクォータ

デフォルトでは、各 Alibaba Cloud アカウントは 1 日あたり最大 10,000 件の URL と 100 件のディレクトリからコンテンツをリフレッシュできます。ディレクトリにはサブディレクトリが含まれます。1 日のピーク帯域幅が 200 Mbit/s を超える場合は、チケットを送信してクォータの引き上げをリクエストできます。Alibaba Cloud CDN は、ワークロードに基づいてお客様の申請を評価します。
デフォルトでは、各 Alibaba Cloud アカウントは 1 日あたり最大 20 件の正規表現を含むリフレッシュルールを送信できます。Alibaba Cloud アカウントの 1 日のピーク帯域幅が 10 Gbit/s を超える場合は、チケットを送信してクォータの引き上げをリクエストできます。
各呼び出しで、最大 1,000 件の URL リフレッシュルール、100 件のディレクトリリフレッシュルール、または 1 件の正規表現を含むリフレッシュルールを指定できます。
各ドメイン名に対して、1 分あたり最大 1,000 件の URL をリフレッシュできます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

cdn:RefreshObjectCaches

none

*Domain

acs:cdn:*:{#accountId}:domain/{#DomainName}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ObjectPath	string	必須	一度に複数の URL またはディレクトリを送信する場合は、改行 (\n) または (\r\n) で区切ります。送信されたタスク内のすべての URL に含まれるドメイン名の合計数は 10 を超えることはできません。	http://example.com/image/1.png\nhttp://aliyundoc.com/image/2.png
ObjectType	string	任意	リフレッシュするオブジェクトのタイプ。有効な値： File (デフォルト)：1 つ以上のファイルをリフレッシュします。 Directory：1 つ以上のディレクトリ内のファイルをリフレッシュします。 Regex：正規表現に基づいてコンテンツをリフレッシュします。 ExQuery：URL 内のクエスチョンマーク以降のパラメーターを省略してコンテンツをリフレッシュします。 ObjectType パラメーターを File または Directory に設定した場合、詳細については「リソースのリフレッシュとプリフェッチ」をご参照ください。ObjectType パラメーターを Regex に設定した場合、詳細については「正規表現を含む URL リフレッシュルールの設定」をご参照ください。 ObjectType パラメーターを Directory に設定した場合、リフレッシュするディレクトリ内のリソースは期限切れとしてマークされます。ディレクトリを削除することはできません。クライアントが期限切れとしてマークされた POP 上のリソースをリクエストすると、Alibaba Cloud CDN はオリジンサーバー上のリソースが更新されているかどうかを確認します。リソースが更新されている場合、Alibaba Cloud CDN はリソースの最新バージョンを取得してクライアントに返します。それ以外の場合、オリジンサーバーは 304 ステータスコードを返します。	File
Force	boolean	任意	ソースコンテンツとオリジンサイトのリソースの比較が一致した場合に、対応する範囲内のリソースを強制的にリフレッシュするかどうか。デフォルトは false です。 true：パージタスクのタイプに対応する範囲内のすべてのリソースをパージします。このパラメーターを true に設定すると、リクエストされたリソースがパージタスクのタイプに対応する範囲内のリソースと一致した場合、POP はオリジンサーバーからリソースを取得し、クライアントに返してキャッシュします。 false：パージタスクのタイプに対応する範囲内の変更されたリソースをパージします。このパラメーターを false に設定すると、リクエストされたリソースがパージタスクのタイプに対応する範囲内のリソースと一致した場合、POP はオリジンサーバーからリソースの Last-Modified パラメーターを取得します。取得した Last-Modified パラメーターの値がキャッシュされたリソースの値と同じである場合、キャッシュされたリソースが返されます。それ以外の場合、POP はオリジンサーバーからリソースを取得し、クライアントに返してキャッシュします。説明このパラメーターは、ObjectType パラメーターが File に設定されていない場合にのみ有効です。	false

レスポンスフィールド

フィールド	型	説明	例
	object
RefreshTaskId	string	リフレッシュタスクの ID。複数のタスクが返された場合、タスク ID はコンマ (,) で区切られます。タスク ID は、次のルールに基づいてマージされます：タスクが同じ高速化ドメイン名に対して指定され、同じ秒内に送信され、ディレクトリではなく URL に基づいてコンテンツをリフレッシュする場合、タスク ID は 1 つのタスク ID (RefreshTaskId) にマージされます。同じ高速化ドメイン名に対して指定され、同じ秒内に送信され、ディレクトリではなく URL に基づいてコンテンツをリフレッシュするタスクの数が 2,000 を超える場合、2,000 ごとのタスク ID が 1 つのタスク ID (RefreshTaskId) にマージされます。	704222904
RequestId	string	リクエスト ID。	D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C

例

成功レスポンス

JSONJSON

{
  "RefreshTaskId": "704222901",
  "RequestId": "D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C"
}

エラーレスポンス

JSONJSON

{
"RefreshTaskId":"704222904"，"RequestId":"D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	SingleRequest.OverLimit	A maximum of 1000 URLs are supported for each request.
400	InvalidObjectType.Malformed	The specified ObjectType is invalid.
400	InvalidObjectPath.Malformed	The specified ObjectPath is invalid.
400	QuotaExceeded.Refresh	Your refresh attempts have exceeded the daily limit.
400	InvalidExtensiveDomain.ValueNotSupported	The specified ExtensiveDomain is not supported.
400	QuotaPerMinuteExceeded.Refresh	You tried to refresh too frequently, please try again later.
400	TooMany.Refresh	The refresh queue is full, please try again later.
429	TooManyRequests	Too many requests, please try again later

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。