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

操作説明

関連操作: 更新/プリフェッチ操作には、コンテンツを更新するための RefreshDcdnObjectCaches と、コンテンツをプリフェッチするための PreloadDcdnObjectCaches があります。
リクエストメソッド: POST。パラメーターはフォームで渡されます。
1 日あたりの URL プリフェッチクォータ: デフォルトでは、アカウントごとに 1 日あたり最大 1,000 件の URL プリフェッチタスクを送信できます。アカウントの 1 日のピーク帯域幅が 200 Mbps を超える場合は、コンソールで、またはチケットを起票してクォータの引き上げをリクエストできます。 Alibaba Cloud はお客様のビジネスニーズを評価し、それに応じてクォータを調整します。
各リクエストで最大 100 件の URL プリフェッチタスクを送信できます。
プリフェッチキュールール: 各アカウントのプリフェッチキューには、最大 100,000 個の URL を保持できます。 DCDN は、送信された順序でプリフェッチタスクを処理します。キュー内の保留中のタスク数が 100,000 に達した場合、DCDN は新しいタスクをキューに入れます。新しいタスクは、キューの先頭にあるタスクが完了した後にのみ送信できます。
単一ユーザーの呼び出し頻度: 15 回/秒。

注意

プリフェッチタスクが送信されて実行されると、DCDN ノードはオリジンサーバーから必要なリソースをすぐにフェッチします。一度に多くのプリフェッチタスクを送信すると、多くの同時ダウンロードタスクが作成されます。これにより、オリジンフェッチの帯域幅とリクエストが急増し、オリジンサーバーの負荷が増加する可能性があります。
プリフェッチタスクの完了に必要な時間は、ファイルサイズによって異なります。通常、5 分から 30 分かかります。平均ファイルサイズが小さいほど、プリフェッチタスクは速く完了します。
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:PreloadDcdnObjectCaches

none

*domain

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ObjectPath	string	必須	プリフェッチするオブジェクトの URL。 URL は高速化ドメイン名/プリフェッチするオブジェクトの形式である必要があります。説明複数の URL は改行 (\n) またはキャリッジリターンと改行 (\r\n) で区切ります。 1 つの URL の最大長は 1,024 文字です。	example.com/examplefile.txt
Area	string	任意	プリフェッチリージョン。有効な値: domestic: 中国本土のみ。 overseas: グローバル (中国本土を除く)。このパラメーターを設定しない場合、デフォルトのプリフェッチリージョンはドメイン名に設定されたアクセラレーションリージョンになります。詳細は次のとおりです: アクセラレーションリージョンが中国本土のみの場合、プリフェッチリージョンは中国本土のみです。アクセラレーションリージョンがグローバルの場合、プリフェッチリージョンはグローバルです。アクセラレーションリージョンがグローバル (中国本土を除く) の場合、プリフェッチリージョンはグローバル (中国本土を除く) です。	domestic
L2Preload	boolean	任意	コンテンツを L2 ノードに直接プリフェッチするかどうかを指定します。有効な値: true: プリフェッチノードレイヤーには L2 ノードを含める必要があります。 false: オリジンフェッチレイヤーノードのみがプリフェッチされます。これがデフォルト値です。オリジンフェッチレイヤーは、L2 ノードまたは L3 ノードで構成できます。	true
WithHeader	string	任意	プリフェッチヘッダーをカスタマイズできます。ヘッダーは JSON 形式で送信します。	{ "Accept-Encoding": [ "gzip" ] }
QueryHashkey	boolean	任意	URL の再書き込みやパラメーターフィルタリングなどのルールを設定している場合は、このパラメーターを有効にします。このパラメーターは、プリフェッチタスクのハッシュキークエリモードを有効にするかどうかを制御します。有効な値: false: デフォルトモード。このパラメーターを設定しない場合、このモードが使用されます。送信された URL は、プリフェッチされたファイルのハッシュキーとして直接使用されます。 true: プリフェッチ URL に使用される実際のハッシュキーは、ドメイン名の構成に基づいてクエリされます。	true

レスポンスフィールド

フィールド	型	説明	例
	object
PreloadTaskId	string	プリフェッチタスクの ID。複数のタスク ID はカンマ (,) で区切られます。返されるプリフェッチタスク ID は、次の 2 つのルールに基づいてマージされます: 同じドメイン名に対して同じ秒内に送信された URL 粒度のプリフェッチタスクは、単一の RushTaskId にマージされます。同じドメイン名に対して同じ秒内に 500 を超える URL 粒度のプリフェッチタスクが送信された場合、タスクは 500 のバッチで RushTaskIds にマージされます。	95248880
RequestId	string	リクエスト ID。	E5BD4B50-7A02-493A-AE0B-97B9024B4135

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	SingleRequest.OverLimit	A maximum of 1000 URLs are supported for each request.
400	QuotaExceeded.Preload	Your refresh attempts have exceeded the daily limit.
400	InvalidObjectPath.Malformed	The specified ObjectPath is invalid.
400	InvalidExtensiveDomain.ValueNotSupported	The specified ExtensiveDomain is not supported.
400	PreloadQueueFull	The warming queue is full; please try again later.
400	InvalidObjectPath.ExceedsMaximum	The maximum number of urls is exceeded.

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

変更履歴

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