すべてのプロダクト
Search
ドキュメントセンター

Edge Security Acceleration:UpdateCacheRule

最終更新日:Apr 23, 2026

キャッシュ設定を変更します。

今すぐお試しください

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

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

esa:UpdateCacheRule

update

*Site

acs:esa:{#regionId}:{#accountId}:site/{#SiteId}

なし なし

リクエストパラメーター

パラメーター

必須 / 任意

説明

SiteId

integer

必須

サイトの ID。この ID を取得するには、ListSites 操作を呼び出します。

123456****

ConfigId

integer

必須

設定 ID。

35281609698****

RuleName

string

任意

ルールの名前。このパラメーターは、グローバル設定ではオプションです。

rule_example

RuleEnable

string

任意

ルールを有効にするかどうかを制御します。このパラメーターは、グローバル設定ではオプションです。有効な値:

  • on:ルールを有効にします。

  • off:ルールを無効にします。

on

Rule

string

任意

ユーザーリクエストに一致する条件式。このパラメーターは、グローバル設定ではオプションです。2 つのシナリオがサポートされています:

  • すべての受信リクエストに一致させるには、値を true に設定します。

  • 特定のリクエストに一致させるには、値をカスタム式 (例:(http.host eq "video.example.com")) に設定します。

(http.host eq \"video.example.com\")

BypassCache

string

任意

キャッシュバイパスモード。有効な値:

  • cache_all:すべてのリクエストをキャッシュします。

  • bypass_all:すべてのリクエストでキャッシュをバイパスします。

cache_all

BrowserCacheMode

string

任意

ブラウザキャッシュモード。有効な値:

  • no_cache:ブラウザにコンテンツをキャッシュしません。

  • follow_origin:オリジンサーバーのキャッシュポリシーに従います。

  • override_origin:オリジンサーバーのキャッシュポリシーを上書きします。

no_cache

BrowserCacheTtl

string

任意

ブラウザキャッシュの TTL (Time to Live)。単位は秒です。

300

EdgeCacheMode

string

任意

エッジノードのキャッシュモード。有効な値:

  • follow_origin:オリジンサーバーのキャッシュポリシーに従います。オリジンサーバーにポリシーがない場合は、デフォルトのポリシーが使用されます。

  • no_cache:コンテンツをキャッシュしません。

  • override_origin:オリジンサーバーのキャッシュポリシーを上書きします。

  • follow_origin_bypass:オリジンサーバーのキャッシュポリシーが存在する場合はそれに従います。存在しない場合は、コンテンツはキャッシュされません。

  • follow_origin_override:オリジンサーバーのキャッシュポリシーが存在する場合はそれに従います。存在しない場合は、カスタムキャッシュ TTL が使用されます。

follow_origin

EdgeCacheTtl

string

任意

エッジノードキャッシュの TTL (Time to Live)。単位は秒です。

300

EdgeStatusCodeCacheTtl

string

任意

特定のステータスコードのキャッシュ TTL。単位は秒です。

  • 特定のステータスコードのキャッシュ TTL を設定できます。例えば、404=10 は、ステータスコード 404 のレスポンスを 10 秒間キャッシュします。

  • 4xx および 5xx のステータスコード範囲のキャッシュ TTL を設定できます。例えば、4xx=10 は、4xx ステータスコードのすべてのレスポンスを 10 秒間キャッシュします。

  • 複数のステータスコード設定はカンマで区切ります。

5xx=0,404=10

SortQueryStringForCache

string

任意

キャッシュキーを生成する際にクエリ文字列パラメーターをソートするかどうかを制御します。有効な値:

  • on:ソートを有効にします。

  • off:ソートを無効にします。

on

QueryStringMode

string

任意

キャッシュキーを生成するためにクエリ文字列をどのように使用するかを制御します。有効な値:

  • ignore_all:すべてのクエリ文字列を無視します。

  • exclude_query_string:指定されたクエリ文字列を削除します。

  • reserve_all:すべてのクエリ文字列を保持します。これはデフォルト値です。

  • include_query_string:指定されたクエリ文字列のみを保持します。

ignore_all

QueryString

string

任意

キャッシュキーに含める、またはキャッシュキーから除外するクエリ文字列パラメーター。複数のパラメーターはスペースで区切ります。

example1 example2

IncludeHeader

string

任意

キャッシュキーに含めるヘッダー。ヘッダー名 (大文字と小文字を区別しない) とその値の両方が使用されます。複数のヘッダーはスペースで区切ります。ヘッダー名には次の文字を含めることができます:

  • 記号:! # $ % & ' * + - . ^ _ | ~

  • 数字:0-9

  • 小文字:a-z

headername1 headername2

IncludeCookie

string

任意

キャッシュキーに含める Cookie。Cookie 名 (大文字と小文字を区別しない) とその値の両方が使用されます。複数の Cookie はスペースで区切ります。Cookie 名には次の文字を含めることができます:

  • 記号:! # $ % & ' * + - . ^ _ | ~

  • 数字:0-9

  • 小文字:a-z

cookiename1 cookiename2

CacheReserveEligibility

string

任意

オリジンフェッチ中にリクエストがキャッシュリザーブノードをバイパスするかどうかを制御します。有効な値:

  • bypass_cache_reserve:リクエストはキャッシュリザーブをバイパスします。

  • eligible_for_cache_reserve:リクエストはキャッシュリザーブの対象となります。

bypass_cache_reserve

CheckPresenceHeader

string

任意

チェックするヘッダー。指定されたヘッダーがリクエストに存在する場合、その名前 (大文字と小文字を区別しない) がキャッシュキーに追加されます。複数のヘッダーはスペースで区切ります。ヘッダー名には次の文字を含めることができます:

  • 記号:! # $ % & ' * + - . ^ _ | ~

  • 数字:0-9

  • 小文字:a-z

headername1 headername2

CheckPresenceCookie

string

任意

チェックする Cookie。指定された Cookie がリクエストに存在する場合、その名前 (大文字と小文字を区別しない) がキャッシュキーに追加されます。複数の Cookie はスペースで区切ります。Cookie 名には次の文字を含めることができます:

  • 記号:! # $ % & ' * + - . ^ _ | ~

  • 数字:0-9

  • 小文字:a-z

cookiename1 cookiename2

UserDeviceType

string

任意

キャッシュキーにクライアントデバイスタイプを含めるかどうかを制御します。有効な値:

  • on:この機能を有効にします。

  • off:この機能を無効にします。

on

UserGeo

string

任意

キャッシュキーにクライアントの地理的位置を含めるかどうかを制御します。有効な値:

  • on:この機能を有効にします。

  • off:この機能を無効にします。

on

UserLanguage

string

任意

キャッシュキーにクライアントの言語を含めるかどうかを制御します。有効な値:

  • on:この機能を有効にします。

  • off:この機能を無効にします。

on

ServeStale

string

任意

古いコンテンツを提供するかどうかを制御します。有効にすると、オリジンサーバーが利用できない場合に、エッジノードはキャッシュから期限切れのコンテンツを提供できます。有効な値:

  • on:この機能を有効にします。

  • off:この機能を無効にします。

on

AdditionalCacheablePorts

string

任意

  • 指定されたポートでキャッシュを有効にします。

  • 有効な値:888020522082208620952053208320872096

  • 複数のポートはカンマで区切ります。

8880,2052,2086

CacheDeceptionArmor

string

任意

検証済みのコンテンツのみをキャッシュすることで、Web キャッシュデセプション攻撃から保護します。有効な値:

  • on:この機能を有効にします。

  • off:この機能を無効にします。

on

Sequence

integer

任意

ルールの実行優先度。値が小さいほど優先度が高くなります。

1

PostCache

string

任意

POST リクエストへのレスポンスをキャッシュするかどうかを制御します。

on

PostBodySizeLimit

string

任意

POST キャッシュのリクエストボディの最大サイズ (KB)。値は 1 から 8 までの整数である必要があります。このパラメーターを空のままにすると、デフォルト値の 8 KB が使用されます。

1

PostBodyCacheKey

string

任意

POST リクエストのキャッシュキーを生成するためにリクエストボディをどのように使用するかを制御します。有効な値:

  • md5:リクエストボディの MD5 ハッシュを計算し、そのハッシュをキャッシュキーに含めます。

  • ignore:キャッシュキーを生成する際にリクエストボディを無視します。

ignore

レスポンスフィールド

フィールド

説明

object

レスポンスデータ。

RequestId

string

リクエスト ID。

36af3fcc-43d0-441c-86b1-428951dc8225

成功レスポンス

JSONJSON

{
  "RequestId": "36af3fcc-43d0-441c-86b1-428951dc8225"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 CanNotSetSequence Non-regular configuration, you cannot set Sequence parameters.
400 CacheReserveSiteExceedLimit The number of binding sites of the cache reserve instance exceeds the limit. The number of binding sites of a single cache reserve instance is limited. Please see the document for the limit.
400 CompileRuleError Rule compilation failed, please check the rule information passed in to ensure that the rule is written according to the syntax described in the document.
400 SiteConfigLengthExceedLimit The overall configuration size of the site exceeds the limit, and the total size of all functional configurations of the site cannot exceed 512K.
400 ConfigConflicts Configuration conflicts, usually when multiple configurations are configured under the same function of the same site, such as duplicate rule names between multiple configurations.
400 RuleRegexQuotaCheckFailed When configuring rules, rules with regular expressions are not allowed in this plan. Please check the relevant documentation of the plan or upgrade the plan.
400 NestedRuleQuotaCheckFailed The nesting level of rules allowed by the plan failed to be verified. Please modify the nesting level of rules or upgrade the plan.
400 ServiceInvokeFailed The call to the internal service failed. The engineer is resolving the problem. Please wait a moment before trying, or contact customer service for details.
400 FunctionConflict The feature configuration conflicts. Sites with version management enabled cannot configure this feature.
400 SpecifiedVersionReadOnly The specified version number is read-only and cannot be modified.
400 VersionNotValid The site does not have version management enabled, or the version number passed in does not exist.
400 InternalException Failed to call the service. Try again later or contact technical support.
400 InvalidParameter.ArgName Invalid ArgName. Check your website configuration parameters and make sure that they match the supported features and parameter names listed in the official documentation.
400 InvalidParameter.ArgValue Invalid parameter value. Check whether the value format and length meet the requirements.
400 InvalidParameter.Configs Invalid parameter configurations. Check whether your feature configurations are in the valid format and comply with relevant requirements.
400 InstanceNotExist The instance does not exist. Check whether the specified instance ID is correct or whether the instance belongs to your account.
400 LockFailed The system is handling requests you previously submitted. Try again later.
400 IllegalOperation.VersionManagement The version management operation failed because incompatible features or environment settings are configured. Adjust your configurations and try again.
400 QuotaCheckFailed.VersionManagement Insufficient quota for version management. Contact technical support.
400 InvalidConfigId The input configuration ID: ConfigId it does not exist, query the existing configuration and its valid ConfigId through the ListSiteFunction.
400 Instance.NotOnline Your plan is unavailable due to an overdue payment. Complete the payment first.
400 FunctionQuotaCheckFailed The quota verification for this function fails. It may be that the configuration of this function exceeds the limit of the site plan. Please check the plan introduction document corresponding to this site.
400 QuotaCheckFailed.FunctionArg The specified feature parameter is not allowed in your plan, or the feature parameter configurations have reached the upper limit in your plan.
400 MissingParameter The specified ArgName is required for this function.
400 FunctionArgError Failed to check the configured function parameters.
404 SiteNotFound The website does not exist or does not belong to you.

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

変更履歴

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