填入快取政策部署錯誤的問題

您目前查看的是 ApigeeApigee Hybrid 說明文件。
查看 Apigee Edge 說明文件。

InvalidCacheResourceReference

錯誤訊息

透過 Apigee 使用者介面或 API 部署 API Proxy 時失敗,並顯示以下錯誤訊息:

Error Deploying Revision revision_number to environment
Invalid cache resource reference [cache_resource] in Step definition [populate_cache_policy_name]. Context Revision:[revision_number];APIProxy:[apiproxy_name];Organization:[organization];Environment:[environment]

錯誤訊息範例

Error Deploying Revision 2 to test
Invalid cache resource reference tokencache in Step definition PopulateCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test

錯誤螢幕截圖範例

將修訂版本 2 部署至測試時發生錯誤。

原因

如果 PopulateCache 政策中的 <CacheResource> 元素設為 API Proxy 部署環境中不存在的名稱,就會發生這個錯誤。

診斷

  1. 找出 PopulateCache 政策名稱、政策 <CacheResource> 元素中使用的無效快取,以及發生錯誤的環境。您可以在錯誤訊息中找到所有這些項目。舉例來說,在下列錯誤中,PopulateCache 政策名稱為 PopulateCache-Token,無效快取的名稱為 tokencache,環境名稱為 test

    Invalid cache resource reference tokencache in Step definition PopulateCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test
    
  2. 檢查失敗的 PopulateCache 政策 XML,並確認為 <CacheResource> 元素指定的快取名稱是否與錯誤訊息相符。

    在本範例中,<CacheResource> 元素中指定的快取名稱為 tokencache

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <PopulateCache async="false" continueOnError="false" enabled="true" name="PopulateCache-Token">
        <DisplayName>PopulateCache-Token</DisplayName>
        <Properties/>
        <CacheKey>
            <Prefix/>
            <KeyFragment ref="request.queryparam.client_id"/>
        </CacheKey>
        <CacheResource>tokencache</CacheResource>
        <Scope>Exclusive</Scope>
        <ExpirySettings>
            <TimeoutInSec>3600</TimeoutInSec>
        </ExpirySettings>
        <Source>token</Source>
    </PopulateCache>
    
  3. 確認特定環境 (步驟 1 中識別) 中是否已定義快取 (步驟 1 中判斷)。

    在 Apigee UI 中,依序前往「ADMIN」>「Environment」>「test」,然後檢查「Environment Configuration」的「Caches」分頁中是否有快取。如果快取不存在,就是造成錯誤的原因。

    舉例來說,請注意下方螢幕截圖中,名為 tokencache 的快取不存在。

    「環境設定」的「快取」分頁。

    由於 test 環境中未定義名為 tokencache 的快取,因此您會收到以下錯誤訊息:

    Invalid cache resource reference tokencache in Step definition PopulateCache-Token. Context Revision:2;APIProxy:TestCache;Organization:kkalckstein-eval;Environment:test
    

解析度

確認您已在要部署 API Proxy 的環境中,建立 PopulateCache 政策 <CacheResource> 元素指定的快取。

CacheNotFound

錯誤訊息

透過 Apigee UI 或 API 部署 API Proxy 時,會產生類似以下的錯誤訊息,且 API Proxy 的部署狀態會標示為部分部署:

Error: Cache : cache_resource, not found in organization : organization__environment.

錯誤訊息範例

Error Cache : configCache, not found in organization : kkalckstein-eval__test

原因

如果錯誤訊息中提及的特定快取未在特定 Message Processor 元件上建立,就會發生這個錯誤。訊息處理器是 Apigee 內部元件,負責處理透過 Apigee 的 API 流量流程。

解析度

如需協助,請與 Apigee 支援團隊聯絡。