查詢快取政策部署錯誤

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊

InvalidTimeout

錯誤訊息

無法透過 Edge UI 或 Edge Management API 部署 API Proxy，並顯示以下錯誤訊息：

Error Saving Revision revision_number
CacheLookupTimeoutInSeconds value value should be greater than zero.

錯誤訊息範例

Error Saving Revision 2
CacheLookupTimeoutInSeconds -1 value should be greater than zero.

錯誤螢幕截圖示例

原因

如果 LookupCache 政策的 <CacheLookupTimeoutInSeconds> 元素設為負數，API Proxy 部署就會失敗。

舉例來說，如果 <CacheLookupTimeoutInSeconds> 元素是 -1，API Proxy 的部署就會失敗。

診斷

  1. 找出 LookupCache 政策中 <CacheLookupTimeoutInSeconds> 元素指定的無效值。您可以在錯誤訊息中找到這項資訊。例如，在下列錯誤中，<CacheLookupTimeoutInSeconds> 元素使用的值為 -1：

    CacheLookupTimeoutInSeconds -1 value should be greater than zero.

  2. 檢查發生錯誤的特定 API Proxy 中的所有 LookupCache 政策。可能有一或多項 LookupCache 政策指定 <CacheLookupTimeoutInSeconds> 元素。找出為 <CacheLookupTimeoutInSeconds> 元素指定無效值 (如上述步驟 1 中識別) 的 LookUpCache 政策。

    舉例來說，以下政策設定指定了 -1 的 <CacheLookupTimeoutInSeconds> 值，而該值會與錯誤訊息相符：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token">
    <DisplayName>LookupCache-Token</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref="request.queryparam.client_id"/>
    </CacheKey>
    <CacheLookupTimeoutInSeconds>-1</CacheLookupTimeoutInSeconds>
    <Scope>Exclusive</Scope>
    <ExpirySettings>
        <TimeoutInSec>3600</TimeoutInSec>
    </ExpirySettings>
    <AssignTo>usertoken</AssignTo>
</LookupCache>

  3. 如果 <CacheLookupTimeoutInSeconds> 指定為負整數，則為發生錯誤的原因。

解析度

確保 LookupCache 政策的 <CacheLookupTimeoutInSeconds> 元素值一律指定為非負整數。

如要修正上方顯示的 LookupCache 政策範例，您可以將 <CacheLookupTimeoutInSeconds> 元素修改為 30。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token">
    <DisplayName>LookupCache-Token</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref="request.queryparam.client_id"/>
    </CacheKey>
    <CacheResource>tokencache</CacheResource>
    <CacheLookupTimeoutInSeconds>30</CacheLookupTimeoutInSeconds>
    <Scope>Exclusive</Scope>
    <ExpirySettings>
        <TimeoutInSec>3600</TimeoutInSec>
    </ExpirySettings>
    <AssignTo>usertoken</AssignTo>
</LookupCache>

InvalidCacheResourceReference

錯誤訊息

無法透過 Edge UI 或 Edge Management 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:ResponseCache;Organization:[organization];Environment:[environment]

錯誤訊息範例

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

錯誤螢幕截圖示例

原因

如果 <CacheResource> 元素設定的名稱不在部署 API Proxy 的環境中，就會發生這個錯誤。

診斷

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

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

  2. 檢查發生錯誤的特定 API Proxy 中的所有 LookupCache 政策。找出在 <CacheResource> 元素中指定無效快取 (已在步驟 #1 中找出) 的特定 LookupCache 政策。

    舉例來說，下列政策會將 <CacheResource> 的值指定為 tokencache，以便與錯誤訊息相符：

    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<LookupCache async="false" continueOnError="false" enabled="true" name="LookupCache-Token">
    <DisplayName>LookupCache-Token</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref="request.queryparam.client_id"/>
    </CacheKey>
    <CacheResource>tokencache</CacheResource>
    <CacheLookupTimeoutInSeconds/>
    <Scope>Exclusive</Scope>
    <ExpirySettings>
        <TimeoutInSec>3600</TimeoutInSec>
    </ExpirySettings>
    <AssignTo>usertoken</AssignTo>
</LookupCache>

  3. 確認已在特定環境中定義快取 (於步驟 1 定義)。

    在 Edge UI 中依序前往「管理」>「環境」>「測試」，然後檢查「環境設定」的「快取」分頁是否有快取存在。如果快取不存在，則可能是錯誤原因。

    例如，請注意在下方螢幕截圖中，名為 tokencache 的快取不存在。

    由於 test 環境中並未定義名為 tokencache 的快取，因此您會收到錯誤訊息：

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

解析度

確保已在您要部署 API Proxy 的環境中建立 <CacheResource> 元素中指定的快取名稱。

如要瞭解如何建立快取，請參閱「建立及編輯環境快取」一文。

CacheNotFound

錯誤訊息

如果透過 Edge UI 或 Edge Management 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

原因

如果尚未在特定的訊息處理器元件上建立錯誤訊息中提及的特定快取，就會發生這個錯誤。

解析度

如果您是 Private Cloud 的使用者，請按照以下說明操作：

  1. 列出 API Proxy 部署作業，並判斷哪些訊息處理器含有 steps.cache.CacheNotFound 錯誤。

    curl -u $USERID:$USERPASSWORD http://:8080/v1/organizations//environments//apis//revisions//deployments

    輸出內容範例

    {
  "aPIProxy" : "TestCache",
  "environment" : [ {
    "configuration" : {
      "basePath" : "/",
      "configVersion" : "SHA-512:45d3f39783414d3859bf2dec4135d8f5f9960ee6b2d361db2799c82693a8e3f8b95dbbb37c547eb3c0a3819d8ca51727f390502bcaefdf1f113263521a9023b6",
      "steps" : [ ]
    },
    "name" : "prod",
    "server" : [ {
      "pod" : {
        "name" : "pod1",
        "region" : "us-central1"
      },
      "status" : "deployed",
      "type" : [ "message-processor" ],
      "uUID" : "f2e5e34a-5630-43a9-8fef-48a5b9da76d1"
    }, {
      "pod" : {
        "name" : "pod1",
        "region" : "us-central1"
      },
      "status" : "deployed",
      "type" : [ "message-processor" ],
      "uUID" : "879a6538-a5e0-4503-b142-9cb2b4e0623d"
    }, {
    "error" : "Cache : configCache, not found in organization : kkalckstein-eval__test",
    "errorCode" : "steps.cache.CacheNotFound",
    "status" : "error",
    "type" : [ "message-processor" ],
     "uUID" : "a8f9ce0b-c32d-48a9-b26c-9c75d8bf467d"
},
...
    "state" : "deployed"
  } ],
  "name" : "2",
  "organization" : "kkalckstein-eval"
  ...

  2. 請注意出現 steps.cache.CacheNotFound 錯誤的訊息處理器的 UUID。找出與 UUID 相關聯的郵件處理器主機名稱/IP 位址。

  3. 登入特定的訊息處理器，並使用下列指令來重新啟動：

    apigee-service edge-message-processor restart

如果您是公用雲端使用者，或私有雲的問題持續發生，請向 Apigee 支援團隊尋求協助。