RefreshDcdnObjectCaches API を呼び出す - Edge Security Acceleration - Alibaba Cloud - Edge Security Acceleration

操作説明

リクエストメソッド: POST リクエストがサポートされています。パラメーターはフォームで表示されます。
関連操作: リフレッシュおよびプリフェッチ操作には、 RefreshDcdnObjectCaches リフレッシュ操作と PreloadDcdnObjectCaches プリフェッチ操作が含まれます。
URL リフレッシュクォータ (日次): デフォルトでは、各アカウントは 1 日あたり最大 10,000 件の URL リフレッシュリクエストと 100 件のディレクトリ更新リクエストを送信できます。ディレクトリ更新にはサブディレクトリが含まれます。Alibaba Cloud アカウントの日次ピーク帯域幅が 200 Mbit/s を超える場合、チケットを送信して、より高い日次割当クォータをリクエストできます。Alibaba Cloud は実際のビジネス要件に基づいてクォータを評価し、設定します。
各リクエストは最大 1,000 件の URL リフレッシュリクエストまたは 100 件のディレクトリ更新リクエストをサポートしています。
単一のドメイン名に対して、1 分あたり最大 10,000 件の URL リフレッシュリクエストを送信できます。
ユーザーあたりの最大呼び出し頻度: 1 秒あたり 30 回。

注意事項

リフレッシュタスクが送信され正常に実行されると、DCDN ポイントオブプレゼンス (POP) 上のキャッシュされたリソースが無効化されます。再度アクセスリクエストを送信すると、POP はオリジンサーバーからバックトゥオリジン経由で必要なリソースを取得し、POP に再度キャッシュします。大量のリフレッシュタスクを送信すると大量のキャッシュがクリアされ、バックトゥオリジンのオリジン帯域幅とリクエストが急増し、オリジンサーバーのロードが増加します。
リフレッシュタスクは送信後、効果が出るまで約 5〜6 分の時間がかかります。ファイルまたはディレクトリに設定された TTL が 5 分未満の場合、リフレッシュ操作を実行する必要はありません。ファイルまたはディレクトリのキャッシュが有効期限切れになり、自動的に更新されるのを待ってください。
Resource Access Management (RAM) ユーザーを使用してリフレッシュまたはプリフェッチ操作を実行するには、まず権限付与を取得してください。詳細については、RAM ユーザーにリフレッシュおよびプリフェッチ権限を付与するを参照してください。

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

dcdn:RefreshDcdnObjectCaches

none

*domain

acs:dcdn:*:{#accountId}:domain/{#domainName}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ObjectPath	string	必須	単一のリクエストで送信する場合、複数の URL またはディレクトリは改行で区切ります。単一のリクエスト内のすべての URL にわたるドメイン名の合計数は 10 を超えてはなりません。	example.com/example.txt
ObjectType	string	任意	リフレッシュタイプ。有効な値: File (デフォルト): URL。 Directory: ディレクトリ更新。 Regex: 正規表現ベースのリフレッシュ。 IgnoreParams: パラメーターを無視した URL による消去。これは、リクエスト URL から `?` および `?` 以降のすべての文字を削除することを指します。パラメーターを削除した URL を API 経由で送信すると、送信された URL は、キャッシュされたリソース URL のパラメーターも削除された後に照合されます。キャッシュされたリソース URL がパラメーター削除後に送信された URL と一致する場合、POP はキャッシュされたリソースに対してリフレッシュを実行します。説明 URL リフレッシュとディレクトリ更新の特徴説明については、リソースのリフレッシュとプリフェッチを参照してください。 File リフレッシュは POP 上のリソースを直接削除します。新しいリクエストを受信すると、バックトゥオリジン経由でオリジンサーバーから新しいリソースが取得されます。その他のリフレッシュタイプは、デフォルトでは変更されたリソースのみをリフレッシュします。強制リフレッシュを行うには、Force パラメーターを true にセットしてください。詳細については、Force パラメーターの説明を参照してください。	File
Force	boolean	任意	バックトゥオリジンのコンテンツがオリジンサーバーのリソースと一致する場合に、対応する範囲内のすべてのリソースをリフレッシュするかどうかを指定します。デフォルト値: false。 true: 対応する範囲内のすべてのリソースをリフレッシュします。「すべてのリソースをリフレッシュ」が選択されている場合、リクエストされたコンテンツが対応する範囲内のリソースと一致すると、DCDN POP はバックトゥオリジン経由でオリジンサーバーから新しいリソースを取得し、ユーザーに返却し、リソースを再度キャッシュします。 false: 対応する範囲内の変更されたリソースのみをリフレッシュします。「変更されたリソースをリフレッシュ」が選択されている場合、リクエストされたコンテンツが対応する範囲内のリソースと一致すると、DCDN POP はバックトゥオリジン経由でオリジンサーバーからリソースの Last-Modified 情報を取得します。情報が現在キャッシュされているリソースと一致する場合、キャッシュされたリソースが直接返却されます。情報が一致しない場合、バックトゥオリジン経由でオリジンサーバーから新しいリソースが取得され、ユーザーに返却され、再度キャッシュされます。説明このパラメーターは、File リフレッシュを除くすべてのリフレッシュタイプに対して効果があります。	false

レスポンスフィールド

フィールド	型	説明	例
	object
RefreshTaskId	string	リフレッシュに対して返却されたタスク ID。複数の ID はカンマ (,) で区切られます。	95248880
RequestId	string	リクエスト ID。	E5BD4B50-7A02-493A-AE0B-97B9024B4135

例

成功レスポンス

JSONJSON

{
  "RefreshTaskId": "95248880",
  "RequestId": "E5BD4B50-7A02-493A-AE0B-97B9024B4135"
}

エラーコード

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

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

変更履歴

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