キャッシュ設定を変更します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
esa:UpdateCacheRule |
update |
*Site
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| SiteId |
integer |
必須 |
サイトの ID。この ID を取得するには、ListSites 操作を呼び出します。 |
123456**** |
| ConfigId |
integer |
必須 |
設定 ID。 |
35281609698**** |
| RuleName |
string |
任意 |
ルールの名前。このパラメーターは、グローバル設定ではオプションです。 |
rule_example |
| RuleEnable |
string |
任意 |
ルールを有効にするかどうかを制御します。このパラメーターは、グローバル設定ではオプションです。有効な値:
|
on |
| Rule |
string |
任意 |
ユーザーリクエストに一致する条件式。このパラメーターは、グローバル設定ではオプションです。2 つのシナリオがサポートされています:
|
(http.host eq \"video.example.com\") |
| BypassCache |
string |
任意 |
キャッシュバイパスモード。有効な値:
|
cache_all |
| BrowserCacheMode |
string |
任意 |
ブラウザキャッシュモード。有効な値:
|
no_cache |
| BrowserCacheTtl |
string |
任意 |
ブラウザキャッシュの TTL (Time to Live)。単位は秒です。 |
300 |
| EdgeCacheMode |
string |
任意 |
エッジノードのキャッシュモード。有効な値:
|
follow_origin |
| EdgeCacheTtl |
string |
任意 |
エッジノードキャッシュの TTL (Time to Live)。単位は秒です。 |
300 |
| EdgeStatusCodeCacheTtl |
string |
任意 |
特定のステータスコードのキャッシュ TTL。単位は秒です。
|
5xx=0,404=10 |
| SortQueryStringForCache |
string |
任意 |
キャッシュキーを生成する際にクエリ文字列パラメーターをソートするかどうかを制御します。有効な値:
|
on |
| QueryStringMode |
string |
任意 |
キャッシュキーを生成するためにクエリ文字列をどのように使用するかを制御します。有効な値:
|
ignore_all |
| QueryString |
string |
任意 |
キャッシュキーに含める、またはキャッシュキーから除外するクエリ文字列パラメーター。複数のパラメーターはスペースで区切ります。 |
example1 example2 |
| IncludeHeader |
string |
任意 |
キャッシュキーに含めるヘッダー。ヘッダー名 (大文字と小文字を区別しない) とその値の両方が使用されます。複数のヘッダーはスペースで区切ります。ヘッダー名には次の文字を含めることができます:
|
headername1 headername2 |
| IncludeCookie |
string |
任意 |
キャッシュキーに含める Cookie。Cookie 名 (大文字と小文字を区別しない) とその値の両方が使用されます。複数の Cookie はスペースで区切ります。Cookie 名には次の文字を含めることができます:
|
cookiename1 cookiename2 |
| CacheReserveEligibility |
string |
任意 |
オリジンフェッチ中にリクエストがキャッシュリザーブノードをバイパスするかどうかを制御します。有効な値:
|
bypass_cache_reserve |
| CheckPresenceHeader |
string |
任意 |
チェックするヘッダー。指定されたヘッダーがリクエストに存在する場合、その名前 (大文字と小文字を区別しない) がキャッシュキーに追加されます。複数のヘッダーはスペースで区切ります。ヘッダー名には次の文字を含めることができます:
|
headername1 headername2 |
| CheckPresenceCookie |
string |
任意 |
チェックする Cookie。指定された Cookie がリクエストに存在する場合、その名前 (大文字と小文字を区別しない) がキャッシュキーに追加されます。複数の Cookie はスペースで区切ります。Cookie 名には次の文字を含めることができます:
|
cookiename1 cookiename2 |
| UserDeviceType |
string |
任意 |
キャッシュキーにクライアントデバイスタイプを含めるかどうかを制御します。有効な値:
|
on |
| UserGeo |
string |
任意 |
キャッシュキーにクライアントの地理的位置を含めるかどうかを制御します。有効な値:
|
on |
| UserLanguage |
string |
任意 |
キャッシュキーにクライアントの言語を含めるかどうかを制御します。有効な値:
|
on |
| ServeStale |
string |
任意 |
古いコンテンツを提供するかどうかを制御します。有効にすると、オリジンサーバーが利用できない場合に、エッジノードはキャッシュから期限切れのコンテンツを提供できます。有効な値:
|
on |
| AdditionalCacheablePorts |
string |
任意 |
|
8880,2052,2086 |
| CacheDeceptionArmor |
string |
任意 |
検証済みのコンテンツのみをキャッシュすることで、Web キャッシュデセプション攻撃から保護します。有効な値:
|
on |
| Sequence |
integer |
任意 |
ルールの実行優先度。値が小さいほど優先度が高くなります。 |
1 |
| PostCache |
string |
任意 |
POST リクエストへのレスポンスをキャッシュするかどうかを制御します。 |
on |
| PostBodySizeLimit |
string |
任意 |
POST キャッシュのリクエストボディの最大サイズ (KB)。値は 1 から 8 までの整数である必要があります。このパラメーターを空のままにすると、デフォルト値の 8 KB が使用されます。 |
1 |
| PostBodyCacheKey |
string |
任意 |
POST リクエストのキャッシュキーを生成するためにリクエストボディをどのように使用するかを制御します。有効な値:
|
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. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。