RefreshDcdnObjectCaches - Edge Security Acceleration - Alibaba Cloud ドキュメントセンター

操作説明

リクエストメソッド: POST。パラメーターはフォームで渡されます。
関連操作: 更新/プリフェッチ機能には、コンテンツを更新するための RefreshDcdnObjectCaches 操作と、コンテンツをプリフェッチするための PreloadDcdnObjectCaches 操作が含まれます。
1 日あたりの更新クォータ: デフォルトでは、各 Alibaba Cloud アカウントは 1 日あたり最大 10,000 件の URL 更新と 100 件のディレクトリ更新を送信できます。ディレクトリ更新には、そのすべてのサブディレクトリが含まれます。Alibaba Cloud アカウントの 1 日のピーク帯域幅が 200 Mbps を超える場合、を通じて、またはチケットを起票することでクォータの増加をリクエストできます。Alibaba Cloud はお客様のリクエストをレビューし、ビジネスニーズに基づいてクォータを調整します。
各リクエストには、更新対象の URL を最大 1,000 件、またはディレクトリを最大 100 件含めることができます。
単一のドメイン名に対して、1 分あたり最大 10,000 件の URL の更新リクエストを送信できます。
単一ユーザーの呼び出し頻度は、毎秒 30 回に制限されています。

注意事項

更新タスクを送信すると、DCDN ノード上の対応するキャッシュされたリソースは無効としてマークされます。ユーザーが再度コンテンツをリクエストすると、DCDN ノードはオリジンサーバーから最新バージョンを取得してキャッシュします。一度に多くの更新タスクを送信すると、大量のキャッシュされたコンテンツがクリアされます。これにより、back-to-origin の帯域幅使用量とリクエストが急増し、オリジンサーバーの負荷が増加する可能性があります。
更新タスクが有効になるまで約 5〜6 分かかります。ファイルまたはディレクトリに設定された生存時間 (TTL) が 5 分未満の場合、更新する必要はありません。代わりに、キャッシュの有効期限が切れるのを待ちます。
RAM ユーザーを使用して更新またはプリフェッチ操作を実行する場合、まず 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 またはディレクトリを送信するには、改行 (\n) またはキャリッジリターンと改行 (\r\n) で区切ります。単一のリクエストに含まれる一意のドメイン名の総数は 10 を超えることはできません。	example.com/example.txt
ObjectType	string	任意	更新のタイプ。有効な値: File (デフォルト): URL でコンテンツを更新します。 Directory: ディレクトリ内のコンテンツを更新します。 Regex: 正規表現に一致するコンテンツを更新します。 IgnoreParams: URL パラメーターを無視してコンテンツを更新します。この更新タイプは、URL から疑問符 (?) とそれに続くすべてのパラメーターを削除します。更新のために送信した URL (パラメーターなし) は、キャッシュされたリソースの URL (こちらもパラメーターなし) と照合されます。一致が見つかった場合、DCDN ノードはキャッシュされたリソースを更新します。説明詳細については、「リソースの更新とプリフェッチ」をご参照ください。ファイルの更新は、ノードからリソースを直接削除します。新しいリクエストが到着すると、ノードはオリジンサーバーから新しいリソースをフェッチします。他の更新タイプは、デフォルトで変更されたリソースのみを更新します。これらのタイプで強制的に更新するには、Force パラメーターを true に設定します。詳細については、Force パラメーターの説明をご参照ください。	File
Force	boolean	任意	オリジンサーバーのコンテンツがキャッシュされたコンテンツと同じであっても、指定された範囲内のリソースを更新するかどうかを指定します。デフォルト値は false です。 true: 指定された範囲内のすべてのリソースを更新します。ユーザーリクエストが範囲内のリソースと一致する場合、DCDN ノードはオリジンサーバーから新しいリソースを直接フェッチし、ユーザーに返して、新しいリソースをキャッシュします。 false: 指定された範囲内の変更されたリソースのみを更新します。ユーザーリクエストが範囲内のリソースと一致する場合、DCDN ノードはオリジンサーバーから Last-Modified 情報を取得します。Last-Modified の値がキャッシュされたリソースの値と同じ場合、ノードはキャッシュされたリソースを返します。値が異なる場合、ノードはオリジンサーバーから新しいリソースをフェッチし、ユーザーに返して、新しいリソースをキャッシュします。説明このパラメーターは、ファイルの更新を除くすべての更新タイプで有効です。	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

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

変更履歴

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